From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Eli Zaretskii" Newsgroups: gmane.emacs.devel Subject: Re: Proposal: emacs -Q option Date: Thu, 05 Feb 2004 21:14:56 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <9003-Thu05Feb2004211456+0200-eliz@elta.co.il> References: <87ad3y6l2a.fsf@mail.jurta.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1076010059 12963 80.91.224.253 (5 Feb 2004 19:40:59 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 5 Feb 2004 19:40:59 +0000 (UTC) Cc: emacs-devel@gnu.org, no-spam@cua.dk Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Thu Feb 05 20:40:37 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1AopMb-0003mq-00 for ; Thu, 05 Feb 2004 20:40:37 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1AopMa-0000vQ-00 for ; Thu, 05 Feb 2004 20:40: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 1AopHd-0004bG-CS for emacs-devel@quimby.gnus.org; Thu, 05 Feb 2004 14:35:29 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.24) id 1Aop0B-0008Hc-Ej for emacs-devel@gnu.org; Thu, 05 Feb 2004 14:17:27 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.24) id 1Aooyp-0007WC-1w for emacs-devel@gnu.org; Thu, 05 Feb 2004 14:16:35 -0500 Original-Received: from [192.114.186.24] (helo=legolas.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.24) id 1Aoox4-0006bQ-RS for emacs-devel@gnu.org; Thu, 05 Feb 2004 14:14:15 -0500 Original-Received: from zaretski (pns03-207-204.inter.net.il [80.230.207.204]) by legolas.inter.net.il (MOS 3.4.4-GR) with ESMTP id BGY39881; Thu, 5 Feb 2004 21:13:54 +0200 (IST) Original-To: Juri Linkov X-Mailer: emacs 21.3.50 (via feedmail 8 I) and Blat ver 1.8.9 In-reply-to: <87ad3y6l2a.fsf@mail.jurta.org> (message from Juri Linkov on Thu, 05 Feb 2004 09:29:33 +0200) 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:19756 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:19756 > From: Juri Linkov > Date: Thu, 05 Feb 2004 09:29:33 +0200 > > I found 3 places in the source tree where command line arguments are > documented: > > emacs/lisp/startup.el > emacs/man/cmdargs.texi > emacs/src/emacs.c > > and all of them are out of sync with the actual source code: > > --help, --version, --no-shared-memory, -nl, --find-file, --directory, > -L DIR, and some display options are missed in the cmdargs.texi. > > --no-desktop is not documented in the cmdargs.texi and emacs.c. > > --find-file and many display options are not documented in the startup.el. I think the proper places for this are the text printed by "emacs --help" and cmdargs.texi. Of these, the latter one lags behind the code because Emacs developers are not required to submit documentation changes together with code changes. Usually, when a new Emacs release is about to enter the pretest phase, we go through NEWS entries and update the docs accordingly. As for the fact that emacs.c doesn't mention some of the new options, it's probably a bug, unless, for some good reasons, we don't want to advertise them.