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: Info - some notes about customization Date: Sun, 05 Dec 2004 22:51:24 +0200 Message-ID: <01c4db0c$Blat.v2.2.2$546f7e60@zahav.net.il> References: <075201c4d9a0$9e3d0390$0200a8c0@sedrcw11488> <87mzwstx4z.fsf@jurta.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: deer.gmane.org Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7BIT X-Trace: sea.gmane.org 1102279964 1847 80.91.229.6 (5 Dec 2004 20:52:44 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 5 Dec 2004 20:52:44 +0000 (UTC) Cc: lennart.borgman.073@student.lu.se, karl@freefriends.org, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Dec 05 21:52:35 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1Cb3Mx-0006Qd-00 for ; Sun, 05 Dec 2004 21:52:35 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1Cb3We-0003iL-Qo for ged-emacs-devel@m.gmane.org; Sun, 05 Dec 2004 16:02:36 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1Cb3WX-0003i6-VU for emacs-devel@gnu.org; Sun, 05 Dec 2004 16:02:30 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1Cb3WX-0003hu-H4 for emacs-devel@gnu.org; Sun, 05 Dec 2004 16:02:29 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1Cb3WX-0003hr-DY for emacs-devel@gnu.org; Sun, 05 Dec 2004 16:02:29 -0500 Original-Received: from [192.114.186.15] (helo=balder.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.34) id 1Cb3MA-0008Dp-EL for emacs-devel@gnu.org; Sun, 05 Dec 2004 15:51:46 -0500 Original-Received: from zaretski ([80.230.156.125]) by balder.inter.net.il (Mirapoint Messaging Server MOS 3.3.7-GR) with ESMTP id DWW16775 (AUTH halo1); Sun, 5 Dec 2004 22:50:56 +0200 (IST) Original-To: Juri Linkov X-Mailer: emacs 21.3.50 (via feedmail 8 I) and Blat ver 2.2.2 In-reply-to: <87mzwstx4z.fsf@jurta.org> (message from Juri Linkov on Sun, 05 Dec 2004 20:31:24 +0200) 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: main.gmane.org gmane.emacs.devel:30716 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:30716 > From: Juri Linkov > Date: Sun, 05 Dec 2004 20:31:24 +0200 > Cc: eliz@gnu.org, emacs-devel@gnu.org, karl@freefriends.org > > The node "Command Arguments" can't be renamed because then the > standalone Info reader will fail to find this node with its > -O, --show-options, --usage option. It could be changed to one of the other node names that --usage looks for. > It looks for the following names: > > "%s invocation", > "Invoking %s", > "Preliminaries", /* m4 has Invoking under Preliminaries! */ > "Invocation", > "Command Arguments",/* Emacs */ > "Invoking `%s'", > "%s options", > "Options", > "Option ", /* e.g. "Option Summary" */ > "Invoking", > "All options", /* tar, paxutils */ > "Arguments", > "%s cmdline", /* ar */ > "%s", /* last resort */ > > and will find a completely irrelevant node when the > "Command Arguments" node becomes renamed to something else. The fact that the Info reader needs to jump through the hoops to find the node that describes the command-line arguments is IMHO an evidence of poor adherence to GNU coding standards. It is IMHO a shame that Emacs, of all GNU programs, is one of those which required the crazy code I wrote to implement --usage, since standards.texi explicitly says that a manual should have a node "PROGRAM Invocation" or "Invoking PROGRAM", so that "info --usage" could find it. So perhaps it's high time we changed the Emacs manual to have a node "Emacs Invocation" ("Invoking Emacs" will interfere with the already existing "Invoking emacsclient"), which will solve both of the problems in one blow.