bug-texinfo
[Top][All Lists]
Advanced

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

Re: bad relative urls in texinfo-4.0f


From: Per Bothner
Subject: Re: bad relative urls in texinfo-4.0f
Date: Thu, 14 Feb 2002 14:26:46 -0800
User-agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:0.9.8+) Gecko/20020208

Eli Zaretskii wrote:
On Wed, 13 Feb 2002, Per Bothner wrote:
>>Anybody who has multiple nodes that map to the same file name can
and should fix their node names.


Unfortunately, it's not always practical to request that, given how
many characters we replace with dashes.  Think about manuals that
describe C++ classes,

I do.  The only characters likely to require mapping are things
like 'operator+' and possibly '::'.  The former are unlikely to be
written with one node per operator.  The latter would not cause a clash.

or about manuals such as the Groff one,

What groff manual?  It is not install on my RH 7.2, and the groff home
page (http://www.gnu.org/software/groff/groff.html) does not seem to
hace it.

where the commands are typically cryptic and use many characters that need
to be replaced with a dash.

In addition, there are case-insensitive filesystems where the problem
is even more serious.

That I can see.

Still, how many *actual* mnauals have you come across where this was an
real problem?  And in how many of those cases would the manual authors
rather fix the node names rather than have clashing nodes unintentonally
end up on the same page?

Also, please keep in mind that node naming comes from the Texinfo
author, not from the user.  A user cannot do much when she reads a
manual with poor node names, so it's useless to punish her.

The texinfo author is responsible for making sure that the manual
generates reasonable html.  In this day and age, that is the most
important output format for documentation by far.
--
        --Per Bothner
address@hidden   http://www.bothner.com/per/




reply via email to

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