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.comp.tex.texinfo.bugs,gmane.emacs.devel Subject: Re: Indices in Info. Date: Tue, 24 Jun 2003 09:26:14 -0400 Sender: bug-texinfo-bounces+gnu-bug-texinfo=m.gmane.org@gnu.org Message-ID: <200306241326.h5ODQEc27294@f7.net> NNTP-Posting-Host: main.gmane.org X-Trace: main.gmane.org 1056461550 18367 80.91.224.249 (24 Jun 2003 13:32:30 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Tue, 24 Jun 2003 13:32:30 +0000 (UTC) Original-X-From: bug-texinfo-bounces+gnu-bug-texinfo=m.gmane.org@gnu.org Tue Jun 24 15:32:24 2003 Return-path: Original-Received: from monty-python.gnu.org ([199.232.76.173]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 19Unu5-0004kw-00 for ; Tue, 24 Jun 2003 15:32:09 +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 19Untg-0000GX-IQ for gnu-bug-texinfo@m.gmane.org; Tue, 24 Jun 2003 09:31:44 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.20) id 19Untb-0000E7-Jj for bug-texinfo@gnu.org; Tue, 24 Jun 2003 09:31:39 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.20) id 19Unsu-0008TD-6S for bug-texinfo@gnu.org; Tue, 24 Jun 2003 09:30:56 -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 19UnoM-0007J5-RG; Tue, 24 Jun 2003 09:26:14 -0400 Original-Received: (from karl@localhost) by f7.net (8.11.7/8.11.7) id h5ODQEc27294; Tue, 24 Jun 2003 09:26:14 -0400 Original-to: teirllm@dms.auburn.edu, emacs-devel@gnu.org, bug-texinfo@gnu.org X-BeenThere: bug-texinfo@gnu.org X-Mailman-Version: 2.1b5 Precedence: list List-Id: Bug reports for the GNU Texinfo documentation system List-Help: List-Post: List-Subscribe: , List-Archive: List-Unsubscribe: , Errors-To: bug-texinfo-bounces+gnu-bug-texinfo=m.gmane.org@gnu.org Xref: main.gmane.org gmane.comp.tex.texinfo.bugs:1088 gmane.emacs.devel:15207 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:15207 > * $Id:: GNU Sample Texts. I removed the :'s from these index entries in texinfo.txi. "Emacs should be able to handle this correctly" Yes it should. Regardless of the (newline) example (see below), consider this index entry: @cindex (dir) as Up node of Top node Here, the parentheses are meaningful and correct. I could also imagine wanting to index ( in a programming language manual. I'm sure there are other index entries that start with ( out there as well, since it's always been allowed. or "starting an index entry with a parenthetical remark makes no sense"? In this particular instance, it definitely would seem more logical to have entries named "newline", "space" and "tab", This is in the command index. The manual is not talking about a command @newline. It's talking about @. That's why I put the parentheses in. I suppose angle brackets instead of parentheses might be slightly better. I changed it. But that's irrelevant to the question of whether index entries can start with (. They should be able to. And the leading parentheses work in Emacs 21.3, at least they do for me. So perhaps this got broken in the current source code ... IMHO, these tricky cases should be solved by a change in the Info file format Yes, I agree, as we've discussed before. We shouldn't make complicated rules about when colons are acceptable and when they're not, according to the regexp du jour. Instead, we should just support everything. Until that glorious day arrives, I'm not worried about discrepancies between emacs-info and standalone-info in this regard. I don't see any need to document exactly which cases work and which don't in which reader, since it all changes from version to version anyway. Thanks, karl