X-Git-Url: https://git.wpitchoune.net/gitweb/?p=ptask.git;a=blobdiff_plain;f=README;h=b1ba196429872c5afaa99d373df72026dc109dce;hp=b5e7cbb8f7ecd81689eb334f9b541b1074cb091a;hb=HEAD;hpb=772fbcad98f6cb0143a6f511d7d14d2a8fb7bf41 diff --git a/README b/README index b5e7cbb..b1ba196 100644 --- a/README +++ b/README @@ -1,55 +1,105 @@ ptask README ============== -Introduction ------------- ++ptask+ is a GTK+ graphical user interface for managing tasks. -+ptask+ is a GTK+ graphical user interface for +taskwarrior+, a command -line tasks manager. +It is based on link:http://taskwarrior.org[taskwarrior], a well-known and robust command line +tasks manager. -Installation Using Distribution Packages ----------------------------------------- +Unlike +taskwarrior+, it is possible to associate a note (long +description) to each task. -Ubuntu -~~~~~~ ++ptask+ is licensed under the GPLv2 terms and should compile on any +modern GNU/Linux distribution. -To install +ptask+, the easiest way is to use the dedicated PPA: +Installation on Ubuntu +---------------------- + +To install +ptask+ on Ubuntu and derivates, the easiest way is to use the dedicated PPA: ------------------------------------- sudo apt-add-repository ppa:jfi/ptask sudo apt-get update sudo apt-get install ptask ------------------------------------- -Installation From Source Archive +The PPA +ppa:jfi/ptask+ contains the binary package of the last +released version of +ptask+ for the last released version of Ubuntu. + +The PPA +ppa:jfi/ptask-daily+ contains the binary package of the last +development snapshot. It should only be used for testing purpose. + +Installation from source archive -------------------------------- +ptask+ can be compiled and installed on any modern GNU/Linux distribution. -Compilation Prerequisites -~~~~~~~~~~~~~~~~~~~~~~~~~ +Prerequisites +~~~~~~~~~~~~~ The compilation of +ptask+ requires: * asciidoc + * autotools * cppcheck (optional, static source checker) * gcc * help2man - * library gtk3 + * library gtk3 >= 3.12 * library json-c * make For Ubuntu 12.10: ------------------------------------------------------------------------- -sudo apt-get install autoconf automake asciidoc cppcheck gcc gettext -autopoint help2man libgtk-3-dev libjson0-dev make perl +sudo apt-get install autoconf automake asciidoc cppcheck gcc gettext autopoint help2man libgtk-3-dev libjson0-dev make perl ------------------------------------------------------------------------- +Download sources +~~~~~~~~~~~~~~~~ + +Download a source tarballs of a release and extracts its content: +------------------------------- +mkdir TMP_DIR +cd TMP_DIR +wget http://wpitchoune.net/ptask/files/ptask-last.tar.gz +tar -xzvf ptask-last.tar.gz +cd ptask-* +------------------------------- + +Alternatively, you can get the last development snapshot of the +sources directly from the SVN source repository: + +------------------------------- +mkdir TMP_DIR +cd TMP_DIR +svn co http://wpitchoune.net/svnpub/ptask/trunk +cd trunk +------------------------------- + +Compilation +~~~~~~~~~~~ + +------------------------------- +./configure +make clean all +------------------------------- + +Installation +~~~~~~~~~~~~ + +------------------------------- +make install +------------------------------- + +Resources +--------- + + * *Home page*: http://wpitchoune.net/ptask. + * *RSS feed*: http://wpitchoune.net/blog/category/ptask/feed/. + * *Release changes*: link:NEWS.html[NEWS]. + * *Source tarballs*: http://wpitchoune.net/ptask/files. + * *Documentation*: http://wpitchoune.net/ptask/doc. + Contact ------- Bugs and comments can be sent to jeanfi@gmail.com. - -Home page: http://wpitchoune.net/ptask - -Release changes: link:NEWS.html[NEWS] \ No newline at end of file