Date: Thu, 19 Aug 1999 01:05:30 +0100 From: Nik Clayton <nik@freebsd.org> To: Jesus Rodriguez <jesusr@ncsa.es> Cc: Nik Clayton <nik@FreeBSD.ORG>, doc@FreeBSD.ORG Subject: Re: DocBook FAQ available for critique Message-ID: <19990819010530.E83680@catkin.nothing-going-on.org> In-Reply-To: <XFMail.990818150017.jesusr@ncsa.es>; from Jesus Rodriguez on Wed, Aug 18, 1999 at 03:00:17PM %2B0200 References: <19990817231204.B89707@catkin.nothing-going-on.org> <XFMail.990818150017.jesusr@ncsa.es>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, Aug 18, 1999 at 03:00:17PM +0200, Jesus Rodriguez wrote:
> On 17-Aug-99 Nik Clayton wrote:
> > The formatting is not final, and there are a number of issues to thrash
> > out (for example, "What is the purpose of this FAQ?" is listed as a numbered
> > question). But this is the beginning of the end. . . for LinuxDoc![1]
>
> Curiosity:
<snip>
> What's the difference between <link linkend="xxx"> and <xref linkend="xxx"> ?
<chapter id="foo">
<title>The Foo Chapter</title>
<para>...</para>
</chapter>
<chapter>
<title>The Bar Chapter</title>
<para>...</para>
<para>For more information, see <xref linkend="foo">.</para>
</chapter>
In that context, the final paragraph is converted to
For more information, see _the chapter called The Foo Chapter_.
If that last <para> had been written
<para><link linkend="foo">More information about foo</link> is
available.</para>
then it would be converted to
_More information about foo_ is available.
Basically, with <xref> the stylesheet tries to work out what the content
of the link should be, with <link> you explicitly state it.
Of course, <xref> only works if you are xref'ing to elements that have
a title. Most of the <xref>s in the FAQ are to elements that don't have
a title (the translation spec is broken in this respect) which is why you
get the error.
N
--
[intentional self-reference] can be easily accommodated using a blessed,
non-self-referential dummy head-node whose own object destructor severs
the links.
-- Tom Christiansen in <375143b5@cs.colorado.edu>
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990819010530.E83680>