diff options
| -rw-r--r-- | Makefile.am | 2 | ||||
| -rw-r--r-- | README | 116 | ||||
| -rw-r--r-- | README.md | 110 | ||||
| -rw-r--r-- | configure.ac | 2 |
4 files changed, 112 insertions, 118 deletions
diff --git a/Makefile.am b/Makefile.am index cff26708..045d7853 100644 --- a/Makefile.am +++ b/Makefile.am @@ -14,7 +14,7 @@ EXTRA_DIST = \ its \ ChangeLog \ NEWS \ - README \ + README.md \ xmldocs.make \ omf.make diff --git a/README b/README deleted file mode 100644 index 118d287b..00000000 --- a/README +++ /dev/null @@ -1,116 +0,0 @@ -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). - -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 - - -Some of the plugins, packaged and installed with pluma include, among others: - - * Word count - * Spell checker - * Change case of selected text - * File Browser - * Sort - * Insert Date/Time - * 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: - - https://mate-desktop.org/ - -You can download the latest pluma tarball from: - - https://pub.mate-desktop.org/releases/ - -Installation -============ - -pluma requires GTK+-3.14.x and GtkSourceView 3.0.x. - -Simple install procedure: - - % ./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 satisfied 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. - -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 https://github.com/mate-desktop/pluma, -preferably via pull requests. - - - The pluma team. - diff --git a/README.md b/README.md new file mode 100644 index 00000000..c361a343 --- /dev/null +++ b/README.md @@ -0,0 +1,110 @@ +# Pluma - The MATE text editor + + + +## General Information + +Pluma (pluma) is a small and lightweight UTF-8 text editor for the MATE environment. It started as a fork of Gedit (at version 2.30) in 2011, back then the text editor for the GNOME 2 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 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, 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). + +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** + + +Some of the plugins, packaged and installed with Pluma include, among others: + +- **Spell checker** - *Checks the spelling of the current document* +- **File Browser** - *Easy file access from the side pane* +- **Sort** - *Sorts a document or selected text* +- **Insert Date/Time** - *Inserts current date and time at the cursor position* +- **Tag list** - *Provides a method to easily insert code tags.* + +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: + + https://mate-desktop.org/ + +You can download the latest Pluma tarball from: + + https://pub.mate-desktop.org/releases/ + +## Build/Installation + +Pluma requires GTK+ (>= 3.22) and GtkSourceView (>= 3.0.0). For a complete list of dependencies see the [build.yml](https://github.com/mate-desktop/pluma/blob/master/.build.yml). + +**Warning**: This procedure doesn't install in a separate prefix, so it may +overwrite your system binaries. + +Simple install procedure: + +``` +$ git submodule update --init --recursive # Init git submodules +$ ./autogen.sh # Build configuration +$ make # Build +[ Become root if necessary ] +$ make install # Installation +``` +For installation to a separate prefix change the above `make install` command to + +``` +$ make install --prefix /an/other/path +``` + +## 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 satisfied 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. + +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. For example: + + - 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 https://github.com/mate-desktop/pluma, preferably via pull requests. + +The Pluma team.
\ No newline at end of file diff --git a/configure.ac b/configure.ac index 94760c6e..93e58dfe 100644 --- a/configure.ac +++ b/configure.ac @@ -22,7 +22,7 @@ AC_SUBST(PLUMA_MINOR_VERSION, pluma_minor_version) AC_DEFINE(PLUMA_MICRO_VERSION, pluma_micro_version, [Pluma micro version]) AC_SUBST(PLUMA_MICRO_VERSION, pluma_micro_version) -AM_INIT_AUTOMAKE([1.10 dist-xz no-dist-gzip -Wno-portability check-news]) +AM_INIT_AUTOMAKE([1.10 foreign dist-xz no-dist-gzip -Wno-portability check-news]) AM_MAINTAINER_MODE m4_ifdef([AM_SILENT_RULES],[AM_SILENT_RULES([yes])]) |