A couple of DocBook style questions

Matthew East mdke at ubuntu.com
Mon Feb 13 14:44:13 UTC 2006


On Mon, 2006-02-13 at 08:35 -0600, Venkat Raghavan wrote:
> <snip>
> > We'd like to do this:
> >
> > [quote]
> > * Install <application>Bluefish</application> from the Multiverse
> > repository (see <xref linkend="add-applications"/>).
> > [/quote]
> >
> I think it's a better idea to do this:
> [quote]
> * Install <application>Bluefish</application> from the <clickable with link to 
> add-applications> Multiverse </clickable> repository.
> [/quote]
> 
> I am not very sure if we can have multiple xref's to the same target. 

The problem is that the add-applications section doesn't immediately
deal with repositories. It first deals with installation, and then deals
with repositories. So, having the "see <xref>" bit in brackets at the
end of the sentence is more accurate I think, because it is clearer that
the linked section gives the user information about both how to install
things, and how to add repositories. If I knew how to link to the
repository sub-section, I would say that we should do that, but, as far
as I can see, we can only link to the nearest whole section.

Matt
-- 
mdke at ubuntu.com
gnupg pub 1024D/0E6B06FF
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20060213/71d51ac0/attachment.pgp>


More information about the ubuntu-doc mailing list