help/Makefile

pixmaps/Makefile

plugins/Makefile

plugins/docinfo/Makefile

plugins/externaltools/data/Makefile

plugins/externaltools/Makefile

<copyright its:translate="no">

<year>2015-2020</year>

</copyright>

<copyright its:translate="no">

<year>2007</year>

</copyright>

<copyright its:translate="no">

<year>2002</year>

<year>2003</year>

<year>2004</year>

</copyright>

<copyright its:translate="no">

<year>2000</year>

</copyright>

<publisher>

<affiliation>

<orgname its:translate="yes">GNOME Documentation Project</orgname>

</affiliation>

</author>

<othercredit role="other">

<personname>

<imageobject>

<imagedata fileref="figures/pluma_window.png" format="PNG"/>

</imageobject>

<phrase its:translate="yes">Shows pluma main window.</phrase>

</textobject>

</mediaobject>

<para>The <application>pluma</application> window contains the following elements:</para>

<variablelist>

<term>Menubar</term>

<listitem>

<para>The menus on the menubar contain all the commands you need to work with files in <application>pluma</application>.</para>

</listitem>

</varlistentry>

<term>Toolbar</term>

<listitem>

<para>The toolbar contains a subset of the commands that you can access from the menubar.</para>

</listitem>

</varlistentry>

<term>Display area</term>

<listitem>

<para>The display area contains the text of the file that you are editing.</para>

</listitem>

</varlistentry>

<term>Statusbar</term>

<listitem>

<para>The statusbar displays information about current <application>pluma</application> activity and contextual information about the menu items. The statusbar also displays the following information:</para>

</itemizedlist>

</listitem>

</varlistentry>

<term>Side Pane</term>

<listitem>

<para>The side pane displays a list of open documents, and other information depending on which plugins are enabled.</para>

<para>By default, the side pane is not shown. To show it, choose <menuchoice> <guimenu>View</guimenu> <guimenuitem>Side Pane</guimenuitem> </menuchoice>.</para>

</listitem>

</varlistentry>

<term>Bottom Pane</term>

<listitem>

<para>The bottom pane is used by programming tools such as the <application>Python Console</application> plugin to display output.</para>

<info>

<title>Finding Text</title>

</info>

<para>To search a file for a string of text, perform the following steps:</para>

<orderedlist inheritnum="ignore" continuation="restarts">

<listitem>

</menuchoice> to display the <guilabel>Find</guilabel> dialog.</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>pluma</application> finds the string, the application selects first occurrence of the string. Other occurrences of the string are highlighted.</para>

</listitem>

<listitem>

</menuchoice>.</para>

</listitem>

</orderedlist>

</menuchoice>.</para>

</menuchoice>.</para>

<para>Refer to the <link xlink:href="man:pcrepattern"> <citerefentry> <refentrytitle>pcrepattern</refentrytitle> <manvolnum>3</manvolnum> </citerefentry> </link> for more information about the syntax and the semantics of the regular expressions supported on <guilabel>Find</guilabel> dialog.</para>

</section>

<info>

<title>Incremental Search</title>

</info>

<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>

</menuchoice>. The search box appears at the top of the display area. </para>

<para>Begin typing, and text that matches will be highlighted in the document. The first instance after the cursor position is also selected.</para>

<para>To advance the selection to the next match while keeping the incremental search box open, press <keycombo>

<para>To search a file for a string, and replace the string with an alternative string, perform the following steps:</para>

<orderedlist inheritnum="ignore" continuation="restarts">

<listitem>

</menuchoice> to display the <guilabel>Replace</guilabel> dialog.</para>

</listitem>

<listitem>

<info>

<title>Find and Replace Options</title>

</info>

<para>The <guilabel>Find</guilabel> dialog and the <guilabel>Replace</guilabel> dialog both have the following options:</para>

<itemizedlist>

<listitem>

<info>

<title>Special Characters</title>

</info>

<para>You can include the following escape sequences in the text to find or replace to represent special characters:</para>

<variablelist>

<varlistentry>

<title>General Tabbed Section</title>

</info>

<variablelist>

<term>

</term>

<listitem>

<para>Select this option to print syntax highlighting. For more information about syntax highlighting, see <xref linkend="pluma-set-highlightmode"/>.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Select this option to include a header on each page that you print. You cannot configure the header. </para>

</listitem>

</varlistentry>

<term>

