TracLinks in doxygen-comments?

[eckert@…]

It would be very nice, if TracLinks from the doxygen-output is parsed. eg:

/**
  * This is a simple function. ([wiki:function/simplefunction details])
  * 
  * @param string input
  * @return string output
  * .........
  */

[Ryan J Ollos]

I'm not sure there is a simple way to handle this. There's a function in trac.wiki.formatter for formatting a link,

>> print(extract_link(env, context, '#100'))
<a class="missing ticket">#100</a>

However, you'll need to parse the text to be formatted from the Doxygen markup, for which you might need to write some regular expression. You probably want to look at ​formatter.py and ​parser.py.

[Committo-Ergo-Sum]

Thanks for your suggestion. r15413 implements a minimal version of #1882 with some restrictions, see the log message. May be it is possible to avoid them, but presently it seems costly.

[Ryan J Ollos]

It would be good if you ran a ​PEP8 style checker. There are a number of minor issues in the codebase. I'll fix some of them if I find time.

[Ryan J Ollos]

In 15427:

0.7.2: Pass arguments to logger rather than interpolating string

This change conforms to PEP8.

Refs #1882.