Menu
▾
▴
[ jEdit-commits ] SF.net SVN: jedit:[13227] jEdit/trunk/doc/users-guide/basics.xml
|
From: <ez...@us...> - 2008-08-07 00:44:29
|
Revision: 13227
http://jedit.svn.sourceforge.net/jedit/?rev=13227&view=rev
Author: ezust
Date: 2008-08-07 00:44:27 +0000 (Thu, 07 Aug 2008)
Log Message:
-----------
Made the switching of bufferset scopes experimental in the docs.
Modified Paths:
--------------
jEdit/trunk/doc/users-guide/basics.xml
Modified: jEdit/trunk/doc/users-guide/basics.xml
===================================================================
--- jEdit/trunk/doc/users-guide/basics.xml 2008-08-07 00:38:21 UTC (rev 13226)
+++ jEdit/trunk/doc/users-guide/basics.xml 2008-08-07 00:44:27 UTC (rev 13227)
@@ -177,6 +177,9 @@
<sect1 id="buffersets">
<title>Buffer Sets</title>
+
+ <para> The buffer sets feature helps keep the buffer lists local and manageable when using
+ jEdit in a multiple-View and multiple-EditPane environment. </para>
<para> As mentioned in the previous section, each EditPane can show a Buffer Switcher, which
displays the contents of a BufferSet. In jEdit 4.2, all EditPane buffer switchers
@@ -185,27 +188,40 @@
the next/previous buffer actions useless with many views, EditPanes and buffers.
</para>
- <para> In jEdit 4.3, it is possible to have different scopes for the BufferSets of each EditPane. The three scopes are: </para>
+ <para> In jEdit 4.3, it is possible to have more narrow scopes for the BufferSets of an EditPane. This makes the 'next-buffer' and 'previous-buffer' actions switch between buffers that are local to the view or pane. </para>
+
+ <para>
+ The three BufferSet scopes are: </para>
+
<orderedlist>
- <listitem><para> <emphasis role="bold">Global</emphasis>: Includes all buffers open from any EditPane. </para></listitem>
- <listitem><para> <emphasis role="bold">View</emphasis>: EditPanes in the same View share the same
- BufferSet. Opening a buffer in one View will not affect the non-global scope BufferSets in EditPanes of other
- Views. </para></listitem>
- <listitem><para><emphasis role="bold">EditPane</emphasis>: Each EditPane can have its own independent BufferSet, although any buffers that are opened from it should also show up in the Global BufferSet..
- </para></listitem>
+ <listitem><para> <emphasis role="bold">Global</emphasis>: Includes all buffers open from any EditPane. </para></listitem>
+ <listitem><para> <emphasis role="bold">View</emphasis>: EditPanes in the same View share the same
+ BufferSet. Opening a buffer in one View will not affect the non-global scope BufferSets in EditPanes of
+ other Views. </para></listitem>
+ <listitem><para><emphasis role="bold">EditPane</emphasis>: Each EditPane can have its own independent
+ BufferSet.
+ </para></listitem>
</orderedlist>
<para> The default Buffer Set scope for newly created EditPanes is global by default, and can be
changed from <guimenu>Utilities</guimenu>><guimenuitem>Global Options</guimenuitem>
> <guimenuitem>View</guimenuitem> > <guilabel>BufferSet scope for new
EditPanes</guilabel>. </para>
-
-
+
<para> New BufferSets are initially empty, or populated with a copy of the
existing BufferSet. This behavior can be changed from
<guimenuitem>Global Options</guimenuitem> > <guimenuitem>View</guimenuitem> >
<guilabel>New BufferSets contain: copies of current BufferSet</guilabel>. </para>
+ <para> <guimenu>File</guimenu> > <guimenuitem>Close</guimenuitem> behavior has changed in 4.3pre15: now it will remove the current buffer from the EditPane's BufferSet only. If it
+ was the last BufferSet to contain that buffer, the buffer is also closed. </para>
+ <para> The <guimenu> File </guimenu> > <guimenuitem>Close (global)</guimenuitem> action closes the buffer in all EditPanes, as the regular <guimenu> File </guimenu> > <guimenuitem>Close</guimenuitem> action did before. </para>
+
+ <para> <guimenuitem>Clear BufferSet except active</guimenuitem> will clear the BufferSet of the
+ current EditPane by performing a <guimenuitem>Close</guimenuitem> on all items except those buffers which are displayed in another active EditPane. </para>
+
+ <bridgehead> Switching Bufferset Scopes at runtime (experimental) </bridgehead>
+
<para> The statusbar shows you which BufferSet scope is active for the current EditPane
(look for the letter "G", "E" or "V"). Double-clicking on that
will allow you to change the buffer set. Also, the scope for the current EditPane BufferSet can be changed from <guimenu>View</guimenu>><guimenu>Buffer Sets</guimenu> >
@@ -214,17 +230,9 @@
<para> A new BufferSet can be created in a number of ways, such as when a new
View is created (and the default BufferSet scope is not global) or when the
View is split (and the default BufferSet scope is EditPane), or when the
- BufferSet scope is changed to EditPane via the statusbar or menu action. </para>
-
- <para> <guimenu>File</guimenu> > <guimenuitem>Close</guimenuitem> behavior has changed in 4.3pre15: now it will remove the current buffer from the EditPane's BufferSet. If it
- was the last BufferSet to contain that buffer, the buffer is also closed. </para>
- <para> The <guimenu> File </guimenu> > <guimenuitem>Close (global)</guimenuitem> action closes the buffer in all EditPanes, as the regular <guimenu> File </guimenu> > <guimenuitem>Close</guimenuitem> action did before. </para>
-
- <para> <guimenuitem>Clear BufferSet except active</guimenuitem> will clear the BufferSet of the
- current EditPane by performing a <guimenuitem>Close</guimenuitem> on all items except those buffers which are displayed in another active EditPane. </para>
-
- <para> The buffer sets feature helps keep the buffer lists local and manageable when using
- jEdit in a multiple-View and multiple-EditPane environment. </para>
+ BufferSet scope is changed to EditPane via the statusbar or menu action. </para>
+
+
</sect1>
<sect1 id="docking">
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|