From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs,gmane.emacs.pretest.bugs Subject: bug#1424: 23.0.60; nil vs `nil' in manuals Date: Mon, 24 Nov 2008 14:42:53 -0800 Message-ID: <006301c94e85$fd21fdd0$c2b22382@us.oracle.com> Reply-To: Drew Adams , 1424@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1227567042 18148 80.91.229.12 (24 Nov 2008 22:50:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 24 Nov 2008 22:50:42 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Nov 24 23:51:45 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1L4kHF-00043M-Nc for geb-bug-gnu-emacs@m.gmane.org; Mon, 24 Nov 2008 23:51:35 +0100 Original-Received: from localhost ([127.0.0.1]:58073 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L4kG6-0003ZR-Cl for geb-bug-gnu-emacs@m.gmane.org; Mon, 24 Nov 2008 17:50:22 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1L4kG2-0003Xh-9u for bug-gnu-emacs@gnu.org; Mon, 24 Nov 2008 17:50:18 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1L4kG0-0003WG-Vp for bug-gnu-emacs@gnu.org; Mon, 24 Nov 2008 17:50:17 -0500 Original-Received: from [199.232.76.173] (port=34561 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1L4kG0-0003W8-QH for bug-gnu-emacs@gnu.org; Mon, 24 Nov 2008 17:50:16 -0500 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:35610) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L4kG0-0006Kg-F9 for bug-gnu-emacs@gnu.org; Mon, 24 Nov 2008 17:50:16 -0500 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mAOMoAke010578; Mon, 24 Nov 2008 14:50:10 -0800 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.13.8/8.13.8/Submit) id mAOMo3MX009919; Mon, 24 Nov 2008 14:50:03 -0800 X-Loop: don@donarmstrong.com Resent-From: "Drew Adams" Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs Resent-Date: Mon, 24 Nov 2008 22:50:03 +0000 Resent-Message-ID: Resent-Sender: don@donarmstrong.com X-Emacs-PR-Message: report 1424 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.12275665908599 (code B ref -1); Mon, 24 Nov 2008 22:50:03 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 24 Nov 2008 22:43:10 +0000 Original-Received: from fencepost.gnu.org (fencepost.gnu.org [140.186.70.10]) by rzlab.ucr.edu (8.13.8/8.13.8/Debian-3) with ESMTP id mAOMh6Co008588 for ; Mon, 24 Nov 2008 14:43:07 -0800 Original-Received: from mail.gnu.org ([199.232.76.166]:44101 helo=mx10.gnu.org) by fencepost.gnu.org with esmtp (Exim 4.67) (envelope-from ) id 1L4k8n-0002h8-TV for emacs-pretest-bug@gnu.org; Mon, 24 Nov 2008 17:42:50 -0500 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1L4k90-00057J-Fd for emacs-pretest-bug@gnu.org; Mon, 24 Nov 2008 17:43:04 -0500 Original-Received: from rcsinet13.oracle.com ([148.87.113.125]:35986 helo=rgminet13.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1L4k8z-000572-VA for emacs-pretest-bug@gnu.org; Mon, 24 Nov 2008 17:43:02 -0500 Original-Received: from rgminet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rgminet13.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id mAOMhEc0026274 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Mon, 24 Nov 2008 22:43:18 GMT Original-Received: from acsmt705.oracle.com (acsmt705.oracle.com [141.146.40.83]) by rgminet15.oracle.com (Switch-3.3.1/Switch-3.3.1) with ESMTP id mAOMgvlf001736 for ; Mon, 24 Nov 2008 22:42:58 GMT Original-Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Mon, 24 Nov 2008 14:42:51 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: AclOhfzaWjfjt89yQleZLQxWFgExTg== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3350 X-Source-IP: acsmt705.oracle.com [141.146.40.83] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090209.492B2DEC.021C:SCFSTAT928724,ss=1,fgs=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) Resent-Date: Mon, 24 Nov 2008 17:50:17 -0500 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:22642 gmane.emacs.pretest.bugs:23403 Archived-At: Most of the time, outside code examples, "nil" is written "`nil'" in the manuals (I'm looking at Info). Here are some exceptions, which I think are typos. Emacs manual: * Node Watch Expressions If the variable `gdb-delete-out-of-scope' is non-`nil' (the default value), Emacs automatically deletes watch expressions which go out of scope. Sometimes, when re-entering the same function, it may be useful to set this value to nil so that you don't need to recreate ^^^ the watch expression. Elisp manual: * Node `nil and t': Function: booleanp object Return non-nil if OBJECT is one of the two canonical boolean ^^^ values: `t' or `nil'. * Node Predicates for Strings Function: string-or-null-p object This function returns `t' if OBJECT is a string or nil, `nil' ^^^ otherwise. * Node Declaring Functions Macro: declare-function function file &optional arglist fileonly Tell the byte compiler to assume that FUNCTION is defined, with arguments ARGLIST, and that the definition should come from the file FILE. FILEONLY non-nil means only check that FILE exists, ^^^ not that it actually defines FUNCTION. * Node Key Sequence When reading input results in such a "shift-translation", Emacs sets the variable `this-command-keys-shift-translated' to a non-nil value. ^^^ * Node Changing Files Function: file-modes-symbolic-to-number modes &optional base-modes This subroutine converts a symbolic specification of file mode bits in MODES into the equivalent numeric value. If the symbolic specification is based on an existing file, that file's mode bits are taken from the optional argument BASE-MODES; if that argument is omitted or nil, it defaults to zero, i.e. no access rights at ^^^ all. * Node Magic File Names Function: unhandled-file-name-directory filename This function returns the name of a directory that is not magic. It uses the directory part of FILENAME if that is not magic. For a magic file name, it invokes the file name handler, which therefore decides what value to return. If FILENAME is not accessible from a local process, then the file name handler should indicate it by returning nil. ^^^ * Node Selecting Windows Macro: with-selected-window window forms... This macro selects WINDOW, executes FORMS in sequence, then restores the previously selected window and current buffer. The ordering of recently selected windows and the buffer list remain unchanged unless you deliberately change them within FORMS, for example, by calling `select-window' with argument NORECORD nil or ^^^ omitted there. * Node Choosing Window User Option: pop-up-windows This variable specifies whether `display-buffer' is allowed to split (*note Splitting Windows::) an existing window . If it is non-`nil', `display-buffer' tries to the split the largest or least recently used window on the selected frame. (If the selected frame is a minibuffer-only frame, it tries to split a window on another frame instead.) If `pop-up-windows' is nil or the variable ^^^ `pop-up-frames' (see below) is non-`nil', `display-buffer' does not split any window. * Node The Mark Function: handle-shift-selection &optional deactivate This function checks whether the current command was invoked via shift translation (*note shift-translation: Key Sequence Input.), and if so, sets the mark and temporarily activates the region, unless the region is already temporarily activated in this way. If the command was invoked without shift translation, or if the optional argument DEACTIVATE is non-nil, the function deactivates ^^^ the mark. This function is called whenever a command with a `^' character in its `interactive' spec (*note ^: Interactive Codes.) is invoked while `shift-select-mode' (*note Shift Selection: (emacs)Shift Selection.) is non-`nil'. * Node Shell Arguments If SEPARATORS is omitted or nil, it defaults to `"\\s-+"', which ^^^ is a regular expression that matches one or more characters with whitespace syntax (*note Syntax Class Table::). * Node Transaction Queues If the argument DELAY-QUESTION is non-nil, delay sending this ^^^ question until the process has finished replying to any previous questions. This produces more reliable results with some processes. * Node Proceessor Run Time If FORMAT is nil or omitted, it defaults to `"%Y, %D, %H, %M, %z%S"'. ^^^ * Node Documentation Tips When a documentation string refers to a Lisp symbol, write it as it would be printed (which usually means in lower case), with single-quotes around it. For example: `lambda'. There are two exceptions: write t and nil without single-quotes. (In this ^ ^^^ manual, we use a different convention, with single-quotes for all symbols.) Actually, those two should probably be written in double quotes, since we are referring to the text, not to the symbols, when talking about "t" and "nil" here. In GNU Emacs 23.0.60.1 (i386-mingw-nt5.1.2600) of 2008-11-08 on LENNART-69DE564 Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/g/include -fno-crossjumping'