From mboxrd@z Thu Jan  1 00:00:00 1970
Path: main.gmane.org!not-for-mail
From: "Stefan Monnier" <monnier+gnu/emacs@rum.cs.yale.edu>
Newsgroups: gmane.emacs.devel
Subject: Re: Lowercase text after full stop on describe-variable
Date: Mon, 24 Jun 2002 11:23:08 -0400
Sender: emacs-devel-admin@gnu.org
Message-ID: <200206241523.g5OFN8B02270@rum.cs.yale.edu>
References: <20020624134828.2CD6.LEKTU@terra.es>
NNTP-Posting-Host: localhost.gmane.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Trace: main.gmane.org 1024932298 10772 127.0.0.1 (24 Jun 2002 15:24:58 GMT)
X-Complaints-To: usenet@main.gmane.org
NNTP-Posting-Date: Mon, 24 Jun 2002 15:24:58 +0000 (UTC)
Cc: emacs-devel@gnu.org
Return-path: <emacs-devel-admin@gnu.org>
Original-Received: from quimby.gnus.org ([80.91.224.244])
	by main.gmane.org with esmtp (Exim 3.33 #1 (Debian))
	id 17MVi5-0002nd-00
	for <emacs-devel@main.gmane.org>; Mon, 24 Jun 2002 17:24:57 +0200
Original-Received: from fencepost.gnu.org ([199.232.76.164])
	by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian))
	id 17MVjI-0005j8-00
	for <emacs-devel@quimby.gnus.org>; Mon, 24 Jun 2002 17:26:12 +0200
Original-Received: from localhost ([127.0.0.1] helo=fencepost.gnu.org)
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 17MVhb-0007C5-00; Mon, 24 Jun 2002 11:24:27 -0400
Original-Received: from rum.cs.yale.edu ([128.36.229.169])
	by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian))
	id 17MVgU-00074y-00
	for <emacs-devel@gnu.org>; Mon, 24 Jun 2002 11:23:18 -0400
Original-Received: (from monnier@localhost)
	by rum.cs.yale.edu (8.11.6/8.11.6) id g5OFN8B02270;
	Mon, 24 Jun 2002 11:23:08 -0400
X-Mailer: exmh version 2.4 06/23/2000 with nmh-1.0.4
Original-To: Juanma Barranquero <lektu@terra.es>
Errors-To: emacs-devel-admin@gnu.org
X-BeenThere: emacs-devel@gnu.org
X-Mailman-Version: 2.0.9
Precedence: bulk
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Post: <mailto:emacs-devel@gnu.org>
List-Subscribe: <http://mail.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=subscribe>
List-Id: Emacs development discussions. <emacs-devel.gnu.org>
List-Unsubscribe: <http://mail.gnu.org/mailman/listinfo/emacs-devel>,
	<mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://mail.gnu.org/pipermail/emacs-devel/>
Xref: main.gmane.org gmane.emacs.devel:5152
X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:5152

> When a variable is obsolete, the help info looks ugly because the "not
> documented as a variable" text is not capitalized after a full stop.
> 
> Example from local-write-file-hooks:
> 
> > Documentation:
> > This variable is obsolete since 21.4.
> > Use `write-file-functions' instead.
> > not documented as a variable.
> 
> Perhaps it is better to put the obsolescence info after the variable
> documentation, unless the current point was purposelly chosen to
> highlight the fact that the variable is obsolete.

How about just capitalizing the `not' ?
After all, even without the obsolete stuff it deserves a capital, doesn't it?


	Stefan