On 10/25/2018 01:31 AM, Andreas Schwab wrote:
On Okt 24 2018, Martin Sebor <mse...@gmail.com> wrote:

Is there a way to include a reference to a specific option
from within a .info file rather than to the section/node
the option is defined in?

You can add an @anchor.

Thanks.  After adding the @anchor I can use it in commands like
@ref.  It even understands the @ref command when it's nested in
the @option command, like this:

  the @option{@ref{-fno-delete-null-pointer-checks}} option

and renders it as expected in HTML:

the <samp><a href="Optimize-Options.html#g_t_002dfno_002ddelete_002dnull_002dpointer_002dchecks">-fno-delete-null-pointer-checks</a></samp> option

Unfortunately, it doesn't look right in PDF where it produces

  the [-fno-delete-null-pointer-checks], page 127 option

the text between "the" and "option" is a link.

I was also hoping not to have to add @anchor (since some sort
of anchors must already exist for the Index to work), and for
a way to simply turn the name of an option (or attribute) into
a link to the the existing anchor for the option.  But I suspect
that might be too much to expect.

I could deal with the rendering issue by using references in
a way that makes sense either way, but what about avoiding
@anchor?  Is that at all possible?

Martin

Reply via email to