From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Documentation for "Clone Buffers" (corrected version) Date: 15 Mar 2004 08:46:02 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <200403141958.i2EJwRK01078@f7.net> <200403150314.i2F3Eex04973@raven.dms.auburn.edu> Reply-To: Eli Zaretskii NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1079333088 18604 80.91.224.253 (15 Mar 2004 06:44:48 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 15 Mar 2004 06:44:48 +0000 (UTC) Cc: acm@muc.de, emacs-devel@gnu.org, karl@freefriends.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Mon Mar 15 07:44:41 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1B2lq5-00018V-00 for ; Mon, 15 Mar 2004 07:44:41 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1B2lq5-0003b5-00 for ; Mon, 15 Mar 2004 07:44:41 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.30) id 1B2lps-0002Ga-Kh for emacs-devel@quimby.gnus.org; Mon, 15 Mar 2004 01:44:28 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1B2lpd-0002Db-L8 for emacs-devel@gnu.org; Mon, 15 Mar 2004 01:44:13 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1B2lp7-0001zW-KO for emacs-devel@gnu.org; Mon, 15 Mar 2004 01:44:12 -0500 Original-Received: from [207.232.27.5] (helo=WST0054) by monty-python.gnu.org with asmtp (Exim 4.30) id 1B2lp7-0001yZ-6a; Mon, 15 Mar 2004 01:43:41 -0500 Original-To: Luc Teirlinck In-reply-to: <200403150314.i2F3Eex04973@raven.dms.auburn.edu> (message from Luc Teirlinck on Sun, 14 Mar 2004 21:14:40 -0600 (CST)) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.4 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:20489 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:20489 > Date: Sun, 14 Mar 2004 21:14:40 -0600 (CST) > From: Luc Teirlinck > CC: acm@muc.de,eliz@elta.co.il,emacs-devel@gnu.org [Why was this taken off the Texinfo list?] > If your display supports multiple fonts, and you are using Emacs' > ! Info mode to read Info files, the third, sixth and ninth menu item > ! have a @samp{*} that stands out, either in color or in some other > ! attribute, such as underline; this makes it easy to see at a glance > ! which number to use for an item. The beginning of this sentence should be changed to something like If your display supports multiple fonts, colors, or underlining, ... > Some terminals don't support colors or underlining. And this sentence should also mention multiple fonts. > + @subheading @kbd{M-n} creates a new independent Info buffer in Emacs > + > + @kindex M-n @r{(Info mode)} > + @findex clone-buffer > + @cindex creating multiple Info buffers I suggest to drop "creating" from the last index entry. It doesn't add any useful information, while making the index entry longer. Also, an index entry that starts with "multiple" stands a better chance being useful with the `i' command, since a user who looks for this information is more likely to type "i multiple TAB" than "i creating TAB". In general, starting an index entry with a word that is too general is not a good idea, for this very reason.