X-Git-Url: http://git.claws-mail.org/?p=clawsker.git;a=blobdiff_plain;f=README;h=2c18b2455066daf0f073a9f78481faa14d221f72;hp=79ceee5b5d3da486a49e4ed1f094bde5e6eb6251;hb=87a8a01466b182e01d7404b614ee1d03a746bfb7;hpb=567dbc42d40ca44df50da36da0bd4d4d461187c4 diff --git a/README b/README index 79ceee5..2c18b24 100644 --- a/README +++ b/README @@ -3,11 +3,15 @@ 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 -edition of configuration files. +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.php + Dependencies ------------ @@ -15,16 +19,18 @@ 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.140) + Perl - http://www.perl.com (>= 5.10) + 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). Locale::gettext - http://search.cpan.org/~pvandry/gettext-1.05/ (>= 1.05) - Claws Mail - http://www.claws-mail.org (>= 3.1.0) + Claws Mail - http://www.claws-mail.org (>= 3.9.1) On Debian systems: # apt-get install libgtk2-perl liblocale-gettext-perl claws-mail @@ -32,11 +38,14 @@ Dependencies Install ------- -After downloading the tarball, as root: +After downloading the tarball: - tar xzf clawsker-VERSION.tar.gz + tar xJf clawsker-VERSION.tar.xz cd clawsker-VERSION make + +If finished correctly, become root and: + make install Replace VERSION with the actual version number of the tarball. @@ -51,24 +60,18 @@ Optionally you can provide also a DESTDIR as a root tree for the installation. Contributing ------------ -Patches, and specially, new translations (or updates to th existing) are -welcome. +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://github.com/mones/clawsker/. -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). +Translators please read po/README file for details about translations. -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. +Bugs +---- -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). +You can send bug reports on http://github.com/mones/clawsker/issues/ list. +Also directly by mail to me or in the Claws Mail mailing list, but the Issues +list is the preferred way. Thanks ------ @@ -78,9 +81,8 @@ 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 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/ +--