emacs-devel
[Top][All Lists]
Advanced

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

Re: [PATCH] ignoring Info extensions


From: Juri Linkov
Subject: Re: [PATCH] ignoring Info extensions
Date: Thu, 01 Apr 2004 19:33:15 +0300
User-agent: Gnus/5.110002 (No Gnus v0.2) Emacs/21.3.50 (gnu/linux)

address@hidden (Karl Berry) writes:
> I will change makeinfo to make this an error, or at least a warning,
> and remove such trailing whitespace so it doesn't get into the output.

I think a warning is ok.  But moreover, I noticed other places
in Info manuals that cause problems for Info readers:

By funny coincidence, the LilyPond music glossary contains words
`*note*' emphasized by asterisks around them, where the word `note'
means a symbol for a musical tone.  But it is interpreted by the Info
reader as an Info reference, and if Info-hide-note-references=t it is
displayed as `See *'.  Even though the Texinfo manual warns about
using asterisks with the word `note', it suggests to replace it
by a phrase such as *Please notice* which is inappropriate here.
Perhaps makeinfo should produce a warning about it, but still
I don't see how the author would fix this problem.

There are many other Info manuals that have a string `*Note:'
which is treated incorrectly by Info readers.  What do you think
about interpreting a `*Note' as an Info reference only if it
has whitespace around it, i.e. if it matches the following regexp?

[ \t\n]+\*[Nn]ote[ \t\n]+

It would also solve the problem of incorrect interpreting of
the quoted ``*Note:'' string such as in the following Info nodes:

(info "(info)Cross-refs")
(info "(info-stnd)Parts of an Xref")
(info "(texinfo)Cross Reference Commands")

-- 
Juri Linkov
http://www.jurta.org/emacs/





reply via email to

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