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 22:49:11 +0300 Message-ID: <83liwhrdc8.fsf@gnu.org> References: <246694EE605F4CE391A4FB9416853D98@us.oracle.com> <83pqltriq9.fsf@gnu.org> <9BB5F2A7090B4F2585512C563D1717B3@us.oracle.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: dough.gmane.org 1309550516 2083 80.91.229.12 (1 Jul 2011 20:01:56 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 1 Jul 2011 20:01:56 +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 22:01:49 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 1QcjuO-0005tH-5Y for geb-bug-gnu-emacs@m.gmane.org; Fri, 01 Jul 2011 22:01:48 +0200 Original-Received: from localhost ([::1]:50826 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QcjuN-0003Nk-68 for geb-bug-gnu-emacs@m.gmane.org; Fri, 01 Jul 2011 16:01:47 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:41872) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qcjj7-00017U-2y for bug-gnu-emacs@gnu.org; Fri, 01 Jul 2011 15:50:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qcjj2-0002dy-UL for bug-gnu-emacs@gnu.org; Fri, 01 Jul 2011 15:50:08 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:41466) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qcjj2-0002dY-If for bug-gnu-emacs@gnu.org; Fri, 01 Jul 2011 15:50:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qcjj1-0007j8-A8; Fri, 01 Jul 2011 15:50:03 -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 19:50:03 +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.130954975829647 (code B ref 8900); Fri, 01 Jul 2011 19:50:03 +0000 Original-Received: (at 8900) by debbugs.gnu.org; 1 Jul 2011 19:49:18 +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 1QcjiH-0007i8-Hc for submit@debbugs.gnu.org; Fri, 01 Jul 2011 15:49:17 -0400 Original-Received: from mtaout22.012.net.il ([80.179.55.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QcjiF-0007hv-9w for 8900@debbugs.gnu.org; Fri, 01 Jul 2011 15:49:16 -0400 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0LNO004006S2WB00@a-mtaout22.012.net.il> for 8900@debbugs.gnu.org; Fri, 01 Jul 2011 22:49:09 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([84.228.8.216]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LNO004KU71VEBM0@a-mtaout22.012.net.il>; Fri, 01 Jul 2011 22:49:09 +0300 (IDT) In-reply-to: <9BB5F2A7090B4F2585512C563D1717B3@us.oracle.com> 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 15:50:03 -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:47719 Archived-At: > From: "Drew Adams" > Cc: , <8900@debbugs.gnu.org> > Date: Fri, 1 Jul 2011 11:17:23 -0700 > > > > 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. > > Doesn't matter that we don't have detailed doc about these. Certainly doesn't > matter that we don't have detailed doc about *each* coding system. Well, in that case, we will have to disagree. Having index entries about something that isn't described is a Bad Thing. > The fact is that the manual provides some information about these particular > coding systems. They should be indexed so users can easily find that > information. But there's no information to find. > An index does not refer only to "detailed documentation" about terms. It refers > to terms that we think a user is likely to look for in the book. It is often > the case that a term is indexed that is only mentioned in the book. Not in my book.