pluma is a small and lightweight UTF-8 text editor for the MATE
xedit is a small and lightweight UTF-8 text editor for the MATE
environment. Based on gedit, the text editor for the GNOME2 environment.
pluma is part of MATE and uses the latest GTK+ and MATE libraries.
xedit is part of MATE and uses the latest GTK+ and MATE libraries.
Complete MATE integration is featured, with support for Drag and Drop (DnD)
from Caja (the MATE file manager), the use of the MATE help system,
the MATE Virtual File System and the MATE print framework.
pluma uses a Multiple Document Interface (MDI), which lets you edit more than
xedit uses a Multiple Document Interface (MDI), which lets you edit more than
one document at the same time.
pluma supports most standard editing features, plus several not found in your
xedit supports most standard editing features, plus several not found in your
average text editor (plugins being the most notable of these).
pluma plugins may also be written in the python scripting language: to enable
xedit plugins may also be written in the python scripting language: to enable
python support you need the pygtk and mate-python-desktop bindings.
Although new features are always under development, currently pluma has:
Although new features are always under development, currently xedit has:
* Complete support for UTF-8 text
* Syntax highlighting
@ -30,7 +30,7 @@ Although new features are always under development, currently pluma has:
* Configurable Plugin system, with optional python support
Some of the plugins, packaged and installed with pluma include, among others:
Some of the plugins, packaged and installed with xedit include, among others:
* Word count
* Spell checker
@ -45,7 +45,7 @@ Some of the plugins, packaged and installed with pluma include, among others:
Other external plugins are also available.
pluma is released under the GNU General Public License (GPL) version 2, see
xedit is released under the GNU General Public License (GPL) version 2, see
the file 'COPYING' for more information.
@ -53,14 +53,14 @@ The official web site is:
http://www.mate-desktop.org/
You can download the latest pluma tarball from:
You can download the latest xedit tarball from:
https://pub.mate-desktop.org/releases/
Installation
============
pluma requires GTK+-2.16.x, GtkSourceView 2.4.x and MateConf libraries.
xedit requires GTK+-2.16.x, GtkSourceView 2.4.x and MateConf libraries.
PyGobject 2.12.x, PyGtk 2.12.x and PyGtkSourceView 2.4.x are required to
enable python plugins support.
@ -69,14 +69,14 @@ Simple install procedure:
% gzip -cd mate-text-editor.tar.gz | tar xvf - # unpack the sources
% cd mate-text-editor # change to the toplevel directory
% ./autogen.sh # run the `configure' script
% make # build pluma
% make # build xedit
[ Become root if necessary ]
% make install # install pluma
% make install # install xedit
Running Tests
==================
Pluma has several test that can be run after compilation. Run them by issueing "make check". However there are a couple of requirements that need to be satified before they will pass.
Xedit has several test that can be run after compilation. Run them by issueing "make check". However there are a couple of requirements that need to be satified before they will pass.
* You need the gsettings schemas installed for some tests to be able to run.
* You need to mount sftp://localhost/ with gvfs-mount for one test to pass.
@ -87,7 +87,7 @@ How to report bugs
==================
Bugs should be reported to the MATE bug tracking system.
(https://github.com/mate-desktop/pluma/issues). You will need to create an
(https://github.com/mate-desktop/xedit/issues). You will need to create an
account for yourself.
You can also report bugs using the MATE program bug-buddy.
@ -117,7 +117,7 @@ In the bug report please include:
Patches
=======
Patches should also be submitted to github.com/mate-desktop/pluma. If the patch
Patches should also be submitted to github.com/mate-desktop/xedit. If the patch
fixes an existing bug, add the patch as an attachment to that bug
report.
@ -126,10 +126,10 @@ the patch to that bug report.
Patches should be in unified diff form. (The -u option to GNU diff.)
If you are interested in helping us to develop pluma, please see the
file 'AUTHOR' for contact information and/or send a message to the pluma
If you are interested in helping us to develop xedit, please see the
file 'AUTHOR' for contact information and/or send a message to the xedit
mailing list. See also the file 'HACKING' for more detailed information.
<description>Whether to use the system's default fixed width font for editing text instead of a font specific to pluma. If this option is turned off, then the font named in the "Editor Font" option will be used instead of the system font.</description>
<description>Whether to use the system's default fixed width font for editing text instead of a font specific to xedit. If this option is turned off, then the font named in the "Editor Font" option will be used instead of the system font.</description>
<description>Whether pluma should create backup copies for the files it saves. You can set the backup file extension with the "Backup Copy Extension" option.</description>
<description>Whether xedit should create backup copies for the files it saves. You can set the backup file extension with the "Backup Copy Extension" option.</description>
</key>
<keyname="auto-save"type="b">
<default>false</default>
<summary>Autosave</summary>
<description>Whether pluma should automatically save modified files after a time interval. You can set the time interval with the "Autosave Interval" option.</description>
<description>Whether xedit should automatically save modified files after a time interval. You can set the time interval with the "Autosave Interval" option.</description>
</key>
<keyname="auto-save-interval"type="i">
<default>10</default>
<summary>Autosave Interval</summary>
<description>Number of minutes after which pluma will automatically save modified files. This will only take effect if the "Autosave" option is turned on.</description>
<description>Number of minutes after which xedit will automatically save modified files. This will only take effect if the "Autosave" option is turned on.</description>
<description>Whether pluma should restore the previous cursor position when a file is loaded.</description>
<description>Whether xedit should restore the previous cursor position when a file is loaded.</description>
</key>
<keyname="enable-search-highlighting"type="b">
<default>true</default>
<summary>Enable Search Highlighting</summary>
<description>Whether pluma should highlight all the occurrences of the searched text.</description>
<description>Whether xedit should highlight all the occurrences of the searched text.</description>
</key>
<keyname="enable-syntax-highlighting"type="b">
<default>true</default>
<summary>Enable Syntax Highlighting</summary>
<description>Whether pluma should enable syntax highlighting.</description>
<description>Whether xedit should enable syntax highlighting.</description>
</key>
<keyname="toolbar-visible"type="b">
<default>true</default>
@ -114,7 +114,7 @@
<keyname="toolbar-buttons-style"type="s">
<default>'@TOOLBAR_STYLE@'</default>
<summary>Toolbar Buttons Style</summary>
<description>Style for the toolbar buttons. Possible values are "PLUMA_TOOLBAR_SYSTEM" to use the system's default style, "PLUMA_TOOLBAR_ICONS" to display icons only, "PLUMA_TOOLBAR_ICONS_AND_TEXT" to display both icons and text, and "PLUMA_TOOLBAR_ICONS_BOTH_HORIZ" to display prioritized text beside icons. Note that the values are case-sensitive, so make sure they appear exactly as mentioned here.</description>
<description>Style for the toolbar buttons. Possible values are "XEDIT_TOOLBAR_SYSTEM" to use the system's default style, "XEDIT_TOOLBAR_ICONS" to display icons only, "XEDIT_TOOLBAR_ICONS_AND_TEXT" to display both icons and text, and "XEDIT_TOOLBAR_ICONS_BOTH_HORIZ" to display prioritized text beside icons. Note that the values are case-sensitive, so make sure they appear exactly as mentioned here.</description>
</key>
<keyname="statusbar-visible"type="b">
<default>true</default>
@ -139,12 +139,12 @@
<keyname="print-syntax-highlighting"type="b">
<default>true</default>
<summary>Print Syntax Highlighting</summary>
<description>Whether pluma should print syntax highlighting when printing documents.</description>
<description>Whether xedit should print syntax highlighting when printing documents.</description>
</key>
<keyname="print-header"type="b">
<default>true</default>
<summary>Print Header</summary>
<description>Whether pluma should include a document header when printing documents.</description>
<description>Whether xedit should include a document header when printing documents.</description>
</key>
<keyname="print-wrap-mode"type="s">
<default>'GTK_WRAP_WORD'</default>
@ -154,7 +154,7 @@
<keyname="print-line-numbers"type="i">
<default>0</default>
<summary>Print Line Numbers</summary>
<description>If this value is 0, then no line numbers will be inserted when printing a document. Otherwise, pluma will print line numbers every such number of lines.</description>
<description>If this value is 0, then no line numbers will be inserted when printing a document. Otherwise, xedit will print line numbers every such number of lines.</description>
<description>Sorted list of encodings used by pluma for automatically detecting the encoding of a file. "CURRENT" represents the current locale encoding. Only recognized encodings are used.</description>
<description>Sorted list of encodings used by xedit for automatically detecting the encoding of a file. "CURRENT" represents the current locale encoding. Only recognized encodings are used.</description>
<description>List of active plugins. It contains the "Location" of the active plugins. See the .pluma-plugin file for obtaining the "Location" of a given plugin.</description>
<description>List of active plugins. It contains the "Location" of the active plugins. See the .xedit-plugin file for obtaining the "Location" of a given plugin.</description>
.THPLUMA1"29 January 2014""MATE Desktop Environment"
.\" Man page for Xedit.
.THXEDIT1"29 January 2014""MATE Desktop Environment"
.\" Please adjust this date when revising the manpage.
.\"
.SH"NAME"
Pluma\- The MATE Text Editor
Xedit\- The MATE Text Editor
.SH"SYNOPSIS"
.Bpluma[OPTIONS...][FILES...]
.Bxedit[OPTIONS...][FILES...]
.SH"DESCRIPTION"
Pluma is the official text editor of the MATE desktop environment. While aiming at simplicity and ease of use, Pluma is a powerful general purpose text editor. It can be used to create and edit all sorts of text files.
Xedit is the official text editor of the MATE desktop environment. While aiming at simplicity and ease of use, Xedit is a powerful general purpose text editor. It can be used to create and edit all sorts of text files.
.PP
Pluma features a flexible plugin system which can be used to dynamically add new advanced features to Pluma itself.
Xedit features a flexible plugin system which can be used to dynamically add new advanced features to Xedit itself.
.PP
This manual page briefly documents the \fBpluma\fR command.
This manual page briefly documents the \fBxedit\fR command.
.SH"OPTIONS"
.TP
\fBfilename(s)...\fR
Specifies the file to open when \fBpluma\fR starts. If this is not specified, \fBpluma\fR will start a new, blank file with an "Unsaved Document" label. Multiple files can be loaded if they are separated by spaces. \fBpluma\fR also supports handling of remote files.
Specifies the file to open when \fBxedit\fR starts. If this is not specified, \fBxedit\fR will start a new, blank file with an "Unsaved Document" label. Multiple files can be loaded if they are separated by spaces. \fBxedit\fR also supports handling of remote files.
.TP
\fB\-\-display=DISPLAY\fR
X display to use.
@ -25,10 +25,10 @@ X display to use.
Set the character encoding to be used for opening the files listed on the command line.
.TP
\fB\-\-new\-window\fR
Create a new toplevel window in an existing instance of \fBpluma\fR.
Create a new toplevel window in an existing instance of \fBxedit\fR.
.TP
\fB\-\-new\-document\fR
Create a new document in an existing instance of \fBpluma\fR, on the last Pluma window that had focus.
Create a new document in an existing instance of \fBxedit\fR, on the last Xedit window that had focus.
.TP
\fB+[num]\fR
For the first file, go to the line specified by "num" (do not insert a space between the "+" sign and the number).
@ -49,25 +49,25 @@ Print all command line options.
This program also accepts the standard GTK options.