From github
Go to file
Balló György 97336e5a49 Bump required glib version number to 2.32
It's required for the GSettingsSchemaSource API.
2013-12-01 09:53:13 +01:00
.tx Add transifex configuration file 2013-04-02 15:55:50 +02:00
data Fix make dist, use .in.in 2013-10-19 14:19:34 +02:00
docs update for 1.2 release and fix executable bits 2012-03-11 20:28:11 +01:00
help Fix Sun GNOME Documentation Team references 2013-11-05 21:59:08 +01:00
m4 warning: underquoted definition of AM_CHECK_PYMOD 2011-11-07 17:16:09 -03:00
osx update for 1.2 release and fix executable bits 2012-03-11 20:28:11 +01:00
pixmaps update for 1.2 release and fix executable bits 2012-03-11 20:28:11 +01:00
plugin-loaders Make automake happy: INCLUDES -> AM_CPPFLAGS 2013-08-03 00:08:36 +02:00
plugins Use Caja GSettings schema optionally 2013-11-30 13:02:57 +01:00
pluma add the primary-toolbar style class to the primary toolbar 2013-11-06 16:23:50 +01:00
po Update POTFILES.in 2013-10-30 23:06:31 +01:00
tests Fix some deprecations 2013-11-04 12:46:45 +01:00
win32 fix wrong url 2012-08-31 10:05:56 +02:00
AUTHORS update for 1.2 release and fix executable bits 2012-03-11 20:28:11 +01:00
COPYING Fix incorrect-fsf-address rpmlint check 2013-04-17 00:58:25 +02:00
ChangeLog Add empty ChangeLog to allow build from git 2013-04-02 15:49:54 +02:00
HACKING rename to pluma 2013-10-18 01:01:11 +02:00
Makefile.am Fix Chnagelog generation 2013-10-19 15:15:50 +02:00
NEWS Add NEWS file for MATE 2013-01-25 12:21:12 +01:00
NEWS.GNOME Rename NEWS => NEWS.GNOME 2013-01-24 20:43:04 +01:00
README Update bug tracker url 2013-11-09 10:29:06 +01:00
autogen.sh rename to pluma 2013-10-18 01:01:11 +02:00
configure.ac Bump required glib version number to 2.32 2013-12-01 09:53:13 +01:00

README

General Information
===================

pluma 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.
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
one document at the same time.

pluma 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
python support you need the pygtk and mate-python-desktop bindings.

Although new features are always under development, currently pluma has:

    * Complete support for UTF-8 text
    * Syntax highlighting
    * Support for editing remote files
    * Search and Replace
    * Printing and Print Previewing Support
    * File Revert
    * A complete preferences interface
    * Configurable Plugin system, with optional python support


Some of the plugins, packaged and installed with pluma include, among others:

    * Word count
    * Spell checker
    * Change case of selected text
    * File Browser
    * Automatic snippet expansion
    * Sort
    * Insert Date/Time
    * External Tools
    * Tag list

Other external plugins are also available.


pluma is released under the GNU General Public License (GPL) version 2, see
the file 'COPYING' for more information.


The official web site is:

    http://www.mate-desktop.org/

You can download the latest pluma tarball from:

    https://pub.mate-desktop.org/releases/

Installation
============

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

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
  [ Become root if necessary ]
  % make install				# install pluma


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.

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

If test fail and you have setup the above correctly then please file a bug report as described below.

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
account for yourself.

You can also report bugs using the MATE program bug-buddy.

In the bug report please include:

* Information about your system. For instance:

   - What operating system and version
   - What version of X
   - What version of the gtk+, glib and mate libraries
   - For Linux, what version of the C library

  And anything else you think is relevant.

* How to reproduce the bug.

* If the bug was a crash, the exact text that was printed out when the
  crash occurred.

* Further information such as stack traces may be useful, but is not
  necessary. If you do send a stack trace, and the error is an X error,
  it will be more useful if the stack trace is produced running the test
  program with the --sync command line option.


Patches
=======

Patches should also be submitted to github.com/mate-desktop/pluma. If the patch
fixes an existing bug, add the patch as an attachment to that bug
report.

Otherwise, enter a new bug report that describes the patch, and attach
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
mailing list. See also the file 'HACKING' for more detailed information.


  The pluma team.