[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Different base URL for @xref?

From: Alfred M. Szmidt
Subject: Re: Different base URL for @xref?
Date: Thu, 14 May 2009 03:23:27 -0400

   > I like this better than what I purposed, would it be possible to
   > also use srcdir/texinfo?  I would suggest one line instead of
   > two:
   >   manual split-dir-manual mono-manual.html
   > I do not see why it should be two.

   In case one want to supply the information only for one type of
   splitting.  Otherwise, with one line for both you'll have to use a
   special way to say nothing, like

   manual '' mono-manual.html

I do not think that this is a big problem, most manuals have both,
very few have only one (since mono manuals tend to be very large).

   So I think telling explicitely if the manual is split or mono is
   better.  It also can be extended more easily, for example texi2html
   can also split in 2 other ways (chapter and section), and though
   today the links are always done like if it was split at nodes, with
   redirection files, this could be changed in the future more easily
   if new splitting modes can be added.

While the syntax is extensible, it will be hard of you have lots of
references across mulitple sites and variants.  If one uses all four
for each manual, you quickly get lots of duplicate information.

Maybe a good compromise would be if the next line only has two
columns, it is assume that it refers to the same manual,

  libc mono mono-manual.html
       split split-dir/

  coreutils mono coreutils.html
            split coreutils/

What do you think?

reply via email to

[Prev in Thread] Current Thread [Next in Thread]