From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Xue Fuqiao Newsgroups: gmane.emacs.devel Subject: Re: Index entry for Object Replacement Character Date: Wed, 6 Nov 2013 22:22:40 +0800 Message-ID: References: <83txfq7ms1.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 X-Trace: ger.gmane.org 1383747771 7998 80.91.229.3 (6 Nov 2013 14:22:51 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 6 Nov 2013 14:22:51 +0000 (UTC) Cc: emacs-devel To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Nov 06 15:22:58 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Ve40W-0005oU-U4 for ged-emacs-devel@m.gmane.org; Wed, 06 Nov 2013 15:22:57 +0100 Original-Received: from localhost ([::1]:34231 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ve40W-0007gT-HG for ged-emacs-devel@m.gmane.org; Wed, 06 Nov 2013 09:22:56 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43978) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ve40P-0007KJ-9c for emacs-devel@gnu.org; Wed, 06 Nov 2013 09:22:54 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Ve40N-0003pT-Uh for emacs-devel@gnu.org; Wed, 06 Nov 2013 09:22:49 -0500 Original-Received: from mail-we0-x22e.google.com ([2a00:1450:400c:c03::22e]:42228) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Ve40I-0003nJ-GY; Wed, 06 Nov 2013 09:22:42 -0500 Original-Received: by mail-we0-f174.google.com with SMTP id u56so5021715wes.33 for ; Wed, 06 Nov 2013 06:22:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=TRlHSxH7piDK1FZ6HjSHuiBBUsEJw/Eoy7kO0JiNncc=; b=ciSIdRVhQlyxW1oyrKnvAcWDoOe7aZI520eidZdRR91aA4i/a8p2P4MC8Z6Kfjo8xY r/a6Tu+Hq8c+Lu4kmOLK3JRvdHTLA6jw0YLzW5FoVMw7PYMMbtzmwidYDPdAWfOkHisw zrwmWABxALqhHt/ZS1EJ5CvsLHs7gOZPlyrTXATqxHsmES9CuQBZMJ/CKg+v9SmAHq+H Hb6Re7BhHtGqLYrjTC7/MlDNupXuW0uC5mZP5zCftctSBIWyTsnSwawUDz5dCoHiHH/b qThN0p1O54vlXlzk9Xa6VYmIo7S4havAWAVnDv4dTYf7SWrpS1RquuiO73c5M9moLiOX IHrQ== X-Received: by 10.180.231.6 with SMTP id tc6mr21710645wic.59.1383747760570; Wed, 06 Nov 2013 06:22:40 -0800 (PST) Original-Received: by 10.194.54.10 with HTTP; Wed, 6 Nov 2013 06:22:40 -0800 (PST) In-Reply-To: <83txfq7ms1.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2a00:1450:400c:c03::22e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:165004 Archived-At: On Wed, Nov 6, 2013 at 1:59 AM, Eli Zaretskii wrote: > I don't understand why you added an index entry for this. Can you > explain? > > Here's my take on this: Index entries exist to make it easier for the > reader to find the description/discussion of a subject. In this case, > the subject of the text where the Object Replacement Character is > reordering of display properties in bidirectional text. The fact that > the Emacs implementation treats text covered by a display property as > if it were a single character with the bidirectional properties of > u+FFFC is an implementation detail, mentioned by the way for those who > are interested enough to look up that character. The text does not > explain anything about that character, and doesn't say why it was > chosen for this role. The character is mentioned once, and that's it. > > Therefore, I find it hard to believe that any reader will thing about > this character's name as a good string to try at the prompt of the > Info's 'i' command. Likewise, I see no reason why someone who wants > to know about this character will look for its description in the ELisp > manual. So having this index entry there is not useful. > > More generally, not every term you see in a manual deserves an index > entry. It only does deserve an entry if (a) the term is described and > explained at that place, and (b) there's a high probability that > readers will think about the phrase you put in an index entry when > they are looking for the subject described at that place. Thanks, I agree with you. Sorry for the noise commit and I'll note that in the future. (I've reverted the change as trunk revision 115004.) -- http://www.gnu.org/software/emacs/