<guilabel>Line Numbers</guilabel>

</term>

<para>Use the <guilabel>Number every ... lines </guilabel> spin box to specify how often to print the line numbers, for example every 5 lines, every 10 lines, and so on.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Select the <guilabel>Enable text wrapping</guilabel> option to wrap text onto the next line, at a character level, when you print a file. The application counts wrapped lines as one line for line numbering purposes.</para>

<title>Fonts</title>

</info>

<variablelist>

<term>

</term>

<listitem>

<para>Click on this button to select the font used to print the body text of a file.</para>

</listitem>

</varlistentry>

<term>

<guilabel>Line numbers</guilabel>

</term>

<para>Click on this button to select the font used to print line numbers.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Click on this button to select the font to use to print the headers and footers in a file. </para>

<title>Job Tabbed Section</title>

</info>

<variablelist>

<term>

</term>

<listitem>

<para>Select one of the following options to determine how many pages to print:</para>

</itemizedlist>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use the <guilabel>Number of copies</guilabel> spin box to specify the number of copies of the file that you want to print.</para>

<info>

<title>Printer Tabbed Section</title>

</info>

<variablelist>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the printer to which you want to print the file.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the printer settings.</para>

<para>To configure the printer, click <guibutton>Configure</guibutton>. For example, you can enable or disable duplex printing, or schedule delayed printing, if this functionality is supported by the printer.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this drop-down list to select one of the following print destinations:</para>

</variablelist>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>This functionality is not supported in this version of pluma.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>This functionality is not supported in this version of pluma.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>This functionality is not supported in this version of pluma.</para>

<info>

<title>Paper Tabbed Section</title>

</info>

<variablelist>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the size of the paper to which you want to print the file.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this spin box to specify the width of the paper. Use the adjacent drop-down list to change the measurement unit.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this spin box to specify the height of the paper.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the orientation of the paper in the printer.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the page orientation.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

<para>Use this drop-down list to select the page layout. A preview of each layout that you select is displayed in the <guilabel>Preview</guilabel> area.</para>

</listitem>

</varlistentry>

<term>

</term>

<listitem>

</listitem>

</varlistentry>

</variablelist>

<info>

<title>Syntax Highlighting</title>

</info>

<para>Syntax highlighting makes source code easier to read by showing different parts of the text in different colors.</para>

<para><application>pluma</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>

<variablelist>

</row>

<row valign="top">

<entry>

<para>Alt + Up</para>

</entry>

<entry>

<variablelist>

<varlistentry>

<term>

</term>

<listitem>

<para>Select the <guilabel>Enable text wrapping</guilabel> option to have long lines of text flow into paragraphs instead of running off the edge of the text window. This avoids having to scroll horizontally</para>

<variablelist>

<varlistentry>

<term>

</term>

<listitem>

<para>Use the <guilabel>Tab width</guilabel> spin box to specify the width of the space that <application> pluma</application> inserts when you press the <keycap>Tab</keycap> key. </para>

</varlistentry>

<varlistentry>

<term>

</term>

<listitem>

<para>Select the <guilabel>Enable auto indentation</guilabel> option to specify that the next line starts at the indentation level of the current line. </para>

</varlistentry>

<varlistentry>

<term>

</term>

<listitem>

<para>Select the <guilabel>Create a backup copy of files before saving</guilabel> option to create a backup copy of a file each time you save the file. The backup copy of the file contains a ~ at the end of the filename.</para>

<info>

<title>Font &amp; Colors Preferences</title>

</info>

<variablelist>

<varlistentry>

<term>

</term>

<listitem>

<para>Select the <guilabel>Use default theme font</guilabel> option to use the default system font for the text in the <application>pluma</application> text window. </para>

<info>

<title>Disabling a Plugin</title>

</info>

<para>A plugin remains enabled when you quit <application>pluma</application>. </para>

<para>To disable a <application>pluma</application> plugin, perform the following steps:</para>

<orderedlist inheritnum="ignore" continuation="restarts">

<itemizedlist>

<listitem>

<para>

<xref linkend="pluma-document-statistics-plugin"/> shows the number of lines, words, and characters in the document.

</para>

</listitem>

</note>

</section>

<section xml:id="pluma-document-statistics-plugin">

<info>

<title>Document Statistics Plugin</title>

</info>

<para>To configure the Insert Date/Time plugin, perform the following steps:</para>

