From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: karl@freefriends.org (Karl Berry) Newsgroups: gmane.emacs.devel Subject: Re: Invisible colons in Emacs Info. Date: Wed, 25 Jun 2003 15:58:50 -0400 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200306251958.h5PJwor30121@f7.net> NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1056574736 16475 80.91.224.249 (25 Jun 2003 20:58:56 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Wed, 25 Jun 2003 20:58:56 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Wed Jun 25 22:58:52 2003 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 19VHLV-0004Eh-00 for ; Wed, 25 Jun 2003 22:58:25 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 19VHPh-0001WW-00 for ; Wed, 25 Jun 2003 23:02:45 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.20) id 19VHCZ-0005Ql-Em for emacs-devel@quimby.gnus.org; Wed, 25 Jun 2003 16:49:11 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.20) id 19VGk5-0006ty-Ki for emacs-devel@gnu.org; Wed, 25 Jun 2003 16:19:45 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.20) id 19VGYY-0003kk-QV for emacs-devel@gnu.org; Wed, 25 Jun 2003 16:07:52 -0400 Original-Received: from consort.superb.net ([209.61.216.22] helo=f7.net) by monty-python.gnu.org with esmtp (Exim 4.20) id 19VGPs-0001VZ-0l for emacs-devel@gnu.org; Wed, 25 Jun 2003 15:58:52 -0400 Original-Received: (from karl@localhost) by f7.net (8.11.7/8.11.7) id h5PJwor30121; Wed, 25 Jun 2003 15:58:50 -0400 Original-To: monnier+inbox@cs.yale.edu Original-cc: teirllm@dms.auburn.edu X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Emacs development discussions. List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:15251 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:15251 In nornal menus, things look like: * menu:entry. description. whereas in indices, the description is missing and things look like: * menu: entry. Indexes are completely normal menus. There is nothing to stop a user from doing something like @menu * Foo: bar. @end menu * menu:entry. description. will yield an error. That's a bug. There can be any number of spaces after the colon in the menu:entry form, including zero. support colons in the middle of menu subtopic names. That just can't be done right now. A new syntax for quoting node names has to be introduced to fix it, kludging with whitespace won't solve the problem. As we've discussed before. This won't be happening for Emacs 21.4. blame me if you disagree) very much want to support entries like: * menu:entry: entry. description. To what end? I mean, what are the real examples that are hoped to be supported? This is new Info syntax, as far as I know. If makeinfo doesn't complain about it, it probably should. I don't understand even this skeletal example. Surely the point here is not to repeat the node name `entry', that wouldn't be useful. As far as I know, there are exactly two valid menu formats. From the Menu Example node in the Texinfo manual: @menu * menu entry name: Node name. A short description. * Node name:: This form is preferred. @end menu This produces: * menu: * menu entry name: Node name. A short description. * Node name:: This form is preferred. That's it. It covers regular menus, indexes, and dir entries. All have the same syntax. You can't just randomly decide to do new stuff with colons, periods, parens, etc. in menu entries without breaking many existing documents/installations.