Re: [docbook-apps] Multiple named references to a single <refentry> page?

[Bob Stayton <bobs@sagehill.net>]

Hi,
One suggestion is to put xml:id attributes on the multiple refname 
elements, and use xref to refer to each of them.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

On 7/24/2014 1:27 AM, Jon Leech wrote:
> 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?
>
>      Thanks,
>
>      Jon Leech
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org