<orderedlist inheritnum="ignore" continuation="restarts">

<para>Choose <menuchoice> <guimenu>Edit</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice>.</para>

</listitem>

<para>Select the <guilabel>Plugins</guilabel> tab.</para>

</listitem>

<para>Select the <guilabel>Insert Date/Time</guilabel> plugin.</para>

</listitem>

<para>Click <guibutton>Configure Plugin</guibutton> to display the <guilabel>Configure insert date/time plugin</guilabel> dialog.</para>

</listitem>

<para>Select one of the options, as follows: </para>

<itemizedlist>

<listitem>

</listitem>

</itemizedlist>

</listitem>

<para>Click <guibutton>OK</guibutton> to close the <guilabel>Configure insert date/time plugin</guilabel> dialog.

</para>

</listitem>

<para>To close the <guilabel>Preferences</guilabel> dialog, click <guibutton>Close</guibutton>.</para>

</listitem>

</orderedlist>

<listitem>

<para>When your document is ready, save it.</para>

</listitem>

<para>You will see that any trailing whitespaces has been stripped after the document has been saved.</para>

</listitem>

</orderedlist>

DIST_SUBDIRS = \

docinfo \

externaltools \

filebrowser \

trailsave

SUBDIRS = \

docinfo \

externaltools \

filebrowser \

}

void

_pluma_cmd_edit_preferences (GtkAction *action,

PlumaWindow *window)

{

PlumaWindow *window);

void _pluma_cmd_edit_delete (GtkAction *action,

PlumaWindow *window);

void _pluma_cmd_edit_select_all (GtkAction *action,

PlumaWindow *window);

void _pluma_cmd_edit_preferences (GtkAction *action,

N_("Delete the selected text"), G_CALLBACK (_pluma_cmd_edit_delete) },

{ "EditSelectAll", "edit-select-all", N_("Select _All"), "<control>A",

N_("Select the entire document"), G_CALLBACK (_pluma_cmd_edit_select_all) },

/* View menu */

{ "ViewHighlightMode", NULL, N_("_Highlight Mode") },

* pluma-ui.xml

* This file is part of pluma

*

*

* This program is free software; you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* Foundation, Inc., 51 Franklin Street, Fifth Floor,

* Boston, MA 02110-1301 USA.

*

*

* $Id$

-->

<menuitem name="EditCopyMenu" action="EditCopy"/>

<menuitem name="EditPasteMenu" action="EditPaste"/>

<menuitem name="EditDeleteMenu" action="EditDelete"/>

<separator/>

<menuitem name="EditSelectAllMenu" action="EditSelectAll"/>

<placeholder name="EditOps_3" />

<separator/>

<placeholder name="EditOps_5" />

<separator/>

<placeholder name="EditOps_6" />

<separator/>

<menuitem name="EditPreferencesMenu" action="EditPreferences"/>

</menu>

<separator/>

<placeholder name="SearchOps_4" />

<separator/>

<placeholder name="SearchOps_5" />

<separator/>

<placeholder name="SearchOps_6" />

<separator/>

<placeholder name="SearchOps_7" />

<separator/>

<placeholder name="SearchOps_8" />

<placeholder name="DocumentsOps_2" />

<separator/>

<placeholder name="DocumentsOps_3" />

<menuitem action="DocumentsNextDocument" />

<separator/>

<menuitem action="DocumentsMoveToNewWindow"/>

<separator/>

<menuitem action="FilePrint"/>

<separator/>

<separator/>

<menuitem name="FileCloseMenu" action="FileClose"/>

</popup>

"delete_from_cursor", 2,

G_TYPE_ENUM, GTK_DELETE_PARAGRAPHS,

G_TYPE_INT, 1);

}

static void

0.0);

}

/**

* pluma_view_select_all:

* @view: a #PlumaView

void pluma_view_copy_clipboard (PlumaView *view);

void pluma_view_paste_clipboard (PlumaView *view);

void pluma_view_delete_selection (PlumaView *view);

void pluma_view_select_all (PlumaView *view);

void pluma_view_scroll_to_cursor (PlumaView *view);

pluma/pluma-utils.c

pluma/pluma-view.c

pluma/pluma-window.c

plugins/docinfo/docinfo.plugin.desktop.in

plugins/docinfo/docinfo.ui

plugins/docinfo/pluma-docinfo-plugin.c