Does anyone recall how to include links in the C docs? DocBook wants <ulink url="..."> but including this verbatim in the doc comments does not work. I am looking to add a link on a piece of text (e.g. a paper’s title) instead of just including the URL verbatim.
I looked at c-docbook.re. It seems that currently there is no way to do this because all http and https links are detected, regardless of context, and wrapped in an ulink. Even if we type an explicit ulink, the value of its url attribute would get (incorrectly) processed.
I think it’s a waste of time to try to fix this now. It’ll be fixed when the entire doc generation system is overhauled.