emacs-devel
[Top][All Lists]
Advanced

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

Re: What is normal these days (display.texi)?


From: Robert J. Chassell
Subject: Re: What is normal these days (display.texi)?
Date: Sat, 8 Jul 2006 17:50:33 +0000 (UTC)

Today's GNU Emacs CVS snapshot, Sat, 2006 Jul  8  12:11 UTC
GNU Emacs 22.0.50.27 (i686-pc-linux-gnu, GTK+ Version 2.8.18)
started with

     /usr/local/src/emacs/src/emacs -Q -D 

and with the following evaluated:

    (setq Info-hide-note-references nil)

On evaluating (info "(texinfo)ref"), I do not see a `see' before
address@hidden'.  That is because customarily I give
`Info-hide-note-references' a value of nil.

That matches the documentation, which says

    8.6 address@hidden'
    ==========

    address@hidden' is nearly the same as address@hidden' except that it does 
not generate a
    `See' in the printed output, just the reference itself. 

However, David Kastrup does see `see' plus the reference, not just the
reference itself.  That is because he accepts the default, in which
the value of `Info-hide-note-references' is t.

`describe-variable' on `Info-hide-note-references' (in the plain
vanilla Emacs as described above, after loading `info') says

    Info-hide-note-references is a variable defined in `info.el'.
    Its value is t

    Documentation:
    *If non-nil, hide the tag and section reference in *note and * menu items.
    If value is non-nil but not `hide', also replaces the "*note" with "see".
    If value is non-nil but not t or `hide', the reference section is
    still shown.  
    `nil' completely disables this feature.

This is very interesting.  The format is more variable than I
remembered.  You cannot use `see' in a document that may be output in
various ways.

As David Kastrup says, following Eli, 

    I think adding "and" should do the trick here.

and I agree.

-- 
    Robert J. Chassell                         
    address@hidden                         GnuPG Key ID: 004B4AC8
    http://www.rattlesnake.com                  http://www.teak.cc




reply via email to

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