From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Bill Wohler Newsgroups: gmane.emacs.devel Subject: Re: "Non-nil means" versus "On means" in docstrings Date: Fri, 28 Oct 2005 09:22:44 -0700 Organization: Newt Software Message-ID: <19831.1130516564@olgas.newt.com> References: <31729.1130452199@olgas.newt.com> NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1130517248 13703 80.91.229.2 (28 Oct 2005 16:34:08 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 28 Oct 2005 16:34:08 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 28 18:34:06 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EVX8Y-0000fS-Hl for ged-emacs-devel@m.gmane.org; Fri, 28 Oct 2005 18:31:26 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EVX8X-000222-U0 for ged-emacs-devel@m.gmane.org; Fri, 28 Oct 2005 12:31:25 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EVX0P-0005ab-12 for emacs-devel@gnu.org; Fri, 28 Oct 2005 12:23:01 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EVX0N-0005ZF-K4 for emacs-devel@gnu.org; Fri, 28 Oct 2005 12:23:00 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EVX0N-0005Ye-7u for emacs-devel@gnu.org; Fri, 28 Oct 2005 12:22:59 -0400 Original-Received: from [207.69.195.66] (helo=pop-canoe.atl.sa.earthlink.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EVX0H-0004Xb-TC; Fri, 28 Oct 2005 12:22:54 -0400 Original-Received: from h-68-165-5-222.snvacaid.dynamic.covad.net ([68.165.5.222] helo=olgas.newt.com) by pop-canoe.atl.sa.earthlink.net with esmtp (Exim 3.36 #10) id 1EVX0G-00016W-00; Fri, 28 Oct 2005 12:22:52 -0400 Original-Received: by olgas.newt.com (Postfix, from userid 1000) id 9286C16FD8; Fri, 28 Oct 2005 09:22:44 -0700 (PDT) Original-Received: from olgas.newt.com (localhost [127.0.0.1]) by olgas.newt.com (Postfix) with ESMTP id 8D35416FAC; Fri, 28 Oct 2005 09:22:44 -0700 (PDT) Original-To: Eli Zaretskii In-Reply-To: Eli Zaretskii's message of Fri, 28 Oct 2005 10:31:17 +0200. X-Mailer: MH-E 7.85+cvs; nmh 1.1; GNU Emacs 21.4.1 X-Image-URL: http://www.newt.com/wohler/images/bill-diving.png X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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:45041 Archived-At: Eli Zaretskii wrote: > > Date: Thu, 27 Oct 2005 15:29:59 -0700 > > From: Bill Wohler > > > > ;; If the variable has -flag in the name, make sure > > (if (and (string-match "-flag$" (car fp)) > > - (not (looking-at "\"\\*?Non-nil\\s-+means\\s-+"))) > > + (not (looking-at > > + "\"\\*?\\(Non-nil\\|On\\)\\s-+means\\s-+"))) > > (checkdoc-create-error > > "Flag variable doc strings should usually start: Non-nil means" > > s (marker-position e) t)) > > I don't have a strong opinion about this, but IMHO if we allow "On" as > well as "Non-nil", the message displayed if none of them is used > should mention both possibilities. You suggest to modify the code, > but not the message. I would be happy to modify the message too. -- Bill Wohler http://www.newt.com/wohler/ GnuPG ID:610BD9AD Maintainer of comp.mail.mh FAQ and MH-E. Vote Libertarian! If you're passed on the right, you're in the wrong lane.