improved doc

diff --git a/NEWS.html b/NEWS.html
index ff4696b..6b9a207 100644 (file)
--- a/NEWS.html
+++ b/NEWS.html
@@ -90,7 +90,7 @@ code, pre, tt {
 }\r
 \r
 pre {\r
-    background: none repeat scroll 0 0 #f0f0f0;\r
+    background: none repeat scroll 0 0 #e0e0e0;\r
     border-radius: 4px;\r
     padding: 0.5em 0.5em;\r
     margin: 0 0 0 0;\r

diff --git a/README b/README
index 2bc5c65..346b145 100644 (file)
--- a/README
+++ b/README
@@ -1,8 +1,26 @@
 ptask README
 ==============
 
-+ptask+ is a GTK+ graphical user interface for +taskwarrior+, a command
-line tasks manager.
++ptask+ is a GTK+ graphical user interface for managing tasks.
+
+It is based on link:http://taskwarrior.org[taskwarrior], a well-known and robust command line
+tasks manager.
+
+Unlike +taskwarrior+, it is possible to associate a note (long
+description) to each task.
+
++ptask+ is licensed under the GPLv2 terms and should compile on any
+modern GNU/Linux distribution.
+
+*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.
 
 Installation on Ubuntu
 ----------------------
@@ -26,12 +44,13 @@ 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
@@ -44,6 +63,28 @@ For Ubuntu 12.10:
 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 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 developmenet 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
 ~~~~~~~~~~~
 
@@ -64,6 +105,3 @@ 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

diff --git a/README.html b/README.html
index 40ecbea..ff55b9b 100644 (file)
--- a/README.html
+++ b/README.html
@@ -90,7 +90,7 @@ code, pre, tt {
 }\r
 \r
 pre {\r
-    background: none repeat scroll 0 0 #f0f0f0;\r
+    background: none repeat scroll 0 0 #e0e0e0;\r
     border-radius: 4px;\r
     padding: 0.5em 0.5em;\r
     margin: 0 0 0 0;\r
@@ -323,8 +323,18 @@ asciidoc.install(2);
 <div id="content">\r
 <div id="preamble">\r
 <div class="sectionbody">\r
-<div class="paragraph"><p><tt>ptask</tt> is a GTK+ graphical user interface for <tt>taskwarrior</tt>, a command\r
-line tasks manager.</p></div>\r
+<div class="paragraph"><p><tt>ptask</tt> is a GTK+ graphical user interface for managing tasks.</p></div>\r
+<div class="paragraph"><p>It is based on <a href="http://taskwarrior.org">taskwarrior</a>, a well-known and robust command line\r
+tasks manager.</p></div>\r
+<div class="paragraph"><p>Unlike <tt>taskwarrior</tt>, it is possible to associate a note (long\r
+description) to each task.</p></div>\r
+<div class="paragraph"><p><tt>ptask</tt> is licensed under the GPLv2 terms and should compile on any\r
+modern GNU/Linux distribution.</p></div>\r
+<div class="paragraph"><p><strong>Home page</strong>: <a href="http://wpitchoune.net/ptask">http://wpitchoune.net/ptask</a>.</p></div>\r
+<div class="paragraph"><p><strong>RSS feed</strong>: <a href="http://wpitchoune.net/blog/category/ptask/feed/">http://wpitchoune.net/blog/category/ptask/feed/</a>.</p></div>\r
+<div class="paragraph"><p><strong>Release changes</strong>: <a href="NEWS.html">NEWS</a>.</p></div>\r
+<div class="paragraph"><p><strong>Source tarballs</strong>: <a href="http://wpitchoune.net/ptask/files">http://wpitchoune.net/ptask/files</a>.</p></div>\r
+<div class="paragraph"><p><strong>Documentation</strong>: <a href="http://wpitchoune.net/ptask/doc">http://wpitchoune.net/ptask/doc</a>.</p></div>\r
 </div>\r
 </div>\r
 <div class="sect1">\r
@@ -349,7 +359,7 @@ development snapshot. It should only be used for testing purpose.</p></div>
 <div class="paragraph"><p><tt>ptask</tt> can be compiled and installed on any modern GNU/Linux\r
 distribution.</p></div>\r
 <div class="sect2">\r
-<h3 id="_compilation_prerequisites">2.1. Compilation Prerequisites</h3>\r
+<h3 id="_prerequisites">2.1. Prerequisites</h3>\r
 <div class="paragraph"><p>The compilation of <tt>ptask</tt> requires:</p></div>\r
 <div class="ulist"><ul>\r
 <li>\r
@@ -359,6 +369,11 @@ asciidoc
 </li>\r
 <li>\r
 <p>\r
+autotools\r
+</p>\r
+</li>\r
+<li>\r
+<p>\r
 cppcheck (optional, static source checker)\r
 </p>\r
 </li>\r
@@ -394,8 +409,31 @@ make
 <pre><tt>sudo apt-get install autoconf automake asciidoc cppcheck gcc gettext autopoint help2man libgtk-3-dev libjson0-dev make perl</tt></pre>\r
 </div></div>\r
 </div>\r
+</div>\r
+</div>\r
+<div class="sect1">\r
+<h2 id="_download_sources">3. Download sources</h2>\r
+<div class="sectionbody">\r
+<div class="paragraph"><p>Download a source tarballs and extracts its content:</p></div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>mkdir TMP_DIR\r
+cd TMP_DIR\r
+wget http://wpitchoune.net/ptask/files/ptask-last.tar.gz\r
+tar -xzvf ptask-last.tar.gz\r
+cd ptask-*</tt></pre>\r
+</div></div>\r
+<div class="paragraph"><p>Alternatively, you can get the last developmenet snapshot of the\r
+sources directly from the SVN source repository:</p></div>\r
+<div class="listingblock">\r
+<div class="content">\r
+<pre><tt>mkdir TMP_DIR\r
+cd TMP_DIR\r
+svn co http://wpitchoune.net/svnpub/ptask/trunk\r
+cd trunk</tt></pre>\r
+</div></div>\r
 <div class="sect2">\r
-<h3 id="_compilation">2.2. Compilation</h3>\r
+<h3 id="_compilation">3.1. Compilation</h3>\r
 <div class="listingblock">\r
 <div class="content">\r
 <pre><tt>./configure\r
@@ -403,7 +441,7 @@ make clean all</tt></pre>
 </div></div>\r
 </div>\r
 <div class="sect2">\r
-<h3 id="_installation">2.3. Installation</h3>\r
+<h3 id="_installation">3.2. Installation</h3>\r
 <div class="listingblock">\r
 <div class="content">\r
 <pre><tt>make install</tt></pre>\r
@@ -412,18 +450,16 @@ make clean all</tt></pre>
 </div>\r
 </div>\r
 <div class="sect1">\r
-<h2 id="_contact">3. Contact</h2>\r
+<h2 id="_contact">4. Contact</h2>\r
 <div class="sectionbody">\r
 <div class="paragraph"><p>Bugs and comments can be sent to <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>.</p></div>\r
-<div class="paragraph"><p>Home page: <a href="http://wpitchoune.net/ptask">http://wpitchoune.net/ptask</a></p></div>\r
-<div class="paragraph"><p>Release changes: <a href="NEWS.html">NEWS</a></p></div>\r
 </div>\r
 </div>\r
 </div>\r
 <div id="footnotes"><hr /></div>\r
 <div id="footer">\r
 <div id="footer-text">\r
-Last updated 2013-11-24 22:55:07 CET\r
+Last updated 2013-11-27 09:07:46 CET\r
 </div>\r
 </div>\r
 </body>\r

diff --git a/style.css b/style.css
index c08b0b4..1ec7848 100644 (file)
--- a/style.css
+++ b/style.css
@@ -82,7 +82,7 @@ code, pre, tt {
 }
 
 pre {
-    background: none repeat scroll 0 0 #f0f0f0;
+    background: none repeat scroll 0 0 #e0e0e0;
     border-radius: 4px;
     padding: 0.5em 0.5em;
     margin: 0 0 0 0;