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: Mon, 15 Mar 2004 17:35:06 -0600 (CST) Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200403152335.i2FNZ6r13138@raven.dms.auburn.edu> References: <200403141958.i2EJwRK01078@f7.net> <200403150314.i2F3Eex04973@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1079394692 18369 80.91.224.253 (15 Mar 2004 23:51:32 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 15 Mar 2004 23:51:32 +0000 (UTC) Cc: acm@muc.de, karl@freefriends.org, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Tue Mar 16 00:51:25 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 1B31rh-0007kM-00 for ; Tue, 16 Mar 2004 00:51:25 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1B31rh-00037F-00 for ; Tue, 16 Mar 2004 00:51:25 +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 1B31hf-0001dT-GM for emacs-devel@quimby.gnus.org; Mon, 15 Mar 2004 18:41:03 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1B31fA-0000x5-EE for emacs-devel@gnu.org; Mon, 15 Mar 2004 18:38:28 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1B31dh-00008p-4R for emacs-devel@gnu.org; Mon, 15 Mar 2004 18:37:28 -0500 Original-Received: from [131.204.53.104] (helo=manatee.dms.auburn.edu) by monty-python.gnu.org with esmtp (Exim 4.30) id 1B31dV-0008OD-4K for emacs-devel@gnu.org; Mon, 15 Mar 2004 18:36:45 -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 i2FNaaKt006914; Mon, 15 Mar 2004 17:36:37 -0600 (CST) Original-Received: (from teirllm@localhost) by raven.dms.auburn.edu (8.11.6+Sun/8.11.6) id i2FNZ6r13138; Mon, 15 Mar 2004 17:35:06 -0600 (CST) X-Authentication-Warning: raven.dms.auburn.edu: teirllm set sender to teirllm@dms.auburn.edu using -f Original-To: eliz@elta.co.il In-reply-to: (message from Eli Zaretskii on 15 Mar 2004 08:46:02 +0200) 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:20514 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:20514 So what about the following version which incorporates your latest suggestions? ===File ~/info-diff========================================= *** info.texi.~1.39.~ Mon Mar 8 18:17:14 2004 --- info.texi Mon Mar 15 17:23:24 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 *************** *** 979,995 **** this is so you need not count how many entries are there. In Emacs, 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 --- 984,1001 ---- this is so you need not count how many entries are there. In Emacs, the digit keys run the command @code{Info-nth-menu-item}. ! If your display supports multiple fonts, colors or underlining, and ! you are using Emacs' Info mode to read Info files, the third, sixth ! and ninth menu items 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 either multiple fonts, 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 **** --- 1010,1032 ---- 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 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 ============================================================