Re: pxref

[Robert J. Chassell]

    >     Here is a standalone @xref within parentheses:
    > 
    >     (see Musings on fossil fuels.)
    > 
    >     Here is another @xref within parentheses, but with following text:
    > 
    >     (see Musings on fossil fuels, with non-cross-reference text.)

    What is wrong with this display?  Please spell that out, since
    AFAIK what you show is how the @xref's are supposed to be
    displayed in Emacs.

In English, a standalone sentence is supposed to start with a capital
letter.  This has been a convention for centuries.

Consequently, a standalone @xref should start with a capital S
regardless whether it is inside of parentheses or not.

The parentheses should have no effect and indeed they do not.  In the
default display of today's GNU Emacs CVS snapshot, @xref does wrong in
all circumstances.  When Texinfo 4.8 builds this:

    Here is an @@xref  standing abosolutely alone:

    @xref{Musings on fossil fuels}.

The default for Info started from `emacs -Q -D' is

    Here is an @xref  standing abosolutely alone:

    see Musings on fossil fuels.

That should be a capital S for `See'.  (The reference itself is
underlined and a different color; it is fine.)

In the default GNU Emacs display, @ref is supposed to start with a
lower case letter so the reference can be used within a sentence; and
it does correctly.

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