From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: doc elisp intro cross reference fixes Date: Tue, 18 Nov 2003 17:34:28 +0200 Organization: JURTA Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <87znetsnaz.fsf@mail.jurta.org> References: <87wua28zux.fsf@zip.com.au> <87ad6vdsxi.fsf@mail.jurta.org> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1069170159 1275 80.91.224.253 (18 Nov 2003 15:42:39 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 18 Nov 2003 15:42:39 +0000 (UTC) Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Tue Nov 18 16:42:36 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1AM7zw-0006BO-00 for ; Tue, 18 Nov 2003 16:42:36 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AM7zw-0001UX-00 for ; Tue, 18 Nov 2003 16:42:36 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.24) id 1AM8tH-0008Mk-GY for emacs-devel@quimby.gnus.org; Tue, 18 Nov 2003 11:39:47 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1AM8sV-0007un-1o for emacs-devel@gnu.org; Tue, 18 Nov 2003 11:38:59 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1AM8rL-0005dk-0k for emacs-devel@gnu.org; Tue, 18 Nov 2003 11:38:19 -0500 Original-Received: from [64.246.52.22] (helo=ns5.tangramltd.com) by monty-python.gnu.org with esmtp (TLSv1:DES-CBC3-SHA:168) (Exim 4.24) id 1AM8rF-0005YW-9o for emacs-devel@gnu.org; Tue, 18 Nov 2003 11:37:41 -0500 Original-Received: from 80-235-38-96-dsl.mus.estpak.ee ([80.235.38.96] helo=mail.jurta.org) by ns5.tangramltd.com with esmtp (Exim 4.20) id 1AM7ti-00069P-2r for emacs-devel@gnu.org; Tue, 18 Nov 2003 17:36:10 +0200 Original-To: emacs-devel@gnu.org In-Reply-To: (Robert J. Chassell's message of "Mon, 17 Nov 2003 15:12:00 -0500 (EST)") User-Agent: Gnus/5.1003 (Gnus v5.10.3) Emacs/21.3.50 (gnu/linux) X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - ns5.tangramltd.com X-AntiAbuse: Original Domain - gnu.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - jurta.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.2 Precedence: list List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:17885 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:17885 "Robert J. Chassell" writes: > Juri Linkov wrote > The edit-options command is no longer described in the emacs > manual, because it is obsolete now. Perhaps emacs-lisp-intro > shouldn't suggest obsolete packages, so all these three paragraphs > about edit-options should be removed from emacs-lisp-intro. > > This is a good idea. I have commented out the three paragraphs in > emacs/lispintro/emacs-lisp-intro.texi > > (eintr)defvar and asterisk > > Next time you `make info dvi html' the surface representations should > be updated. > > Is the main point of the node still accurate? > > When you specified a variable using the @code{defvar} special > form, you could distinguish a readily settable variable from > others by typing an asterisk, @samp{*}, in the first column of its > documentation string. .... Yes, this point is still accurate. However, I'd like to propose a better alternative for the above mentioned three paragraphs: to replace in those three paragraphs the command `edit-options' by its valid equivalent `set-variable'. Sorry, I didn't propose this earlier, this idea came to me just now. =================================================================== @noindent This means that you could (and still can) use the @code{set-variable} command to change the value of @code{shell-command-default-error-buffer} temporarily. @findex set-variable However, options set using @code{set-variable} are set only for the duration of your editing session. The new values are not saved between sessions. Each time Emacs starts, it reads the original value, unless you change the value within your @file{.emacs} file, either by setting it manually or by using @code{customize}. @xref{Emacs Initialization, , Your @file{.emacs} File}. For me, the major use of the @code{set-variable} command is to suggest variables that I might want to set in my @file{.emacs} file. I urge you to look through the list. =================================================================== Seems this last paragraph should be improved to tell that full list of user options can be displayed by pressing the tab character in the minibuffer after calling the `M-x set-variable' command. -- http://www.jurta.org/emacs/