From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#8900: 24.0.50; please index mentioned coding systems in Emacs manual Date: Fri, 01 Jul 2011 20:52:46 +0300 Message-ID: <83pqltriq9.fsf@gnu.org> References: <246694EE605F4CE391A4FB9416853D98@us.oracle.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: dough.gmane.org 1309544228 30674 80.91.229.12 (1 Jul 2011 18:17:08 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 1 Jul 2011 18:17:08 +0000 (UTC) Cc: larsi@gnus.org, 8900@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Jul 01 20:17:04 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1QciH1-0007Pi-Vw for geb-bug-gnu-emacs@m.gmane.org; Fri, 01 Jul 2011 20:17:04 +0200 Original-Received: from localhost ([::1]:49865 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QciH0-0001lH-GN for geb-bug-gnu-emacs@m.gmane.org; Fri, 01 Jul 2011 14:17:02 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:39013) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qchto-0004lO-Sa for bug-gnu-emacs@gnu.org; Fri, 01 Jul 2011 13:53:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qchtn-0001nT-B2 for bug-gnu-emacs@gnu.org; Fri, 01 Jul 2011 13:53:04 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:40172) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qchtn-0001nO-0i for bug-gnu-emacs@gnu.org; Fri, 01 Jul 2011 13:53:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qchtl-0003Tj-W5; Fri, 01 Jul 2011 13:53:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 01 Jul 2011 17:53:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 8900 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: fixed Original-Received: via spool by 8900-submit@debbugs.gnu.org id=B8900.130954277313356 (code B ref 8900); Fri, 01 Jul 2011 17:53:01 +0000 Original-Received: (at 8900) by debbugs.gnu.org; 1 Jul 2011 17:52:53 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qchtc-0003TN-NO for submit@debbugs.gnu.org; Fri, 01 Jul 2011 13:52:53 -0400 Original-Received: from mtaout21.012.net.il ([80.179.55.169]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qchta-0003T7-WF for 8900@debbugs.gnu.org; Fri, 01 Jul 2011 13:52:52 -0400 Original-Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0LNO005000XYD000@a-mtaout21.012.net.il> for 8900@debbugs.gnu.org; Fri, 01 Jul 2011 20:52:44 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([84.228.8.216]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LNO005L31NUDQ00@a-mtaout21.012.net.il>; Fri, 01 Jul 2011 20:52:44 +0300 (IDT) In-reply-to: X-012-Sender: halo1@inter.net.il X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Fri, 01 Jul 2011 13:53:01 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:47714 Archived-At: > From: "Drew Adams" > Date: Fri, 1 Jul 2011 08:54:44 -0700 > Cc: 8900@debbugs.gnu.org > > > I think that should be sufficient for people who want to find these > > things in the index. > > I disagree. These are real, implementation, user-visible, runtime names. This > is just like indexing command names or variable names or package names. The > exact name should appear in the index. Not true, at least not until we have a detailed documentation of each encoding there. The absolute majority of coding-systems is not documented in the manual, so there's no real place to put the index entries. I'm not sure there's something intelligent to tell about these encodings in the manual, either. > Consider, for instance, the use case that brought this to my attention: You cannot assume that every symbol appears in the manual. So this feature can never work reliably, only ad-hoc. You should be prepared for the situation where the manual doesn't have this in its index, and handle that gracefully.