Branch: refs/heads/master Author: Frank Lanitz frank@frank.uvena.de Committer: Frank Lanitz frank@frank.uvena.de Date: Sun, 26 Aug 2012 19:53:27 Commit: 4335e4d2aed26ccb13be17ee1cea9346065d4383 https://github.com/geany/geany-plugins/commit/4335e4d2aed26ccb13be17ee1cea93...
Log Message: ----------- Some further smaller changes on HACKING and fix indention of l10n-bullet points
Modified Paths: -------------- HACKING
Modified: HACKING 38 files changed, 20 insertions(+), 18 deletions(-) =================================================================== @@ -9,7 +9,7 @@ General About this file --------------- This file contains some useful information for any plugin developer, and -especially for new plugin developers. A lot of information inside +especially for new plugin developers. A lot of information inside `Geany's HACKING file http://geany.org/manual/hacking.html` is useful as well, so it's recommended you give it a read.
@@ -33,10 +33,12 @@ They currently are: ``--disable-cppcheck`` configuration flag) -- this test is run during ``make check``.
-These features are only here to help you writing better code: they are not -necessarily and always right -- though they try. -If you think they reports wrong problems, please file a report on the -appropriate place (either the mailing lists or the geany-plugins bug tracker). +These features are only here to help you writing better code: they +are not necessarily and always right -- though they try. However +it's highly recommended to make usage of them and fix maybe occuring +issues before submitting a patch. If you think they reports wrong +problems, please file a report on the appropriate place (either the +mailing lists or the geany-plugins bug tracker).
Documentation @@ -44,6 +46,7 @@ Documentation
README ^^^^^^ + Each plugin folder should contain at least a `README` file for documentation.
@@ -51,12 +54,11 @@ documentation. Markup language ###############
-The `README` is intended to be written in -`Restructured Text http://sphinx.pocoo.org/rest.html`_ -(as this document is) and therefore should work with -``rst2html`` or similar tools. The reason for this is that this -information is used to generate the content of the -`Plugins Website http://plugins.geany.org`. +The `README` is intended to be written in `Restructured Text +http://sphinx.pocoo.org/rest.html`_ (as this document is) and +therefore should work with ``rst2html`` or similar tools. The reason +for this is that this information is used to generate the content of +the `Plugins Website http://plugins.geany.org`.
Recommended contents @@ -148,10 +150,10 @@ I18n/l10n Geany-Plugins is supporting localisation of your plugin. To make usage of it, there needs to be done:
- * Mark each string which should be translatable with the gettext macro - ``_()`` or ``N_()`` for static strings. As an example the string - ``"Hello World"`` might become ``_("Hello World")``. - * Add files with translateable strings into ``po/POTFILES.in``. You - should group them for your plugin as done for the other. Each files - needs to be put into one line with complete relative path from - plugin root directory. E.g. ``myplugin/src/myplugin.c`` +* Mark each string which should be translatable with the gettext macro + ``_()`` or ``N_()`` for static strings. As an example the string + ``"Hello World"`` might become ``_("Hello World")``. +* Add files with translateable strings into ``po/POTFILES.in``. You + should group them for your plugin as done for the other. Each files + needs to be put into one line with complete relative path from + plugin root directory. E.g. ``myplugin/src/myplugin.c``
@@ Diff output truncated at 100000 characters. @@
-------------- This E-Mail was brought to you by github_commit_mail.py (Source: TBD).