There are several doxygen commands whose purpose is to create links in the documentation (@link, @ref).
I am currently using the @ref command to create a link to a custom file, written in a language not supported by doxygen (xml).
I would like to alter this link so that it points to a precise line in the file.
Is there a doxygen command that allows to do that ?
I'm not sure that \ref
or \link
can do this. However, if they could, one problem of adopting this approach is that the links will become invalid if you change the contents of the file you are linking to without changing the link. This is one of the problems of separating source code and documentation.
Rather than linking to a particular line in another file why don't you include the particular part of the file you are interested in in the documentation? You could either:
\include
(there is also \includelineno
) and just reference relevant parts of it in the text (e.g. "function xxx in the code below"), or\snippet
.Edit: Alternatively, you could use the \dontinclude
command which, together with the \line
, \skip
, \skipline
, and \until
commands allows you to include specific lines/blocks of a particular file. See the example in the \dontinclude
documentation.