From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: "Richard M. Stallman" <rms@gnu.org>
Newsgroups: gmane.emacs.devel
Subject: Re: Changes to windows.texi
Date: Sun, 09 Nov 2008 10:13:34 -0500
Message-ID: <E1KzByo-0003Bd-KV@fencepost.gnu.org>
References: <4914514C.9020700@gmx.at> <uvduyqeda.fsf@gnu.org>
Reply-To: rms@gnu.org
NNTP-Posting-Host: lo.gmane.org
Content-Type: text/plain; charset=ISO-8859-15
X-Trace: ger.gmane.org 1226243819 28860 80.91.229.12 (9 Nov 2008 15:16:59 GMT)
X-Complaints-To: usenet@ger.gmane.org
NNTP-Posting-Date: Sun, 9 Nov 2008 15:16:59 +0000 (UTC)
Cc: rudalics@gmx.at, emacs-devel@gnu.org
To: Eli Zaretskii <eliz@gnu.org>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Nov 09 16:18:02 2008
connect(): Connection refused
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org>
Envelope-to: ged-emacs-devel@m.gmane.org
Original-Received: from lists.gnu.org ([199.232.76.165])
	by lo.gmane.org with esmtp (Exim 4.50)
	id 1KzC32-0007sg-83
	for ged-emacs-devel@m.gmane.org; Sun, 09 Nov 2008 16:17:56 +0100
Original-Received: from localhost ([127.0.0.1]:54595 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43)
	id 1KzC1u-0007st-C4
	for ged-emacs-devel@m.gmane.org; Sun, 09 Nov 2008 10:16:46 -0500
Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1KzC1p-0007sg-Cj
	for emacs-devel@gnu.org; Sun, 09 Nov 2008 10:16:41 -0500
Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1KzC1o-0007sU-1d
	for emacs-devel@gnu.org; Sun, 09 Nov 2008 10:16:40 -0500
Original-Received: from [199.232.76.173] (port=60512 helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1KzC1n-0007sR-Rq
	for emacs-devel@gnu.org; Sun, 09 Nov 2008 10:16:39 -0500
Original-Received: from fencepost.gnu.org ([140.186.70.10]:51126)
	by monty-python.gnu.org with esmtp (Exim 4.60)
	(envelope-from <rms@gnu.org>) id 1KzC1n-0001Ja-KK
	for emacs-devel@gnu.org; Sun, 09 Nov 2008 10:16:39 -0500
Original-Received: from rms by fencepost.gnu.org with local (Exim 4.67)
	(envelope-from <rms@gnu.org>)
	id 1KzByo-0003Bd-KV; Sun, 09 Nov 2008 10:13:34 -0500
In-reply-to: <uvduyqeda.fsf@gnu.org> (message from Eli Zaretskii on Sat, 08
	Nov 2008 20:09:05 +0200)
X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6,
	seldom 2.4 (older, 4)
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "Emacs development discussions." <emacs-devel.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org
Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org
Xref: news.gmane.org gmane.emacs.devel:105499
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/105499>

    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.