emacs-devel
[Top][All Lists]
Advanced

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

Re: Changes to windows.texi


From: Richard M. Stallman
Subject: Re: Changes to windows.texi
Date: Sun, 09 Nov 2008 10:13:34 -0500

    This usage of @xref in the middle of a sentence produces badly
    capitalized English, because @xref generates "See ..." with a capital
    S.  The right way of writing this kind of text is either

      The selected window's buffer is usually the current buffer (except
      when @code{set-buffer} has been used), see @ref{Current Buffer}.

It isn't correct to use a comma there -- you need a semicolon.

      If @var{window} is omitted, this function returns the buffer for the
      selected window.

Better is "If you omit..." since it is the active voice.




reply via email to

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