wp/xed
1
0
Fork 0
Code Issues Pull Requests Projects Releases 1 Wiki Activity

Renamed Xedit -> Xed (avoid name clash with x11-apps's xedit)

Browse Source
This commit is contained in:
Clement Lefebvre
2016-02-04 09:20:42 +00:00
parent c8dd785ea8
commit 16eacdc3f4
487 changed files with 104410 additions and 104432 deletions
Download Patch File Download Diff File Expand all files Collapse all files

204
help/C/index.docbook
View File

@@ -4,7 +4,7 @@
<!ENTITY appversion "1.10">
<!ENTITY manrevision "3.0">
<!ENTITY date "July 2015">
<!ENTITY app "xedit">
<!ENTITY app "xed">
]>
<!-- =============Document Header ============================= -->
@@ -23,7 +23,7 @@
<!-- Remember to remove the &manrevision; entity from the revision entries other
than the current revision. -->
<revision>
<revnumber>xedit V1.0</revnumber>
<revnumber>xed V1.0</revnumber>
<date>2000</date>
<revdescription>
<para role="author">Eric Baudais <email>baudais@okstate.edu</email>
@@ -32,7 +32,7 @@
</revdescription>
</revision>
<revision>
<revnumber>xedit Manual V2.0</revnumber>
<revnumber>xed Manual V2.0</revnumber>
<date>March 2002</date>
<revdescription>
<para role="author">Sun GNOME Documentation Team</para>
@@ -40,7 +40,7 @@
</revdescription>
</revision>
<revision>
<revnumber>xedit Manual V2.1</revnumber>
<revnumber>xed Manual V2.1</revnumber>
<date>June 2002</date>
<revdescription>
<para role="author">Sun GNOME Documentation Team</para>
@@ -48,7 +48,7 @@
</revdescription>
</revision>
<revision>
<revnumber>xedit Manual V2.2</revnumber>
<revnumber>xed Manual V2.2</revnumber>
<date>August 2002</date>
<revdescription>
<para role="author">Sun GNOME Documentation Team</para>
@@ -56,7 +56,7 @@
</revdescription>
</revision>
<revision>
<revnumber>xedit Manual V2.3</revnumber>
<revnumber>xed Manual V2.3</revnumber>
<date>September 2002</date>
<revdescription>
<para role="author">Sun GNOME Documentation Team</para>
@@ -64,7 +64,7 @@
</revdescription>
</revision>
<revision>
<revnumber>xedit Manual V2.4</revnumber>
<revnumber>xed Manual V2.4</revnumber>
<date>January 2003</date>
<revdescription>
<para role="author">Sun GNOME Documentation Team</para>
@@ -72,7 +72,7 @@
</revdescription>
</revision>
<revision>
<revnumber>xedit Manual V2.5</revnumber>
<revnumber>xed Manual V2.5</revnumber>
<date>March 2003</date>
<revdescription>
<para role="author">Sun GNOME Documentation Team</para>
@@ -80,7 +80,7 @@
</revdescription>
</revision>
<revision>
<revnumber>xedit Manual V2.6</revnumber>
<revnumber>xed Manual V2.6</revnumber>
<date>September 2003</date>
<revdescription>
<para role="author">Sun GNOME Documentation Team</para>
@@ -88,7 +88,7 @@
</revdescription>
</revision>
<revision>
<revnumber>xedit Manual V2.7</revnumber>
<revnumber>xed Manual V2.7</revnumber>
<date>March 2004</date>
<revdescription>
<para role="author">Sun GNOME Documentation Team</para>
@@ -123,27 +123,27 @@
<releaseinfo> This manual describes version &appversion; of &app;.
</releaseinfo>
</articleinfo>
<indexterm><primary>xedit</primary></indexterm>
<indexterm><primary>xed</primary></indexterm>
<indexterm><primary>text editor</primary></indexterm>
<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<sect1 id="xedit-intro">
<sect1 id="xed-intro">
<title>Introduction</title>
<!-- removed ids, here as anchors to prevent possible breakage -->
<anchor id="xedit-customize-toolbar"/>
<anchor id="xed-customize-toolbar"/>
<para>The <application>&app;</application> application enables you to create and edit text files.</para>
<para>The aim of <application>&app;</application> is to be a simple and easy to use text editor. More powerful features can be enabled with different <firstterm>plugins</firstterm>, allowing a variety of tasks related to text-editing.</para>
</sect1>
<!-- ============= Getting Started =========================== -->
<sect1 id="xedit-getting-started">
<sect1 id="xed-getting-started">
<title>Getting Started</title>
<!-- ============= To Start xedit ============================ -->
<sect2 id="xedit-to-start">
<!-- ============= To Start xed ============================ -->
<sect2 id="xed-to-start">
<title>Starting &app;</title>
<para>You can start <application>&app;</application> in the following ways:</para>
<variablelist>
@@ -156,26 +156,26 @@
<varlistentry>
<term>Command line</term>
<listitem>
<para>Execute the following command: <command>xedit</command></para>
<para>Execute the following command: <command>xed</command></para>
</listitem>
</varlistentry>
</variablelist>
<para>By default, when you open a text document in the file manager, xedit will start, and display the document.</para>
<para>By default, when you open a text document in the file manager, xed will start, and display the document.</para>
</sect2>
<sect2 id="xedit-when-you-start">
<sect2 id="xed-when-you-start">
<title>The &app; Window</title>
<para>When you start <application>&app;</application>, the following window is displayed:</para>
<figure id="xedit-window">
<figure id="xed-window">
<title>&app; Window</title>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="figures/xedit_window.png" format="PNG"/>
<imagedata fileref="figures/xed_window.png" format="PNG"/>
</imageobject>
<textobject> <phrase>Shows xedit main window.</phrase>
<textobject> <phrase>Shows xed main window.</phrase>
</textobject>
</mediaobject>
</screenshot>
@@ -229,37 +229,37 @@
</sect2>
<!-- ============= To Open Multiple Files from the Command Line ========= -->
<sect2 id="xedit-run-from-cmd-line">
<sect2 id="xed-run-from-cmd-line">
<title>Running &app; from a Command Line</title>
<para>You can run <application>&app;</application> from a command line and open a single file or multiple files. To open multiple files from a command line, type the following command, then press <keycap>Return</keycap>:</para>
<para><command>xedit <replaceable>file1.txt file2.txt file3.txt</replaceable></command></para>
<para><command>xed <replaceable>file1.txt file2.txt file3.txt</replaceable></command></para>
<para>Alternatively, you can specify a URI instead of a filename.</para>
<para>For more information on how to run <application>&app;</application> from a command line, see the unix manual page for &app;, <ulink url="man:xedit" type="man"><citerefentry><refentrytitle>&app;</refentrytitle><manvolnum>1</manvolnum></citerefentry></ulink>.</para>
<para>For more information on how to run <application>&app;</application> from a command line, see the unix manual page for &app;, <ulink url="man:xed" type="man"><citerefentry><refentrytitle>&app;</refentrytitle><manvolnum>1</manvolnum></citerefentry></ulink>.</para>
</sect2>
</sect1>
<!-- ================ Usage ================================ -->
<sect1 id="xedit-usage">
<sect1 id="xed-usage">
<title>Working with Files</title>
<!-- ============= To Create a New File ======================== -->
<sect2 id="xedit-create-new-file">
<sect2 id="xed-create-new-file">
<title>Creating a New Document</title>
<para>To create a new document, choose <menuchoice><guimenu>File</guimenu><guimenuitem>New</guimenuitem></menuchoice>. The application displays a new blank document in the <application>&app;</application> window.</para>
</sect2>
<!-- ============= To Open a File ============================= -->
<sect2 id="xedit-open-file">
<sect2 id="xed-open-file">
<title>Opening a File</title>
<para>To open a file, choose <menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice> to display the <guilabel>Open File</guilabel> dialog. Select the file that you want to open, then click <guibutton>Open</guibutton>. The file is displayed in the <application>&app;</application> window. </para>
<para>The application records the paths and filenames of the five most recent files that you edited and displays the files as menu items on the <menuchoice><guimenu>File</guimenu></menuchoice> menu. You can also click on the <inlinemediaobject><imageobject><imagedata fileref="figures/xedit_recent_files_menu_icon.png" format="PNG"/></imageobject><textobject><phrase>Shows Recent Files menu icon.</phrase></textobject></inlinemediaobject> icon on the toolbar to display the list of recent files. </para>
<para>The application records the paths and filenames of the five most recent files that you edited and displays the files as menu items on the <menuchoice><guimenu>File</guimenu></menuchoice> menu. You can also click on the <inlinemediaobject><imageobject><imagedata fileref="figures/xed_recent_files_menu_icon.png" format="PNG"/></imageobject><textobject><phrase>Shows Recent Files menu icon.</phrase></textobject></inlinemediaobject> icon on the toolbar to display the list of recent files. </para>
<note><para>You can open multiple files in <application>&app;</application>. The application adds a tab for each open file to the window. For more on this see <xref linkend="xedit-tabs"/>.</para></note>
<note><para>You can open multiple files in <application>&app;</application>. The application adds a tab for each open file to the window. For more on this see <xref linkend="xed-tabs"/>.</para></note>
</sect2>
<!-- ============= To Save a File ============================== -->
<sect2 id="xedit-save-file">
<sect2 id="xed-save-file">
<title>Saving a File</title>
<para>You can save files in the following ways:</para>
<itemizedlist>
@@ -274,7 +274,7 @@
</sect2>
<!-- ============= To Open a File from a URI ======================= -->
<sect2 id="xedit-open-from-uri">
<sect2 id="xed-open-from-uri">
<title>Opening a File from a URI</title>
<para>To open a file from a Uniform Resource Identifier (URI), perform the following steps:</para>
<orderedlist>
@@ -296,7 +296,7 @@
</sect2>
<!-- ============= Working with tabs ======================== -->
<sect2 id="xedit-tabs">
<sect2 id="xed-tabs">
<title>Working With Tabs</title>
<para>When more than one file is open, <application>&app;</application> shows a <firstterm>tab</firstterm> for each document above the display area. To switch to another document, click on its tab.</para>
@@ -310,7 +310,7 @@
<title>Working with Text</title>
<!-- ============= To Edit Text ================================ -->
<sect2 id="xedit-edit-text">
<sect2 id="xed-edit-text">
<title>Editing Text</title>
<para>You can edit the text of a file in the following ways:</para>
<itemizedlist>
@@ -329,26 +329,26 @@
</itemizedlist>
</sect2>
<!-- ============== To Undo or Redo Edits ====================== -->
<sect2 id="xedit-undo-redo-edits">
<sect2 id="xed-undo-redo-edits">
<title>Undoing and Redoing Changes</title>
<para>To undo a change you have made, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Undo</guimenuitem> </menuchoice>. To reverse this action, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Redo</guimenuitem> </menuchoice>.</para>
</sect2>
</sect1>
<sect1 id="xedit-find">
<sect1 id="xed-find">
<title>Finding and Replacing</title>
<para>In <application>&app;</application>, there are two ways of searching for text. You can use the <guilabel>Find</guilabel> dialog to search for a specific piece of text, or <guilabel>Incremental Search</guilabel> to highlight matching text as you type it.
</para>
<!-- ============= To Find Text ================================ -->
<sect2 id="xedit-find-text">
<sect2 id="xed-find-text">
<title>Finding Text</title>
<para>To search a file for a string of text, perform the following steps:</para>
<orderedlist>
<listitem><para>Choose <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Find</guimenuitem> </menuchoice> to display the <guilabel>Find</guilabel> dialog.</para>
</listitem>
<listitem><para>Type the string that you want to find in the <guilabel>Search for</guilabel> field. You can include special characters such as a new line or tab: see <xref linkend="xedit-find-escapes"/>.</para>
<listitem><para>Type the string that you want to find in the <guilabel>Search for</guilabel> field. You can include special characters such as a new line or tab: see <xref linkend="xed-find-escapes"/>.</para>
</listitem>
<listitem><para>Click <guibutton>Find</guibutton> to search the file for the first occurrence of the string after your current cursor position. If <application>&app;</application> finds the string, the application selects first occurrence of the string. Other occurrences of the string are highlighted.</para>
</listitem>
@@ -359,7 +359,7 @@
<para>To remove the highlighting from the text, choose <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Clear Highlight</guimenuitem> </menuchoice>.</para>
</sect2>
<sect2 id="xedit-find-incremental">
<sect2 id="xed-find-incremental">
<title>Incremental Search</title>
<para>Incremental search highlights matching text in the document as you type it letter by letter. (This is similar to the search feature in several web browsers.)</para>
@@ -370,14 +370,14 @@
</sect2>
<!-- ============= To Find and Replace Text =================== -->
<sect2 id="xedit-find-replace-text">
<sect2 id="xed-find-replace-text">
<title>Replacing Text</title>
<para>To search a file for a string, and replace the string with an alternative string, perform the following steps:</para>
<orderedlist>
<listitem><para>Choose <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Replace</guimenuitem> </menuchoice> to display the <guilabel>Replace</guilabel> dialog.</para>
</listitem>
<listitem><para>Type the string that you want to find, in the <guilabel>Search for</guilabel> field. You can include special characters such as a new line or tab: see <xref linkend="xedit-find-escapes"/>.</para></listitem>
<listitem><para>Type the string that you want to find, in the <guilabel>Search for</guilabel> field. You can include special characters such as a new line or tab: see <xref linkend="xed-find-escapes"/>.</para></listitem>
<listitem><para>Type the string that you want to use to replace the string that you find, in the <guilabel>Replace with</guilabel> field.</para>
</listitem>
</orderedlist>
@@ -387,7 +387,7 @@
</sect2>
<!-- ============= Find and Replace Options ============================ -->
<sect2 id="xedit-find-options">
<sect2 id="xed-find-options">
<title>Find and Replace Options</title>
<para>The <guilabel>Find</guilabel> dialog and the <guilabel>Replace</guilabel> dialog both have the following options:</para>
<itemizedlist>
@@ -403,7 +403,7 @@
</sect2>
<!-- ============= Special Characters ============================ -->
<sect2 id="xedit-find-escapes">
<sect2 id="xed-find-escapes">
<title>Special Characters</title>
<para>You can include the following escape sequences in the text to find or replace to represent special characters:</para>
<variablelist>
@@ -439,7 +439,7 @@
</sect2>
<!-- ============= To Position the Cursor on a Specific Line ======================= -->
<sect2 id="xedit-goto-line">
<sect2 id="xed-goto-line">
<title>Positioning the Cursor on a Specific Line</title>
<para>To position the cursor on a specific line in the current file, choose <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Go to Line</guimenuitem> </menuchoice>. The line number box appears at the top of the display area.</para>
@@ -449,23 +449,23 @@
</sect1>
<sect1 id="xedit-printing">
<sect1 id="xed-printing">
<title>Printing</title>
<!-- ============= To Set the Page Options ============================ -->
<sect2 id="xedit-page-setup">
<sect2 id="xed-page-setup">
<title>Setting the Page Options</title>
<para>To set the page options, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Page Setup</guimenuitem> </menuchoice> to display the <guilabel>Page Setup</guilabel> dialog.</para>
<para>The <guilabel>Page Setup</guilabel> dialog enables you to specify the following print options:</para>
<sect3 id="xedit-page-setup-general">
<sect3 id="xed-page-setup-general">
<title>General Tabbed Section</title>
<variablelist>
<varlistentry> <term><guilabel>Print syntax highlighting</guilabel> </term>
<listitem>
<para>Select this option to print syntax highlighting. For more information about syntax highlighting, see <xref linkend="xedit-set-highlightmode"/>. </para>
<para>Select this option to print syntax highlighting. For more information about syntax highlighting, see <xref linkend="xed-set-highlightmode"/>. </para>
</listitem>
</varlistentry>
<varlistentry> <term><guilabel>Print page headers</guilabel> </term>
@@ -491,7 +491,7 @@
</variablelist>
</sect3>
<sect3 id="xedit-page-setup-fonts">
<sect3 id="xed-page-setup-fonts">
<title>Fonts</title>
<variablelist>
<varlistentry> <term><guilabel>Body</guilabel> </term>
@@ -517,7 +517,7 @@
</sect2>
<!-- ============= To Print a File ============================ -->
<sect2 id="xedit-print-file">
<sect2 id="xed-print-file">
<title>Printing a Document</title>
<para>You can use <application>&app;</application> to perform the following print operations:</para>
<itemizedlist>
@@ -700,13 +700,13 @@
</sect1>
<sect1 id="xedit-programming-features">
<sect1 id="xed-programming-features">
<title>Programming Features</title>
<para>Several of <application>&app;</application>'s features for programming are provided with plugins. For example, the Tag List plugin provides a list of commonly-used tags for different markup languages: see <xref linkend="xedit-tag-list-plugin"/>.</para>
<para>Several of <application>&app;</application>'s features for programming are provided with plugins. For example, the Tag List plugin provides a list of commonly-used tags for different markup languages: see <xref linkend="xed-tag-list-plugin"/>.</para>
<!-- ============= Syntax Highlighting =================== -->
<sect2 id="xedit-set-highlightmode">
<sect2 id="xed-set-highlightmode">
<title>Syntax Highlighting</title>
<para>Syntax highlighting makes source code easier to read by showing different parts of the text in different colors.</para>
@@ -746,16 +746,16 @@
</sect2>
<!-- ============= To Pipe the Output of a Command to a File ======= -->
<sect2 id="xedit-pipe-output">
<sect2 id="xed-pipe-output">
<title>Piping the Output of a Command to a File</title>
<para>You can use <application>&app;</application> to pipe the output of a command to a text file. For example, to pipe the output of an <command>ls</command> command to a text file, type <command>ls | xedit</command>, then press <keycap>Return</keycap>.</para>
<para>You can use <application>&app;</application> to pipe the output of a command to a text file. For example, to pipe the output of an <command>ls</command> command to a text file, type <command>ls | xed</command>, then press <keycap>Return</keycap>.</para>
<para>The output of the <command>ls</command> command is displayed in a new text file in the <application>&app;</application> window.</para>
<para>Alternatively, you can use the <application>External tools</application> plugin to pipe command output to the current file. <!-- fixme: xref needed! --></para>
</sect2>
</sect1>
<!-- ================ Shortcut Keys ============================= -->
<sect1 id="xedit-shortcutkeys">
<sect1 id="xed-shortcutkeys">
<title>Shortcut Keys</title>
<para>Use shortcut keys to perform common tasks more quickly than with the mouse and menus. The following tables list all of <application>&app;</application>'s shortcut keys.</para>
@@ -853,7 +853,7 @@
</row>
<row valign="top">
<entry><para>Ctrl + Q</para></entry>
<entry><para>Quit Xedit.</para></entry>
<entry><para>Quit Xed.</para></entry>
</row>
</tbody>
</tgroup>
@@ -1062,18 +1062,18 @@
<!-- ============= Preferences ============================= -->
<sect1 id="xedit-prefs">
<sect1 id="xed-prefs">
<title>Preferences</title>
<para>To configure <application>&app;</application>, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice>. The <guilabel>Preferences</guilabel> dialog contains the following categories:</para>
<itemizedlist>
<listitem><para><xref linkend="xedit-prefs-view"/></para></listitem>
<listitem><para><xref linkend="xedit-prefs-editor"/></para></listitem>
<listitem><para><xref linkend="xedit-prefs-fontsandcolors"/></para></listitem>
<listitem><para><xref linkend="xedit-prefs-plugins"/></para></listitem>
<listitem><para><xref linkend="xed-prefs-view"/></para></listitem>
<listitem><para><xref linkend="xed-prefs-editor"/></para></listitem>
<listitem><para><xref linkend="xed-prefs-fontsandcolors"/></para></listitem>
<listitem><para><xref linkend="xed-prefs-plugins"/></para></listitem>
</itemizedlist>
<sect2 id="xedit-prefs-view">
<sect2 id="xed-prefs-view">
<title>View Preferences</title>
<variablelist>
<varlistentry>
@@ -1112,7 +1112,7 @@
</variablelist>
</sect2>
<sect2 id="xedit-prefs-editor">
<sect2 id="xed-prefs-editor">
<title>Editor Preferences</title>
<variablelist>
<varlistentry>
@@ -1138,7 +1138,7 @@
</variablelist>
</sect2>
<sect2 id="xedit-prefs-fontsandcolors">
<sect2 id="xed-prefs-fontsandcolors">
<title>Font &amp; Colors Preferences</title>
<variablelist>
<varlistentry>
@@ -1191,12 +1191,12 @@
</variablelist>
</sect2>
<sect2 id="xedit-prefs-plugins">
<sect2 id="xed-prefs-plugins">
<title>Plugins Preferences</title>
<para>Plugins add extra features to <application>&app;</application>. For more information on plugins and how to use the built-in plugins, see <xref linkend="xedit-plugins-overview"/>.</para>
<para>Plugins add extra features to <application>&app;</application>. For more information on plugins and how to use the built-in plugins, see <xref linkend="xed-plugins-overview"/>.</para>
<!-- ============= To Load xedit Plugins ========================= -->
<sect3 id="xedit-install-plugins">
<!-- ============= To Load xed Plugins ========================= -->
<sect3 id="xed-install-plugins">
<title>Enabling a Plugin</title>
<para>To enable a <application>&app;</application> plugin, perform the following steps:</para>
<orderedlist>
@@ -1215,8 +1215,8 @@
</orderedlist>
</sect3>
<!-- ============= To Remove xedit Plugins ========================= -->
<sect3 id="xedit-remove-plugins">
<!-- ============= To Remove xed Plugins ========================= -->
<sect3 id="xed-remove-plugins">
<title>Disabling a Plugin</title>
<para>A plugin remains enabled when you quit <application>&app;</application>. </para>
<para>To disable a <application>&app;</application> plugin, perform the following steps:</para>
@@ -1238,52 +1238,52 @@
</sect2>
</sect1>
<!-- ============= To Use the xedit Plugins ========================= -->
<sect1 id="xedit-plugins">
<!-- ============= To Use the xed Plugins ========================= -->
<sect1 id="xed-plugins">
<title>Plugins</title>
<sect2 id="xedit-plugins-overview">
<sect2 id="xed-plugins-overview">
<title>Working with Plugins</title>
<para>You can add extra features to <application>&app;</application> by enabling <firstterm>plugins</firstterm>. A plugin is a supplementary program that enhances the functionality of an application. Plugins add new items to the <application>&app;</application> menus for the new features they provide.
</para>
<para>Several plugins come built-in with <application>&app;</application>, and you can install more. The <ulink type="http" url="http://live.gnome.org/Xedit/Plugins">xedit website</ulink> lists third-party plugins.</para>
<para>To enable and disable plugins, or see which plugins are currently enabled, use the <link linkend="xedit-prefs-plugins">Plugins Preferences</link>.</para>
<para>Several plugins come built-in with <application>&app;</application>, and you can install more. The <ulink type="http" url="http://live.gnome.org/Xed/Plugins">xed website</ulink> lists third-party plugins.</para>
<para>To enable and disable plugins, or see which plugins are currently enabled, use the <link linkend="xed-prefs-plugins">Plugins Preferences</link>.</para>
<para>The following plugins come built-in with <application>&app;</application>:</para>
<!-- Not yet documented:
File browser
-->
<itemizedlist>
<listitem>
<para><link linkend="xedit-change-case-plugin"><application>Change Case</application></link> allows you to change the case of the selected text.</para>
<para><link linkend="xed-change-case-plugin"><application>Change Case</application></link> allows you to change the case of the selected text.</para>
</listitem>
<listitem>
<para><application><link linkend="xedit-document-statistics-plugin">Document Statistics</link></application> shows the number of lines, words, and characters in the document. </para>
<para><application><link linkend="xed-document-statistics-plugin">Document Statistics</link></application> shows the number of lines, words, and characters in the document. </para>
</listitem>
<listitem>
<para><application><!-- <link linkend="xedit-file-browser-plugin">File Browser</link>-->File Browser</application> allows you to browse your files and folders in the side pane.</para>
<para><application><!-- <link linkend="xed-file-browser-plugin">File Browser</link>-->File Browser</application> allows you to browse your files and folders in the side pane.</para>
</listitem>
<listitem>
<para><application><link linkend="xedit-indent-lines-plugin">Indent Lines</link></application> adds or removes indentation from the selected lines.</para>
<para><application><link linkend="xed-indent-lines-plugin">Indent Lines</link></application> adds or removes indentation from the selected lines.</para>
</listitem>
<listitem>
<para><application><link linkend="xedit-insert-date-time-plugin">Insert Date/Time</link></application> adds the current date and time into a document.</para>
<para><application><link linkend="xed-insert-date-time-plugin">Insert Date/Time</link></application> adds the current date and time into a document.</para>
</listitem>
<listitem>
<para><application><link linkend="xedit-modelines-plugin">Modelines</link></application> allows you to set editing preferences for individual documents, and supports <application>Emacs</application>, <application>Kate</application> and <application>Vim</application>-style modelines.</para>
<para><application><link linkend="xed-modelines-plugin">Modelines</link></application> allows you to set editing preferences for individual documents, and supports <application>Emacs</application>, <application>Kate</application> and <application>Vim</application>-style modelines.</para>
</listitem>
<listitem>
<para><application><link linkend="xedit-sort-plugin">Sort</link></application> arranges selected lines of text into alphabetical order.</para>
<para><application><link linkend="xed-sort-plugin">Sort</link></application> arranges selected lines of text into alphabetical order.</para>
</listitem>
<listitem>
<para><application><link linkend="xedit-spell-checker-plugin">Spell Checker</link></application> corrects the spelling in the selected text, or marks errors automatically in the document.</para>
<para><application><link linkend="xed-spell-checker-plugin">Spell Checker</link></application> corrects the spelling in the selected text, or marks errors automatically in the document.</para>
</listitem>
<listitem>
<para><application><link linkend="xedit-tag-list-plugin">Tag List</link></application> lets you insert commonly-used tags for HTML and other languages from a list in the side pane.</para>
<para><application><link linkend="xed-tag-list-plugin">Tag List</link></application> lets you insert commonly-used tags for HTML and other languages from a list in the side pane.</para>
</listitem>
</itemizedlist>
</sect2>
<sect2 id="xedit-change-case-plugin">
<sect2 id="xed-change-case-plugin">
<title>Change Case Plugin</title>
<para>The <application>Change Case</application> plugin changes the case of the selected text.</para>
<para>The following items are added to the <guimenu>Edit</guimenu> menu when the <application>Change Case</application> plugin is enabled:</para>
@@ -1334,7 +1334,7 @@
</sect2>
<sect2 id="xedit-document-statistics-plugin">
<sect2 id="xed-document-statistics-plugin">
<title>Document Statistics Plugin</title>
<para>The <application>Document Statistics</application> plugin counts the number of lines, words, characters with spaces, characters without spaces, and bytes in the current file. The plugin displays the results in a <guilabel>Document Statistics</guilabel> dialog. To use the Document Statistics plugin, perform the following steps:</para>
<orderedlist>
@@ -1364,28 +1364,28 @@
</orderedlist>
</sect2>
<sect2 id="xedit-file-browser-plugin">
<sect2 id="xed-file-browser-plugin">
<title>File Browser Plugin</title>
<para>The <application>File Browser</application> Plugin shows your files and folders in the side pane, allowing you to quickly open files.</para>
<para>To view the File Browser, choose <menuchoice><guimenu>View</guimenu> <guimenuitem>Side Pane</guimenuitem> </menuchoice> and then click on the tab showing the File Browser icon at the bottom of the side pane.</para>
<sect3 id="xedit-file-browser-plugin-browsing">
<sect3 id="xed-file-browser-plugin-browsing">
<title>Browsing your Files</title>
<para>The File Browser tab initially shows your file manager bookmarks. To browse the contents of any item, double-click it.</para>
<para>To show a parent folder, choose from the drop-down list, or press the up arrow on the File Browser's toolbar.</para>
<para>To show the folder that contains the document you are currently working on, right-click in the file list and choose <guimenuitem>Set root to active document</guimenuitem>.</para>
</sect3>
<sect3 id="xedit-file-browser-plugin-open">
<sect3 id="xed-file-browser-plugin-open">
<title>Opening a File</title>
<para>To open a file in <application>&app;</application>, double-click it in the file list.</para>
</sect3>
<sect3 id="xedit-file-browser-plugin-create">
<sect3 id="xed-file-browser-plugin-create">
<title>Creating Files and Folders</title>
<para>To create a new, empty text file in the current folder shown in the browser, right-click in the file list and choose <guimenuitem>New File</guimenuitem>.</para>
<para>To create a new folder in the current folder shown in the browser, right-click in the file list and choose <guimenuitem>New Folder</guimenuitem>.</para>
</sect3>
</sect2>
<sect2 id="xedit-indent-lines-plugin">
<sect2 id="xed-indent-lines-plugin">
<title>Indent Lines Plugin</title>
<para>The <application>Indent Lines</application> plugin adds or removes space from the beginning of lines of text.</para>
<para>To indent or unindent text, perform the following steps:</para>
@@ -1403,11 +1403,11 @@
</itemizedlist>
</listitem>
</orderedlist>
<para>The amount of space used, and whether tab character or space characters are used, depends on the <guilabel>Tab Stops</guilabel> settings in the Editor Preferences: see <xref linkend="xedit-prefs-editor"/>.</para>
<para>The amount of space used, and whether tab character or space characters are used, depends on the <guilabel>Tab Stops</guilabel> settings in the Editor Preferences: see <xref linkend="xed-prefs-editor"/>.</para>
</sect2>
<sect2 id="xedit-insert-date-time-plugin">
<sect2 id="xed-insert-date-time-plugin">
<title>Insert Date/Time Plugin</title>
<para>The <application>Insert Date/Time</application> plugin inserts the current date and time into a document. To use the Insert Date/Time plugin, perform the following steps:</para>
<orderedlist>
@@ -1417,7 +1417,7 @@
</listitem>
</orderedlist>
<sect3 id="xedit-date-time-configure">
<sect3 id="xed-date-time-configure">
<title>Configuring the Insert Date/Time Plugin</title>
<para>To configure the Insert Date/Time plugin, perform the following steps:</para>
<orderedlist>
@@ -1455,7 +1455,7 @@
</sect3>
</sect2>
<sect2 id="xedit-modelines-plugin">
<sect2 id="xed-modelines-plugin">
<title>Modelines Plugin</title>
<para>The <application>Modelines</application> plugin allows you to set preferences for individual documents. A <firstterm>modeline</firstterm> is a line of text at the start or end of the document with settings that <application>&app;</application> recognises.</para>
<para>Preferences set using modelines take precedence over the ones specified in the preference dialog.</para>
@@ -1480,24 +1480,24 @@
<para>The <application>Modelines</application> plugin supports a subset of the options used by other text editors <application>Emacs</application>, <application>Kate</application> and <application>Vim</application>.</para>
<sect3 id="xedit-modelines-plugin-emacs">
<sect3 id="xed-modelines-plugin-emacs">
<title>Emacs Modelines</title>
<para>The first two lines of a document are scanned for <application>Emacs</application> modelines.</para>
<para>The <application>Emacs</application> options for tab-width, indent-offset, indent-tabs-mode and autowrap are supported. For more information, see the <ulink type="http" url="http://www.delorie.com/gnu/docs/emacs/emacs_486.html">GNU Emacs Manual</ulink>.</para>
</sect3>
<sect3 id="xedit-modelines-plugin-kate">
<sect3 id="xed-modelines-plugin-kate">
<title>Kate Modelines</title>
<para>The first and last ten lines a document are scanned for <application>Kate</application> modelines.</para>
<para>The <application>Kate</application> options for tab-width, indent-width, space-indent, word-wrap and word-wrap-column are supported. For more information, see the <ulink type="http" url="http://www.kate-editor.org/article/katepart_modelines">Kate website</ulink>.</para>
</sect3>
<sect3 id="xedit-modelines-plugin-vim">
<sect3 id="xed-modelines-plugin-vim">
<title>Vim Modelines</title>
<para>The first and last three lines a document are scanned for <application>Vim</application> modelines.</para>
<para>The <application>Vim</application> options for et, expandtab, ts, tabstop, sw, shiftwidth, wrap, and textwidth are supported. For more information, see the <ulink type="http" url="http://vimdoc.sourceforge.net/htmldoc/options.html#modeline">Vim website</ulink>.</para>
</sect3>
</sect2>
<sect2 id="xedit-sort-plugin">
<sect2 id="xed-sort-plugin">
<title>Sort Plugin</title>
<para>The <application>Sort</application> plugin arranges selected lines of text into alphabetical order.</para>
<caution><para>You cannot undo the Sort operation, so you should save the file before performing the sort. To revert to the saved version of the file after the sort operation, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Revert</guimenuitem> </menuchoice>.
@@ -1534,7 +1534,7 @@
</orderedlist>
</sect2>
<sect2 id="xedit-spell-checker-plugin">
<sect2 id="xed-spell-checker-plugin">
<title>Spell Checker Plugin</title>
<para>The <application>Spell Checker</application> plugin checks the spelling in the selected text. You can configure <application>&app;</application> to check the spelling automatically, or you can check the spelling manually, in the specified language. The language setting, and the autocheck spelling properties, apply per document. To use the Spell checker plugin, perform the following steps:</para>
<orderedlist>
@@ -1589,7 +1589,7 @@
</orderedlist>
</sect2>
<sect2 id="xedit-tag-list-plugin">
<sect2 id="xed-tag-list-plugin">
<title>Tag List Plugin</title>
<para>The <application>Tag List</application> plugin allows you to insert common tags from a list in the side pane.</para>
<para>To use the Tag List plugin, perform the following steps:</para>