[Top][All Lists]

[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).

reply via email to

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