Avoiding autolinking words preceded by '%'

[gennaroprota]

Avoiding autolinking words preceded by '%'

[erez-o]

I don't see in doxygen's documentation regarding autolink a % .

Currently, this doxygen flag is always enabled when running docsforge.

On top of that, Docsforge has a more greedy auto-linking implementation that can be disabled all together with autolink:false, or it can be limited by excluding a list of words using autolink_exclude

I strongly suggest enabling autolink:true and using autolink_exclude to tweak it, and if it's needed, I'll add autolink_exclude_pattern and autolink_include_pattern that will let users exclude/include any regex pattern.

autolink:false would also disable any links in markdown pages, mentioned in, or source browsing, so I really don't recommend it.

I do maintain a list of common english words excluded by default for all packages. For example, if you have a function named do, not every do found will be autolinked, but only if followed by something that resembles a C/C++ method - do(...) or do<...>

[gennaroprota]

The relevant documentation is here. It says:

If you want to prevent that a word that corresponds to a documented class is replaced by a link you should put a % in front of the word.

Yes, I currently have autolink: true and autolink_exclude (with just one word in it, for now).

About do, that's a keyword in C++ (and in several other languages I know of), so I can't have a function with that name :-)

[erez-o]

Yeah, forgot that do is a bad example :) the list of excluded common words has around 60,000 words so any other example word would do.

Thanks for finding the relevant documentation, I didn't know about it.
I don't plan on supporting it when autolink:true.

Maybe it's a personal preference, but I don't think it's a good approach to add % in your code as a way of solving it because 99% of programmers reading the code (and not the html) won't understand what it means.