bug-texinfo
[Top][All Lists]
Advanced

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

Re: index.html clashes with Index nodes


From: Karl Berry
Subject: Re: index.html clashes with Index nodes
Date: Fri, 26 Nov 2010 22:24:43 GMT

    People are complaining that HTML versions of manuals cannot be moved
    to MS-Windows 

They should remake the manual.  People using Windows have to expect
extra pain to be incurred.

But that's not what the message you pointed to is really talking about.
For people doing cross-compilation, the manual shouldn't even be getting
built, as far as I can see.  Certainly not in HTML!  That only needs to
be done by people making releases, or perhaps working on the
documentation.  The build process seems to be going too far.

    we should either add an option to do that, 

A runtime option would be ok, but I would not encourage GNU packages to
use it, because we're not supposed to cater to Windows, and merging
index and Index into the same file is ugly for users.

I don't know what the Perl implementation does, but I'm sure it won't be
hard to add an option (or perhaps configuration variable), since of
course there is no "compile time".

    or document in texinfo.texi that the name "Index" should be
    avoided in GNU manuals, for this reason.
    
The OP may think that's the "simple solution, but I vehemently dislike
it most of all, and am sad to hear that Cygnus/Red Hat's other GNU
manuals are already doing it.  "Index" is a natural name.  And even
more, renaming nodes is not something to do lightly (causes breakage to
anything referring to the existing name), certainly not to work around
Windows breakage when a workaround *already exists*.

Sigh.

karl



reply via email to

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