gedit-07-fix-doc.diff revision 20300
20292N/A--- gedit-2.30.4/help/C/gedit.xml.orig 2011-05-11 14:59:20.482788230 +0100
20292N/A+++ gedit-2.30.4/help/C/gedit.xml 2011-05-11 14:59:52.636853875 +0100
20292N/A+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
20292N/A- <para>To report a bug or make a suggestion regarding the <application>&app;</application> application or this manual, follow the directions in the <ulink url="ghelp:user-guide?feedback-bugs" type="help">GNOME Feedback Page</ulink>.
20292N/A+ <para>To report a bug or make a suggestion regarding the <application>gedit</application> application or this manual, follow the directions in the <ulink url="ghelp:user-guide?feedback-bugs" type="help">GNOME Feedback Page</ulink>.
20292N/A- <para>The <application>&app;</application> application enables you to create and edit text files.</para>
20292N/A+ <para>The <application>gedit</application> application enables you to create and edit text files.</para>
20292N/A- <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>
20292N/A+ <para>The aim of <application>gedit</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>
20292N/A- <para>When you start <application>&app;</application>, the following window is displayed:</para>
20292N/A+ <para>When you start <application>gedit</application>, the following window is displayed:</para>
20292N/A- <para>The menus on the menubar contain all of the commands you need to work with files in <application>&app;</application>.</para>
20292N/A+ <para>The menus on the menubar contain all of the commands you need to work with files in <application>gedit</application>.</para>
20292N/A- <para>The statusbar displays information about current <application>&app;</application> activity and contextual information about the menu items. The statusbar also displays the following information:</para>
20292N/A+ <para>The statusbar displays information about current <application>gedit</application> activity and contextual information about the menu items. The statusbar also displays the following information:</para>
20292N/A <para>Cursor position: the line number and column number where the cursor is located.</para>
20292N/A- <para>When you right-click in the <application>&app;</application> window, the application displays a popup menu. The popup menu contains the most common text editing commands. </para>
20292N/A+ <para>When you right-click in the <application>gedit</application> window, the application displays a popup menu. The popup menu contains the most common text editing commands. </para>
20292N/A- <para>Like other GNOME applications, actions in <application>&app;</application> can be performed in several ways: with the menu, with the toolbar, or with shortcut keys. Shortcuts keys common to all applications are listed in the <ulink type="help" url="ghelp:user-guide?shortcuts-apps">User Guide</ulink>.</para>
20292N/A+ <para>Like other GNOME applications, actions in <application>gedit</application> can be performed in several ways: with the menu, with the toolbar, or with shortcut keys. Shortcuts keys common to all applications are listed in the <ulink type="help" url="ghelp:user-guide?shortcuts-apps">User Guide</ulink>.</para>
20292N/A- <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>
20292N/A+ <para>You can run <application>gedit</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>
20292N/A <para><command>gedit <replaceable>file1.txt file2.txt file3.txt</replaceable></command></para>
20292N/A- <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:gedit" type="man"><citerefentry><refentrytitle>&app;</refentrytitle><manvolnum>1</manvolnum></citerefentry></ulink>.</para>
20292N/A+ <para>For more information on how to run <application>gedit</application> from a command line, see the unix manual page for gedit, <ulink url="man:gedit" type="man"><citerefentry><refentrytitle>gedit</refentrytitle><manvolnum>1</manvolnum></citerefentry></ulink>.</para>
20292N/A- <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>
20292N/A+ <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>gedit</application> window.</para>
20292N/A- <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>
20292N/A+ <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>gedit</application> window. </para>
20292N/A <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/gedit_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>
20292N/A- <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="gedit-tabs"/>.</para></note>
20292N/A+ <note><para>You can open multiple files in <application>gedit</application>. The application adds a tab for each open file to the window. For more on this see <xref linkend="gedit-tabs"/>.</para></note>
20292N/A <listitem><para>To save a new file or to save an existing file under a new filename, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Save As</guimenuitem> </menuchoice>. Enter a name for the file in the <guilabel>Save As</guilabel> dialog, then click <guibutton>Save</guibutton>. </para>
20292N/A- <listitem><para>To save all of the files that are currently open in <application>&app;</application>, choose <menuchoice> <guimenu>Documents</guimenu> <guimenuitem>Save All</guimenuitem> </menuchoice>.</para>
20292N/A+ <listitem><para>To save all of the files that are currently open in <application>gedit</application>, choose <menuchoice> <guimenu>Documents</guimenu> <guimenuitem>Save All</guimenuitem> </menuchoice>.</para>
20292N/A- <para>To close all of the files that are currently open in <application>&app;</application>, choose <menuchoice> <guimenu>Documents</guimenu> <guimenuitem>Close All</guimenuitem> </menuchoice>.</para>
20292N/A+ <para>To close all of the files that are currently open in <application>gedit</application>, choose <menuchoice> <guimenu>Documents</guimenu> <guimenuitem>Close All</guimenuitem> </menuchoice>.</para>
20292N/A- <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>
20292N/A- <para>To move a document to another <application> &app;</application> window, drag the tab corresponding to the file to the window you want to move it to.</para>
20292N/A- <para>To move a document to a new <application> &app;</application> window, either drag its tab to the desktop, or choose <menuchoice> <guimenu>Documents</guimenu> <guimenuitem>Move to New Window</guimenuitem> </menuchoice>.</para>
20292N/A+ <para>When more than one file is open, <application>gedit</application> shows a <firstterm>tab</firstterm> for each document above the display area. To switch to another document, click on its tab.</para>
20292N/A+ <para>To move a document to another <application> gedit</application> window, drag the tab corresponding to the file to the window you want to move it to.</para>
20292N/A+ <para>To move a document to a new <application> gedit</application> window, either drag its tab to the desktop, or choose <menuchoice> <guimenu>Documents</guimenu> <guimenuitem>Move to New Window</guimenuitem> </menuchoice>.</para>
20292N/A <listitem><para>To permanently delete the selected text from the file, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Delete</guimenuitem> </menuchoice>.</para>
20292N/A- <listitem><para>To insert the contents of the clipboard at the cursor position, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem> </menuchoice>. You must cut or copy text before you can paste text into the file, either from &app; or another application.</para>
20292N/A+ <listitem><para>To insert the contents of the clipboard at the cursor position, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Paste</guimenuitem> </menuchoice>. You must cut or copy text before you can paste text into the file, either from gedit or another application.</para>
20292N/A <listitem><para>To select all of the text in a file, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Select All</guimenuitem> </menuchoice>. </para>
20292N/A- <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.
20292N/A+ <para>In <application>gedit</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.
20292N/A <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="gedit-find-escapes"/>.</para>
20292N/A- <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>
20292N/A+ <listitem><para>Click <guibutton>Find</guibutton> to search the file for the first occurrence of the string after your current cursor position. If <application>gedit</application> finds the string, the application selects first occurrence of the string. Other occurrences of the string are highlighted.</para>
20292N/A <listitem><para>To find the next occurrence of the string, click <guibutton>Find</guibutton> or choose <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Find Next</guimenuitem> </menuchoice>. To find the previous occurrence of the text, choose <menuchoice> <guimenu>Search</guimenu> <guimenuitem>Find Previous</guimenuitem> </menuchoice>.</para>
20292N/A- <para>To examine each occurrence of the string before replacing it, click <guibutton>Find</guibutton>. If <application>&app;</application> finds the string, the application selects the string. Click <guibutton>Replace</guibutton> to replace the selected occurrence of the string. To find the next occurrence of the string, click <guibutton>Find</guibutton> again.</para>
20292N/A+ <para>To examine each occurrence of the string before replacing it, click <guibutton>Find</guibutton>. If <application>gedit</application> finds the string, the application selects the string. Click <guibutton>Replace</guibutton> to replace the selected occurrence of the string. To find the next occurrence of the string, click <guibutton>Find</guibutton> again.</para>
20292N/A <para>To replace all occurrences of the string throughout the document, click <guibutton>Replace All</guibutton>.</para>
20292N/A- <para>To reset the fonts to the default fonts for printing a file from <application>&app;</application>, click <guibutton>Restore Default Fonts</guibutton>.</para>
20292N/A+ <para>To reset the fonts to the default fonts for printing a file from <application>gedit</application>, click <guibutton>Restore Default Fonts</guibutton>.</para>
20292N/A- <para>You can use <application>&app;</application> to perform the following print operations:</para>
20292N/A+ <para>You can use <application>gedit</application> to perform the following print operations:</para>
20292N/A- <para>If you print to a file, <application>&app;</application> sends the output of the file to a pre-press format file. The most common pre-press formats are PostScript and Portable Document Format (PDF).</para>
20292N/A+ <para>If you print to a file, <application>gedit</application> sends the output of the file to a pre-press format file. The most common pre-press formats are PostScript and Portable Document Format (PDF).</para>
20292N/A <para>To preview the pages that you want to print, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Print Preview</guimenuitem> </menuchoice>.</para>
20292N/A- <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="gedit-tag-list-plugin"/>.</para>
20292N/A+ <para>Several of <application>gedit</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="gedit-tag-list-plugin"/>.</para>
20292N/A <para>Syntax highlighting makes source code easier to read by showing different parts of the text in different colors.</para>
20292N/A- <para><application>&app;</application> chooses an appropriate syntax highlighting mode based on a document's type. To override the syntax highlighting mode, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Highlight Mode</guimenuitem> </menuchoice>, then choose one of the following menu items:</para>
20292N/A+ <para><application>gedit</application> chooses an appropriate syntax highlighting mode based on a document's type. To override the syntax highlighting mode, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Highlight Mode</guimenuitem> </menuchoice>, then choose one of the following menu items:</para>
20292N/A- <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 | gedit</command>, then press <keycap>Return</keycap>.</para>
20292N/A- <para>The output of the <command>ls</command> command is displayed in a new text file in the <application>&app;</application> window.</para>
20292N/A+ <para>You can use <application>gedit</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 | gedit</command>, then press <keycap>Return</keycap>.</para>
20292N/A+ <para>The output of the <command>ls</command> command is displayed in a new text file in the <application>gedit</application> window.</para>
20292N/A <para>Alternatively, you can use the <application>External tools</application> plugin to pipe command output to the current file. <!-- fixme: xref needed! --></para>
20292N/A- <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>
20292N/A+ <para>Use shortcut keys to perform common tasks more quickly than with the mouse and menus. The following tables list all of <application>gedit</application>'s shortcut keys.</para>
20292N/A <para>For more on shortcut keys, see the <ulink type="help" url="ghelp:user-guide?keyboard-skills">Desktop User Guide</ulink>.</para>
20292N/A- <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>
20292N/A+ <para>To configure <application>gedit</application>, choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice>. The <guilabel>Preferences</guilabel> dialog contains the following categories:</para>
20292N/A- <para>Select the <guilabel>Display line numbers</guilabel> option to display line numbers on the left side of the <application>&app;</application> window. </para>
20292N/A+ <para>Select the <guilabel>Display line numbers</guilabel> option to display line numbers on the left side of the <application>gedit</application> window. </para>
20292N/A- <para>Use the <guilabel>Tab width</guilabel> spin box to specify the width of the space that <application> &app;</application> inserts when you press the <keycap>Tab</keycap> key. </para>
20292N/A- <para>Select the <guilabel>Insert spaces instead of tabs</guilabel> option to specify that <application> &app;</application> inserts spaces instead of a tab character when you press the <keycap>Tab</keycap> key. </para>
20292N/A+ <para>Use the <guilabel>Tab width</guilabel> spin box to specify the width of the space that <application> gedit</application> inserts when you press the <keycap>Tab</keycap> key. </para>
20292N/A+ <para>Select the <guilabel>Insert spaces instead of tabs</guilabel> option to specify that <application> gedit</application> inserts spaces instead of a tab character when you press the <keycap>Tab</keycap> key. </para>
20292N/A- <para>Select the <guilabel>Use default theme font</guilabel> option to use the default system font for the text in the <application>&app;</application> text window. </para>
20292N/A- <para>The <guilabel>Editor font</guilabel> field displays the font that <application>&app;</application> uses to display text. Click on the button to specify the font type, style, and size to use for text. </para>
20292N/A+ <para>Select the <guilabel>Use default theme font</guilabel> option to use the default system font for the text in the <application>gedit</application> text window. </para>
20292N/A+ <para>The <guilabel>Editor font</guilabel> field displays the font that <application>gedit</application> uses to display text. Click on the button to specify the font type, style, and size to use for text. </para>
20292N/A- <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="gedit-plugins-overview"/>.</para>
20292N/A+ <para>Plugins add extra features to <application>gedit</application>. For more information on plugins and how to use the built-in plugins, see <xref linkend="gedit-plugins-overview"/>.</para>
20292N/A- <para>To enable a <application>&app;</application> plugin, perform the following steps:</para>
20292N/A+ <para>To enable a <application>gedit</application> plugin, perform the following steps:</para>
20292N/A <para>Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice>. </para>
20292N/A- <para>To disable a <application>&app;</application> plugin, perform the following steps:</para>
20292N/A+ <para>To disable a <application>gedit</application> plugin, perform the following steps:</para>
20292N/A <para>Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice>. </para>
20292N/A- <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.
20292N/A+ <para>You can add extra features to <application>gedit</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>gedit</application> menus for the new features they provide.
20292N/A- <para>Several plugins come built-in with <application>&app;</application>, and you can install more. The <ulink type="http" url="http://live.gnome.org/Gedit/Plugins">gedit website</ulink> lists third-party plugins.</para>
20292N/A+ <para>Several plugins come built-in with <application>gedit</application>, and you can install more. The <ulink type="http" url="http://live.gnome.org/Gedit/Plugins">gedit website</ulink> lists third-party plugins.</para>
20292N/A <para>To enable and disable plugins, or see which plugins are currently enabled, use the <link linkend="gedit-prefs-plugins">Plugins Preferences</link>.</para>
20292N/A <para><application><link linkend="gedit-document-statistics-plugin">Document Statistics</link></application> shows the number of lines, words, and characters in the document. </para>
20292N/A- <para><application><link linkend="gedit-external-tools-plugin">External Tools</link></application> allows you to execute external commands from <application>&app;</application>.</para>
20292N/A+ <para><application><link linkend="gedit-external-tools-plugin">External Tools</link></application> allows you to execute external commands from <application>gedit</application>.</para>
20292N/A <para><application><!-- <link linkend="gedit-file-browser-plugin">File Browser</link>-->File Browser</application> allows you to browse your files and folders in the side pane.</para>
20292N/A- <note><para>For more information on creating plugins, see the <ulink type="http" url="http://live.gnome.org/Gedit/Plugins"><application>&app;</application> website</ulink>.</para></note>
20292N/A+ <note><para>For more information on creating plugins, see the <ulink type="http" url="http://live.gnome.org/Gedit/Plugins"><application>gedit</application> website</ulink>.</para></note>
20292N/A- <listitem><para>You can continue to update the <application>&app;</application> file while the <guilabel>Document Statistics</guilabel> dialog is open. To refresh the contents of the <guilabel>Document Statistics</guilabel> dialog, click <guibutton>Update</guibutton>.
20292N/A+ <listitem><para>You can continue to update the <application>gedit</application> file while the <guilabel>Document Statistics</guilabel> dialog is open. To refresh the contents of the <guilabel>Document Statistics</guilabel> dialog, click <guibutton>Update</guibutton>.
20292N/A- <para>The <application>External Tools</application> plugin allows you to execute external commands from <application>&app;</application>. You can pipe some content into a command and exploit its output (for example, <application>sed</application>), or launch a predefined command (for example, <application>make</application>).</para>
20292N/A+ <para>The <application>External Tools</application> plugin allows you to execute external commands from <application>gedit</application>. You can pipe some content into a command and exploit its output (for example, <application>sed</application>), or launch a predefined command (for example, <application>make</application>).</para>
20292N/A <para>Use the <guilabel>External Tools Manager</guilabel> to create and edit commands. To run an external command, choose it from the <guimenu>Tools</guimenu> menu.</para>
20292N/A- <para>The actual commands to be run. Several <application>&app;</application> environment variables can be used to pass content to these commands: see <xref linkend="gedit-external-tools-plugin-variables"/>.</para>
20292N/A+ <para>The actual commands to be run. Several <application>gedit</application> environment variables can be used to pass content to these commands: see <xref linkend="gedit-external-tools-plugin-variables"/>.</para>
20292N/A- <para>To open a file in <application>&app;</application>, double-click it in the file list.</para>
20292N/A+ <para>To open a file in <application>gedit</application>, double-click it in the file list.</para>
20292N/A <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>
20292N/A <listitem><para>Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Insert Date and Time</guimenuitem> </menuchoice>. </para>
20292N/A- <para>If you have not configured the Insert Date/Time plugin to automatically insert the date/time without prompting you for the format, <application>&app;</application> displays the <guilabel>Insert Date and Time</guilabel> dialog. Select the appropriate date/time format from the list. Click <guibutton>Insert</guibutton> to close the <guilabel>Insert Date and Time</guilabel> dialog. <application>&app;</application> inserts the date/time at the cursor position in the current file. </para>
20292N/A- <para>If you have configured <application>&app;</application> to use one particular date/time format, the <guilabel>Insert Date and Time</guilabel> dialog is not displayed. The date/time is automatically entered at the cursor position in the current file. </para>
20292N/A+ <para>If you have not configured the Insert Date/Time plugin to automatically insert the date/time without prompting you for the format, <application>gedit</application> displays the <guilabel>Insert Date and Time</guilabel> dialog. Select the appropriate date/time format from the list. Click <guibutton>Insert</guibutton> to close the <guilabel>Insert Date and Time</guilabel> dialog. <application>gedit</application> inserts the date/time at the cursor position in the current file. </para>
20292N/A+ <para>If you have configured <application>gedit</application> to use one particular date/time format, the <guilabel>Insert Date and Time</guilabel> dialog is not displayed. The date/time is automatically entered at the cursor position in the current file. </para>
20292N/A <listitem><para>To specify the date/time format each time you insert the date/time, select the <guilabel>Prompt for a format</guilabel> option.
20292N/A- <listitem><para>To use the same <application>&app;</application>-provided date/time format each time you insert the date/time, select the <guilabel>Use the selected format</guilabel> option, then select the appropriate format from the list. When you select this option, <application>&app;</application> does not prompt you for the date/time format when you choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Insert Date and Time</guimenuitem> </menuchoice>.
20292N/A+ <listitem><para>To use the same <application>gedit</application>-provided date/time format each time you insert the date/time, select the <guilabel>Use the selected format</guilabel> option, then select the appropriate format from the list. When you select this option, <application>gedit</application> does not prompt you for the date/time format when you choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Insert Date and Time</guimenuitem> </menuchoice>.
20292N/A- <listitem><para>To use the same customized date/time format each time you insert the date/time, select the <guilabel>Use custom format</guilabel> option, then enter the appropriate format in the text box. For more information about how to specify a custom format, see <ulink url="man:strftime" type="man"><citerefentry><refentrytitle>strftime</refentrytitle><manvolnum>3</manvolnum></citerefentry></ulink>. When you select this option, <application>&app;</application> does not prompt you for the date/time format when you choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Insert Date and Time</guimenuitem> </menuchoice>.
20292N/A+ <listitem><para>To use the same customized date/time format each time you insert the date/time, select the <guilabel>Use custom format</guilabel> option, then enter the appropriate format in the text box. For more information about how to specify a custom format, see <ulink url="man:strftime" type="man"><citerefentry><refentrytitle>strftime</refentrytitle><manvolnum>3</manvolnum></citerefentry></ulink>. When you select this option, <application>gedit</application> does not prompt you for the date/time format when you choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Insert Date and Time</guimenuitem> </menuchoice>.
20292N/A- <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>
20292N/A+ <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>gedit</application> recognises.</para>
20292N/A <para>Preferences set using modelines take precedence over the ones specified in the preference dialog.</para>
20292N/A- <para>The <application>Python Console</application> Plugin allows you to run commands in the python programming language from <application>&app;</application>. Enabling the plugin adds a tab to the bottom pane. This shows recent output and a command prompt field.</para>
20292N/A- <caution><para>Commands entered into the python console are not checked before they are run. It is therefore possible to hang <application>&app;</application>, for example by entering an infinite loop.</para></caution>
20292N/A+ <para>The <application>Python Console</application> Plugin allows you to run commands in the python programming language from <application>gedit</application>. Enabling the plugin adds a tab to the bottom pane. This shows recent output and a command prompt field.</para>
20292N/A+ <caution><para>Commands entered into the python console are not checked before they are run. It is therefore possible to hang <application>gedit</application>, for example by entering an infinite loop.</para></caution>
20292N/A <para>The <application>Snippets</application> plugin allows you to store frequently-used pieces of text, called <firstterm>snippets</firstterm>, and insert them quickly into a document.</para>
20292N/A <para>Snippets are specific to the language syntax of the current document. For example, when you are working with an HTML document, you can choose from a list of snippets that are useful for HTML. In addition, some snippets are global, and are available in all documents.</para>
20292N/A- <para>A number of built-in snippets are installed with <application>&app;</application>, which can be modified.</para>
20292N/A+ <para>A number of built-in snippets are installed with <application>gedit</application>, which can be modified.</para>
20292N/A <para>In addition to inserting stored text, a snippet can include customizable text, or mark spaces where you can add text once the snippet is inserted in your document.</para>
20292N/A- <para>Environmental variable such as <literal>$PATH</literal> and <literal>$HOME</literal> are substituted in snippet text. The following variables specific to <application>&app;</application> can also be used:</para>
20292N/A+ <para>Environmental variable such as <literal>$PATH</literal> and <literal>$HOME</literal> are substituted in snippet text. The following variables specific to <application>gedit</application> can also be used:</para>
20292N/A- <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>
20292N/A+ <para>The <application>Spell Checker</application> plugin checks the spelling in the selected text. You can configure <application>gedit</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>
20292N/A <listitem><para>Choose <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Set Language</guimenuitem> </menuchoice> to display the <guilabel>Set language</guilabel> dialog. Select the appropriate language from the list. Click <guibutton>OK</guibutton> to close the <guilabel>Set language</guilabel> dialog.
20292N/A- <listitem><para>To check the spelling automatically, choose <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Autocheck Spelling</guimenuitem> </menuchoice>. To unset the automatic spell check, choose <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Autocheck Spelling</guimenuitem> </menuchoice> again. When automatic spell checking is set, an icon is displayed beside the <guimenuitem>Autocheck Spelling</guimenuitem> menu item. Automatic spell checking is unset by default, each time <application>&app;</application> starts.</para>
20292N/A+ <listitem><para>To check the spelling automatically, choose <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Autocheck Spelling</guimenuitem> </menuchoice>. To unset the automatic spell check, choose <menuchoice> <guimenu>Tools</guimenu> <guimenuitem>Autocheck Spelling</guimenuitem> </menuchoice> again. When automatic spell checking is set, an icon is displayed beside the <guimenuitem>Autocheck Spelling</guimenuitem> menu item. Automatic spell checking is unset by default, each time <application>gedit</application> starts.</para>
20292N/A <para>Unknown spellings are displayed in a different color, and underlined. Right-click on an unknown spelling, then select <guimenu>Spelling Suggestions</guimenu> from the popup menu:
20292N/A <listitem><para>To add the unknown spelling to your personal dictionary, select <menuchoice> <guimenu>Spelling Suggestions</guimenu> <guimenuitem>Add</guimenuitem> </menuchoice>.
20292N/A- <listitem><para>To ignore all occurrences of the unknown spelling, so that they are no longer flagged as unknown but are not added to your personal dictionary, select <menuchoice> <guimenu>Spelling Suggestions</guimenu> <guimenuitem>Ignore All</guimenuitem> </menuchoice>. The unknown word is ignored in the current <application>&app;</application> session only.
20292N/A+ <listitem><para>To ignore all occurrences of the unknown spelling, so that they are no longer flagged as unknown but are not added to your personal dictionary, select <menuchoice> <guimenu>Spelling Suggestions</guimenu> <guimenuitem>Ignore All</guimenuitem> </menuchoice>. The unknown word is ignored in the current <application>gedit</application> session only.
20292N/A <listitem><para>To check the spelling of the text in the <guilabel>Change to</guilabel> text box, click <guibutton>Check Word</guibutton>. If this is a known word, the <guilabel>Suggestions</guilabel> list is replaced with the text <literal>(correct spelling)</literal>. If the word is not known, new entries appear in the <guilabel>Suggestions</guilabel> list.
20292N/A- <listitem><para>To ignore the current occurrence of the unknown word, click <guibutton>Ignore</guibutton>. To ignore all occurrences of the unknown word, click <guibutton>Ignore All</guibutton>. The unknown word is ignored in the current <application>&app;</application> session only.
20292N/A+ <listitem><para>To ignore the current occurrence of the unknown word, click <guibutton>Ignore</guibutton>. To ignore all occurrences of the unknown word, click <guibutton>Ignore All</guibutton>. The unknown word is ignored in the current <application>gedit</application> session only.
20292N/A <listitem><para>To change the current occurrence of the unknown word to the text in the <guilabel>Change to</guilabel> text box, click <guibutton>Change</guibutton>. To change all occurrences of the unknown word to the text in the <guilabel>Change to</guilabel> text box, click <guibutton>Change All</guibutton>.