From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Richard M. Stallman" Newsgroups: gmane.emacs.devel Subject: Re: [PATCH] intro.texi Date: Fri, 02 Sep 2005 02:05:49 -0400 Message-ID: References: <92a5eb4705090107224b61e495@mail.gmail.com> Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org Content-Type: text/plain; charset=ISO-8859-15 X-Trace: sea.gmane.org 1125643159 19279 80.91.229.2 (2 Sep 2005 06:39:19 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 2 Sep 2005 06:39:19 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Sep 02 08:39:08 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EB5BP-0000lx-VZ for ged-emacs-devel@m.gmane.org; Fri, 02 Sep 2005 08:37:52 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EB5Fg-00043V-KM for ged-emacs-devel@m.gmane.org; Fri, 02 Sep 2005 02:42:16 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EB4x0-0008EQ-SO for emacs-devel@gnu.org; Fri, 02 Sep 2005 02:22:59 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EB4wy-0008DY-TU for emacs-devel@gnu.org; Fri, 02 Sep 2005 02:22:57 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EB4wx-0007zn-Ic for emacs-devel@gnu.org; Fri, 02 Sep 2005 02:22:55 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EB4kQ-0001M4-2G for emacs-devel@gnu.org; Fri, 02 Sep 2005 02:09:58 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34) id 1EB4gP-0004OX-Iq; Fri, 02 Sep 2005 02:05:49 -0400 Original-To: Joshua Varner In-reply-to: <92a5eb4705090107224b61e495@mail.gmail.com> (message from Joshua Varner on Thu, 1 Sep 2005 09:22:25 -0500) 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:42574 Archived-At: Many of your suggested changes are good; I will comment on the ones that I don't plan to use. ! In Lisp, the symbol @dfn{@code{nil}} has three separate meanings: it is a symbol with the name @samp{nil}; it is the logical truth value We don't write @dfn around @code. @cindex documentation notation + @cindex notation, evaluation + @cindex notation, documentation Having two index entries in the same place that start with the same word is redundant; it would be better to add @cindex notation Examples in this manual indicate printed text with @samp{@print{}}, irrespective of where that text goes. The value returned by ! evaluating the form (here @code{bar}) follows on a separate line with ! @samp{@result{}}. @example @group --- 264,271 ---- Examples in this manual indicate printed text with @samp{@print{}}, irrespective of where that text goes. The value returned by ! evaluating the form (in the example below: @code{bar}) follows on a ! separate line with @samp{@result{}}. Using "here" is conventional, so it is good enough. @defvar emacs-major-version The major version number of Emacs, as an integer. For Emacs version ! 20.3, the value is @code{20}. We don't write @code around values that are numbers. It looks better not to do so.