Clawsker - A Claws Mail Tweaker
-------------------------------
-Clawsker is a Perl-GTK2 applet to edit hidden preferences for Claws Mail,
-and to do it in a safe and user friendly way, preventing users from raw
+Clawsker is a Perl-GTK applet to edit hidden preferences for Claws Mail,
+and to do it in a safe and user friendly way, preventing users from raw
editing of configuration files.
Claws Mail is a fast and lightweight Mail User Agent by the Claws Mail Team.
You can download the latest version from Clawsker homepage:
- http://www.claws-mail.org/clawsker
+ http://www.claws-mail.org/clawsker.php
Dependencies
------------
Nothing special: make, sed, install, gettext and pod2man.
- On Debian systems:
+ On Debian systems and derivatives:
# apt-get install make sed coreutils gettext perl
(Although you probably already have some of these installed)
- Running:
- Perl - http://www.perl.com (>= 5.8)
- GTK+2 bindings for Perl - http://gtk2-perl.sourceforge.net (>= 1.161) built
- with GTK+ >= 2.12 (lower GTK+ versions do not support widget tooltips and
- a warning is issued).
+ Perl - http://www.perl.com (>= 5.10)
+ GTK+3 bindings for Perl - https://gitlab.gnome.org/GNOME/perl-gtk3
+ (>= 0.030)
Locale::gettext - http://search.cpan.org/~pvandry/gettext-1.05/ (>= 1.05)
- Claws Mail - http://www.claws-mail.org (>= 3.1.0)
+ File::Which - https://metacpan.org/pod/File::Which (>= 1.21)
+ Claws Mail - http://www.claws-mail.org (>= 3.9.1)
On Debian systems:
- # apt-get install libgtk2-perl liblocale-gettext-perl claws-mail
+ # apt-get install libgtk3-perl liblocale-gettext-perl libfile-which-perl
+ # apt-get install claws-mail
+
+ - Test suite:
+
+ Test::Exception - https://metacpan.org/pod/Test::Exception
Install
-------
After downloading the tarball:
- tar xzf clawsker-VERSION.tar.gz
+ tar xJf clawsker-VERSION.tar.xz
cd clawsker-VERSION
make
Optionally you can provide also a DESTDIR as a root tree for the installation.
-Contributing
-------------
+Test suite
+----------
-Patches, bug fixes, and specially, new translations (or updates to the
-existing ones) are welcome.
+You can run the test suite with:
-To create a new translation just change to 'po' directory, copy 'clawsker.pot'
-into 'xx.po' or 'xx_YY.po', and fill the empty strings and placeholder values.
-The 'xx' is your language code (e.g.: 'en' for English, 'fr' for French, etc.)
-and, optionally, 'YY' defines your country variant (e.g.: 'de_CH' for German
-variant in Switzerland). Country should be used only if your translation is
-really specific to that location, otherwise, and specially for new languages,
-try use the generic language (you can always submit a specific one later).
+ make test
-Once finished you can test your new translation by adding your 'xx' or 'xx_YY'
-code to the LINGUAS variable in Makefile and running make. A new .mo file
-with the same name of your .po file should be created if everything is right.
+If running test suite fails please report a bug with all the messages
+printed by the above command, the versions of Perl and the version of
+Clawsker dependencies you're using.
-To update an existing translation just type 'make xx.pox' or 'make xx_YY.pox'
-and update the new .pox file created, copy the .pox file to the .po file and
-test it as above (no need to modify the Makefile this time).
+Contributing
+------------
+
+Patches, bug fixes, and specially, new translations (or updates to the
+existing ones) are welcome. Development uses git as VCS and takes place
+on http://git.claws-mail.org.
+
+Translators please read po/README file for details about translations.
Bugs
----
-You can send bug reports to the Issues list on http://clawsker.googlecode.com/
-Also directly by mail to me or in the Claws Mail mailing list, but the Issues
-list is the preferred way.
+You can send bug reports to http://www.thewildbeast.co.uk/claws-mail/bugzilla/
+by selecting the 'clawsker' product.
+
+Also directly by mail to me or in the Claws Mail mailing list, but bugzilla
+is the preferred way.
Thanks
------
* The Perl-GTK2 folks and Phillip Vandry
* Dirk van der Walt, for his Gtk2-Perl Study Guide [0]
* Debian, for the Operating System
+* GitHub Inc., for providing the initial git hosting and more
-[0] http://forgeftp.novell.com//gtk2-perl-study/documentation/html/index.html
-
---
-$Id$
+[0] http://gtk2-perl.sourceforge.net/doc/gtk2-perl-study-guide/
+--