[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Info mode - inconsistent display of cross-references
From: |
Alan Mackenzie |
Subject: |
Info mode - inconsistent display of cross-references |
Date: |
Sat, 25 Aug 2007 08:23:50 +0000 |
User-agent: |
Mutt/1.5.9i |
Hi, Emacs!
In Emacs 22.1, display the page "Getting Started" in the CC Mode manual.
The second paragraph is displayed thusly:
You should probably start by skimming through the entire chapter
see Commands to get an overview of CC Mode's capabilities.
^^^^
. The "see " in "see Commands" is an artifact of the Info display code,
and is horrible, disgusting and ghastly. It should not appear.
A little bit lower down on the same page, we have:
A list of
the available styles and their descriptions can be found in
Built-in Styles.
^^^^
Here there is no obtrusive "see " in front of "Built-in Styles", and this
is all right.
However, in the raw file ...../info/ccmode, both of these xrefs are
coded the same way, namely "*Note Commands::" and "*Note
Built-in Styles::". (Well, there's a linefeed in the second one, but
they're otherwise the same.)
In the source file, cc-mode.texi, both xrefs are coded correctly with the
@ref{} construct.
Whatever's going on here is surely a bug. Both of these should be
displayed the same, _without_ the obtrusive "see ". If this can't be
done because of limitiations in the Info format, it would surely be less
bad to display the raw "*Note Commands", since this is being honest about
Info and doesn't make the writer of the manual look incompetent.
--
Alan Mackenzie (Ittersbach, Germany).
- Info mode - inconsistent display of cross-references,
Alan Mackenzie <=