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: Sat, 02 Jul 2011 09:11:29 +0300 Message-ID: <83iprlqkj2.fsf@gnu.org> References: <246694EE605F4CE391A4FB9416853D98@us.oracle.com> <83pqltriq9.fsf@gnu.org> <9BB5F2A7090B4F2585512C563D1717B3@us.oracle.com> <83liwhrdc8.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: dough.gmane.org 1309587148 7946 80.91.229.12 (2 Jul 2011 06:12:28 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 2 Jul 2011 06:12:28 +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 Sat Jul 02 08:12:24 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 1QctRH-0007VO-El for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Jul 2011 08:12:23 +0200 Original-Received: from localhost ([::1]:45336 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QctRG-0000Fs-8U for geb-bug-gnu-emacs@m.gmane.org; Sat, 02 Jul 2011 02:12:22 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:59013) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QctR0-0000Fk-Am for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 02:12:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QctQw-0003zH-IS for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 02:12:06 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:34620) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QctQw-0003zB-FJ for bug-gnu-emacs@gnu.org; Sat, 02 Jul 2011 02:12:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QctQv-0007TI-Sz; Sat, 02 Jul 2011 02:12:01 -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: Sat, 02 Jul 2011 06:12: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.130958709628685 (code B ref 8900); Sat, 02 Jul 2011 06:12:01 +0000 Original-Received: (at 8900) by debbugs.gnu.org; 2 Jul 2011 06:11:36 +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 1QctQV-0007Sb-Sb for submit@debbugs.gnu.org; Sat, 02 Jul 2011 02:11:36 -0400 Original-Received: from mtaout22.012.net.il ([80.179.55.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QctQT-0007SP-Bt for 8900@debbugs.gnu.org; Sat, 02 Jul 2011 02:11:34 -0400 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0LNO00900ZMZV000@a-mtaout22.012.net.il> for 8900@debbugs.gnu.org; Sat, 02 Jul 2011 09:11:26 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([84.228.8.216]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LNO009Y2ZV1FKN0@a-mtaout22.012.net.il>; Sat, 02 Jul 2011 09:11:26 +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: Sat, 02 Jul 2011 02:12: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:47734 Archived-At: > From: "Drew Adams" > Cc: , <8900@debbugs.gnu.org> > Date: Fri, 1 Jul 2011 14:00:01 -0700 > > You need detailed doc about *each* coding system before you will index *any* of > them? I never said that. Some of them _are_ indexed: raw-text, no-conversion, and emacs-internal. That's because the manual says something specific about them, unlike the others. > > Having index entries about something that isn't described > > is a Bad Thing. > > "Described" is vague here, so it's hard to judge. Not really. The following is _not_ a description: For example, the coding system @code{iso-latin-1} has variants @code{iso-latin-1-unix}, @code{iso-latin-1-dos} and @code{iso-latin-1-mac}. This mentions iso-latin-1-*, but says nothing at all about them. The whole sentence is an explanation of the -dos, -unix, -mac variants of each coding-system, and uses iso-latin-1-* as an example. And there's no other reference to iso-latin-1-* anywhere in the manual. How hard is it to judge that these symbols are not documented in the manual? I say it's obvious. A reader who wants to know something about iso-latin-1 will not be wiser after reading this. > I do indexing for a living. Then I pity your readers.