OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Multiple named references to a single <refentry> page?

The GL man pages I maintain have a number of pages that describe several
closely-related commands, e.g. https://www.opengl.org/sdk/docs/man/html/glEnable.xhtml
which describes the commands glEnable, glDisable, glEnablei, and glDisablei. We'd like
to be able to refer to this page by any of these names from other pages, e.g.

"The commands <citerefentry><refentrytitle>glEnable</refentrytitle></citerefentry>
and <citerefentry><refentrytitle>glDisable</refentrytitle></citerefentry> may be
used to enable and disable blending."

However, a page has only one <refentrytitle> and <citerefentry> doesn't know anything
about the others, so doing this just results in a bogus link to glDisable.xhtml
in the generated output (see https://www.opengl.org/sdk/docs/man/html/glBlendFunc.xhtml).

Is there an alternate way to refer to the same <refentry> by multiple names, e.g.
by the multiple <refname> tags which are allowed?


    Jon Leech

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]