summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Makefile.am2
-rw-r--r--README116
-rw-r--r--README.md110
-rw-r--r--configure.ac2
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
+
+![pluma-icon](pixmaps/pluma.ico)
+
+## 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])])