From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Luc Teirlinck Newsgroups: gmane.emacs.devel Subject: Re: Documentation for "Clone Buffers" (corrected version) Date: Sun, 14 Mar 2004 21:14:40 -0600 (CST) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200403150314.i2F3Eex04973@raven.dms.auburn.edu> References: <200403141958.i2EJwRK01078@f7.net> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1079322618 1384 80.91.224.253 (15 Mar 2004 03:50:18 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 15 Mar 2004 03:50:18 +0000 (UTC) Cc: acm@muc.de, eliz@elta.co.il, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Mon Mar 15 04:50:07 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 1B2j78-0004Py-00 for ; Mon, 15 Mar 2004 04:50:06 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1B2j78-0006Ou-00 for ; Mon, 15 Mar 2004 04:50:06 +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 1B2inb-0003je-7k for emacs-devel@quimby.gnus.org; Sun, 14 Mar 2004 22:29:55 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1B2ikG-0001a4-14 for emacs-devel@gnu.org; Sun, 14 Mar 2004 22:26:28 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1B2ijd-0001AU-5V for emacs-devel@gnu.org; Sun, 14 Mar 2004 22:26:20 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.30) id 1B2iaV-0006eZ-GT for emacs-devel@gnu.org; Sun, 14 Mar 2004 22:16:23 -0500 Original-Received: from raven.dms.auburn.edu (raven.dms.auburn.edu [131.204.53.29]) by manatee.dms.auburn.edu (8.12.10/8.12.10) with ESMTP id i2F3GAKt022715; Sun, 14 Mar 2004 21:16:10 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.6+Sun/8.11.6) id i2F3Eex04973; Sun, 14 Mar 2004 21:14:40 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: karl@freefriends.org In-reply-to: <200403141958.i2EJwRK01078@f7.net> (karl@freefriends.org) 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:20477 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:20477 Emacs Info now colors the third, sixth and ninth stars in a menu, instead of the fifth and ninth, so unless there are objections, I plan to apply the following patch whose only differences with the previous one are the @unnumberedsubsec vs @subheading change we agreed on and the *-coloring stuff: ===File ~/info-diff========================================= *** info.texi.~1.39.~ Mon Mar 8 18:17:14 2004 --- info.texi Sun Mar 14 18:36:11 2004 *************** *** 614,619 **** --- 614,624 ---- stands for the subtopic of the line you are on. You can also click the middle mouse button directly on the subtopic line to go there. + As a more advanced feature, if you type @kbd{C-u m}, everything + works exactly as if you just typed @kbd{m}, except that the command + goes to the node in a new independent Info buffer, which it selects in + another window. The current Info node remains visible in its window. + Here is a menu to give you a chance to practice. This menu gives you three ways of going to one place, Help-FOO: *************** *** 939,945 **** Here are some more Info commands that make it easier to move around. ! @unnumberedsubsec @kbd{g} goes to a node by name @kindex g @r{(Info mode)} @findex Info-goto-node --- 944,950 ---- Here are some more Info commands that make it easier to move around. ! @subheading @kbd{g} goes to a node by name @kindex g @r{(Info mode)} @findex Info-goto-node *************** *** 965,971 **** all of the current file by typing @kbd{g*@key{RET}} or all of any other file with @kbd{g(@var{filename})@key{RET}}. ! @unnumberedsubsec @kbd{1} -- @kbd{9} choose a menu subtopic by its number @kindex 1 @r{through} 9 @r{(Info mode)} @findex Info-nth-menu-item --- 970,976 ---- all of the current file by typing @kbd{g*@key{RET}} or all of any other file with @kbd{g(@var{filename})@key{RET}}. ! @subheading @kbd{1} -- @kbd{9} choose a menu subtopic by its number @kindex 1 @r{through} 9 @r{(Info mode)} @findex Info-nth-menu-item *************** *** 980,995 **** the digit keys run the command @code{Info-nth-menu-item}. If your display supports multiple fonts, and you are using Emacs' ! Info mode to read Info files, the @samp{*} for the fifth menu item ! stands out, either in color or in some other attribute, such as ! underline, and so is the @samp{*} for the ninth item; this makes it ! easy to see at a glance which number to use for an item. Some terminals don't support colors or underlining. If you need to actually count items, it is better to use @kbd{m} instead, and specify the name, or use @key{TAB} to quickly move between menu items. ! @unnumberedsubsec @kbd{e} makes Info document editable @kindex e @r{(Info mode)} @findex Info-edit --- 985,1000 ---- the digit keys run the command @code{Info-nth-menu-item}. 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. Some terminals don't support colors or underlining. If you need to actually count items, it is better to use @kbd{m} instead, and specify the name, or use @key{TAB} to quickly move between menu items. ! @subheading @kbd{e} makes Info document editable @kindex e @r{(Info mode)} @findex Info-edit *************** *** 1004,1009 **** --- 1009,1031 ---- edit the Info file, so typing @kbd{e} there goes to the end of the current node. + @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 + If you are reading Info in Emacs, you can select a new independent + Info buffer in another window by typing @kbd{M-n}. The new buffer + starts out as an exact copy of the old one, but you will be able to + move independently between nodes in the two buffers. (In Info mode, + @kbd{M-n} runs the Emacs command @code{clone-buffer}.) + + In Emacs Info, you can also produce new Info buffers by giving a + numeric prefix argument to the @kbd{m} and @kbd{g} commands. @kbd{C-u + m} and @kbd{C-u g} go to a new node in exactly the same way that + @kbd{m} and @kbd{g} do, but they do so in a new Info buffer which they + select in another window. + @node Info Search, Add, Advanced, Expert Info @comment node-name, next, previous, up @section How to search Info documents for specific subjects ============================================================