top margin for footer
[ptask.git] / README
diff --git a/README b/README
index e69de29..2bc5c65 100644 (file)
--- a/README
+++ b/README
@@ -0,0 +1,69 @@
+ptask README
+==============
+
++ptask+ is a GTK+ graphical user interface for +taskwarrior+, a command
+line tasks manager.
+
+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
+-------------------------------------
+
+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
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The compilation of +ptask+ requires:
+
+ * asciidoc
+ * cppcheck (optional, static source checker)
+ * gcc
+ * help2man
+ * library gtk3
+ * 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
+-------------------------------------------------------------------------
+
+Compilation
+~~~~~~~~~~~
+
+-------------------------------
+./configure
+make clean all
+-------------------------------
+
+Installation
+~~~~~~~~~~~~
+
+-------------------------------
+make install
+-------------------------------
+
+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