X-Git-Url: https://git.wpitchoune.net/gitweb/?p=ptask.git;a=blobdiff_plain;f=README.html;h=9ff044e178e711b25f10d966fa3848d6acc62f50;hp=62bf233ce611367b410f97f4a436bd1972d31d8d;hb=HEAD;hpb=6089d6eaafb4bc2ad30e75c43b973fe1518e268a

diff --git a/README.html b/README.html
index 62bf233..9ff044e 100644
--- a/README.html
+++ b/README.html
@@ -3,542 +3,121 @@
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 8.6.7" />
+<meta name="generator" content="AsciiDoc 8.6.9" />
 <title>ptask README</title>
 <style type="text/css">
-/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
-
-/* Default font. */
-body {
-  font-family: Georgia,serif;
-}
-
-/* Title font. */
-h1, h2, h3, h4, h5, h6,
-div.title, caption.title,
-thead, p.table.header,
-#toctitle,
-#author, #revnumber, #revdate, #revremark,
-#footer {
-  font-family: Arial,Helvetica,sans-serif;
-}
-
 body {
-  margin: 1em 5% 1em 5%;
-}
-
-a {
-  color: blue;
-  text-decoration: underline;
-}
-a:visited {
-  color: fuchsia;
-}
-
-em {
-  font-style: italic;
-  color: navy;
+    background: #FFFFFF;
+    color: #333333;
+    font-family: Ubuntu,Arial,sans-serif;
+    line-height: 1.6;
+    font-weight: lighter;
+    margin: 1em 2em 2em 2em;
+    padding: 0 0 0 0;
 }
 
-strong {
-  font-weight: bold;
-  color: #083194;
+h1 {
+    font-size: 2.813em;
+    margin: 0 0 0.267em 0;
+    padding: 0 0 0 0;
+    font-weight: normal;
 }
 
-h1, h2, h3, h4, h5, h6 {
-  color: #527bbd;
-  margin-top: 1.2em;
-  margin-bottom: 0.5em;
-  line-height: 1.3;
-}
-
-h1, h2, h3 {
-  border-bottom: 2px solid silver;
-}
 h2 {
-  padding-top: 0.5em;
-}
-h3 {
-  float: left;
-}
-h3 + * {
-  clear: left;
-}
-h5 {
-  font-size: 1.0em;
-}
-
-div.sectionbody {
-  margin-left: 0;
-}
-
-hr {
-  border: 1px solid silver;
+    font-size: 2em;
+    margin: 0 0 0.375em;
+    padding: 0 0 0 0;
+    font-weight: normal;
 }
 
-p {
-  margin-top: 0.5em;
-  margin-bottom: 0.5em;
-}
-
-ul, ol, li > p {
-  margin-top: 0;
-}
-ul > li     { color: #aaa; }
-ul > li > * { color: black; }
-
-pre {
-  padding: 0;
-  margin: 0;
-}
-
-#author {
-  color: #527bbd;
-  font-weight: bold;
-  font-size: 1.1em;
-}
-#email {
-}
-#revnumber, #revdate, #revremark {
-}
-
-#footer {
-  font-size: small;
-  border-top: 2px solid silver;
-  padding-top: 0.5em;
-  margin-top: 4.0em;
-}
-#footer-text {
-  float: left;
-  padding-bottom: 0.5em;
-}
-#footer-badges {
-  float: right;
-  padding-bottom: 0.5em;
-}
-
-#preamble {
-  margin-top: 1.5em;
-  margin-bottom: 1.5em;
-}
-div.imageblock, div.exampleblock, div.verseblock,
-div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
-div.admonitionblock {
-  margin-top: 1.0em;
-  margin-bottom: 1.5em;
-}
-div.admonitionblock {
-  margin-top: 2.0em;
-  margin-bottom: 2.0em;
-  margin-right: 10%;
-  color: #606060;
-}
-
-div.content { /* Block element content. */
-  padding: 0;
-}
-
-/* Block element titles. */
-div.title, caption.title {
-  color: #527bbd;
-  font-weight: bold;
-  text-align: left;
-  margin-top: 1.0em;
-  margin-bottom: 0.5em;
-}
-div.title + * {
-  margin-top: 0;
-}
-
-td div.title:first-child {
-  margin-top: 0.0em;
-}
-div.content div.title:first-child {
-  margin-top: 0.0em;
-}
-div.content + div.title {
-  margin-top: 0.0em;
-}
-
-div.sidebarblock > div.content {
-  background: #ffffee;
-  border: 1px solid #dddddd;
-  border-left: 4px solid #f0f0f0;
-  padding: 0.5em;
-}
-
-div.listingblock > div.content {
-  border: 1px solid #dddddd;
-  border-left: 5px solid #f0f0f0;
-  background: #f8f8f8;
-  padding: 0.5em;
-}
-
-div.quoteblock, div.verseblock {
-  padding-left: 1.0em;
-  margin-left: 1.0em;
-  margin-right: 10%;
-  border-left: 5px solid #f0f0f0;
-  color: #888;
-}
-
-div.quoteblock > div.attribution {
-  padding-top: 0.5em;
-  text-align: right;
-}
-
-div.verseblock > pre.content {
-  font-family: inherit;
-  font-size: inherit;
-}
-div.verseblock > div.attribution {
-  padding-top: 0.75em;
-  text-align: left;
-}
-/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
-div.verseblock + div.attribution {
-  text-align: left;
-}
-
-div.admonitionblock .icon {
-  vertical-align: top;
-  font-size: 1.1em;
-  font-weight: bold;
-  text-decoration: underline;
-  color: #527bbd;
-  padding-right: 0.5em;
-}
-div.admonitionblock td.content {
-  padding-left: 0.5em;
-  border-left: 3px solid #dddddd;
-}
-
-div.exampleblock > div.content {
-  border-left: 3px solid #dddddd;
-  padding-left: 0.5em;
-}
-
-div.imageblock div.content { padding-left: 0; }
-span.image img { border-style: none; }
-a.image:visited { color: white; }
-
-dl {
-  margin-top: 0.8em;
-  margin-bottom: 0.8em;
-}
-dt {
-  margin-top: 0.5em;
-  margin-bottom: 0;
-  font-style: normal;
-  color: navy;
-}
-dd > *:first-child {
-  margin-top: 0.1em;
-}
-
-ul, ol {
-    list-style-position: outside;
-}
-ol.arabic {
-  list-style-type: decimal;
-}
-ol.loweralpha {
-  list-style-type: lower-alpha;
-}
-ol.upperalpha {
-  list-style-type: upper-alpha;
-}
-ol.lowerroman {
-  list-style-type: lower-roman;
-}
-ol.upperroman {
-  list-style-type: upper-roman;
-}
-
-div.compact ul, div.compact ol,
-div.compact p, div.compact p,
-div.compact div, div.compact div {
-  margin-top: 0.1em;
-  margin-bottom: 0.1em;
-}
-
-tfoot {
-  font-weight: bold;
-}
-td > div.verse {
-  white-space: pre;
+h3 {
+    font-size: 1.438em;
+    margin: 0 0 0.522em;
+    padding: 0 0 0 0;
+    font-weight: normal;
 }
 
-div.hdlist {
-  margin-top: 0.8em;
-  margin-bottom: 0.8em;
-}
-div.hdlist tr {
-  padding-bottom: 15px;
-}
-dt.hdlist1.strong, td.hdlist1.strong {
-  font-weight: bold;
-}
-td.hdlist1 {
-  vertical-align: top;
-  font-style: normal;
-  padding-right: 0.8em;
-  color: navy;
-}
-td.hdlist2 {
-  vertical-align: top;
-}
-div.hdlist.compact tr {
-  margin: 0;
-  padding-bottom: 0;
+h4 {
+    font-size: 1.219em;
+    margin: 0 0 0.615em;
+    padding: 0 0 0 0;
+    font-weight: normal;
 }
 
-.comment {
-  background: yellow;
+h5 {
+    font-size: 1em;
+    margin: 0 0 0.75em;
+    padding: 0 0 0 0;
+    font-weight: bold;
 }
 
-.footnote, .footnoteref {
-  font-size: 0.8em;
+h6 {
+    font-weight: normal;
+    font-size: 0.813em;
+    letter-spacing: 0.1em;
+    margin: 0 0 0.923em;
+    text-transform: uppercase;
+    padding: 0 0 0 0;
 }
 
-span.footnote, span.footnoteref {
-  vertical-align: super;
+li {
+    margin: 0 0 0 1em;
+    line-height: 1.6;
 }
 
-#footnotes {
-  margin: 20px 0 20px 0;
-  padding: 7px 0 0 0;
+li p {
+    margin: 0 0 0 0;
 }
 
-#footnotes div.footnote {
-  margin: 0 0 5px 0;
+ul {
+    margin: 0 0 0 0;
+    padding: 0 0 0 0;
 }
 
-#footnotes hr {
-  border: none;
-  border-top: 1px solid silver;
-  height: 1px;
-  text-align: left;
-  margin-left: 0;
-  width: 20%;
-  min-width: 100px;
+a:link, a:visited {
+    color: #19B6EE;
+    text-decoration: none;
 }
 
-div.colist td {
-  padding-right: 0.5em;
-  padding-bottom: 0.3em;
-  vertical-align: top;
-}
-div.colist td img {
-  margin-top: 0.3em;
+a:hover {
+    text-decoration: underline;
 }
 
-@media print {
-  #footer-badges { display: none; }
+code, pre, tt {
+    font-family: "Ubuntu Mono","Courier New",Courier,monospace;
+    font-weight: normal;
+    color: #333333;
 }
 
-#toc {
-  margin-bottom: 2.5em;
+pre {
+    background: none repeat scroll 0 0 #e0e0e0;
+    border-radius: 4px;
+    padding: 0.5em 0.5em;
+    margin: 0 0 0 0;
+    white-space: pre-wrap;
+    word-wrap: break-word;
 }
 
-#toctitle {
-  color: #527bbd;
-  font-size: 1.1em;
-  font-weight: bold;
-  margin-top: 1.0em;
-  margin-bottom: 0.1em;
-}
+/* ASCIIDOC */
 
-div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
-  margin-top: 0;
-  margin-bottom: 0;
-}
 div.toclevel2 {
-  margin-left: 2em;
-  font-size: 0.9em;
-}
-div.toclevel3 {
-  margin-left: 4em;
-  font-size: 0.9em;
-}
-div.toclevel4 {
-  margin-left: 6em;
-  font-size: 0.9em;
-}
-
-span.aqua { color: aqua; }
-span.black { color: black; }
-span.blue { color: blue; }
-span.fuchsia { color: fuchsia; }
-span.gray { color: gray; }
-span.green { color: green; }
-span.lime { color: lime; }
-span.maroon { color: maroon; }
-span.navy { color: navy; }
-span.olive { color: olive; }
-span.purple { color: purple; }
-span.red { color: red; }
-span.silver { color: silver; }
-span.teal { color: teal; }
-span.white { color: white; }
-span.yellow { color: yellow; }
-
-span.aqua-background { background: aqua; }
-span.black-background { background: black; }
-span.blue-background { background: blue; }
-span.fuchsia-background { background: fuchsia; }
-span.gray-background { background: gray; }
-span.green-background { background: green; }
-span.lime-background { background: lime; }
-span.maroon-background { background: maroon; }
-span.navy-background { background: navy; }
-span.olive-background { background: olive; }
-span.purple-background { background: purple; }
-span.red-background { background: red; }
-span.silver-background { background: silver; }
-span.teal-background { background: teal; }
-span.white-background { background: white; }
-span.yellow-background { background: yellow; }
-
-span.big { font-size: 2em; }
-span.small { font-size: 0.6em; }
-
-span.underline { text-decoration: underline; }
-span.overline { text-decoration: overline; }
-span.line-through { text-decoration: line-through; }
-
-div.unbreakable { page-break-inside: avoid; }
-
-
-/*
- * xhtml11 specific
- *
- * */
-
-tt {
-  font-family: "Courier New", Courier, monospace;
-  font-size: inherit;
-  color: navy;
-}
-
-div.tableblock {
-  margin-top: 1.0em;
-  margin-bottom: 1.5em;
-}
-div.tableblock > table {
-  border: 3px solid #527bbd;
-}
-thead, p.table.header {
-  font-weight: bold;
-  color: #527bbd;
-}
-p.table {
-  margin-top: 0;
-}
-/* Because the table frame attribute is overriden by CSS in most browsers. */
-div.tableblock > table[frame="void"] {
-  border-style: none;
-}
-div.tableblock > table[frame="hsides"] {
-  border-left-style: none;
-  border-right-style: none;
-}
-div.tableblock > table[frame="vsides"] {
-  border-top-style: none;
-  border-bottom-style: none;
-}
-
-
-/*
- * html5 specific
- *
- * */
-
-.monospaced {
-  font-family: "Courier New", Courier, monospace;
-  font-size: inherit;
-  color: navy;
-}
-
-table.tableblock {
-  margin-top: 1.0em;
-  margin-bottom: 1.5em;
-}
-thead, p.tableblock.header {
-  font-weight: bold;
-  color: #527bbd;
-}
-p.tableblock {
-  margin-top: 0;
-}
-table.tableblock {
-  border-width: 3px;
-  border-spacing: 0px;
-  border-style: solid;
-  border-color: #527bbd;
-  border-collapse: collapse;
-}
-th.tableblock, td.tableblock {
-  border-width: 1px;
-  padding: 4px;
-  border-style: solid;
-  border-color: #527bbd;
-}
-
-table.tableblock.frame-topbot {
-  border-left-style: hidden;
-  border-right-style: hidden;
-}
-table.tableblock.frame-sides {
-  border-top-style: hidden;
-  border-bottom-style: hidden;
-}
-table.tableblock.frame-none {
-  border-style: hidden;
+    margin-left: 1em;
 }
 
-th.tableblock.halign-left, td.tableblock.halign-left {
-  text-align: left;
-}
-th.tableblock.halign-center, td.tableblock.halign-center {
-  text-align: center;
-}
-th.tableblock.halign-right, td.tableblock.halign-right {
-  text-align: right;
+#toctitle {
+    font-size: 1.219em;
+    margin: 0 0 0.615em;
+    padding: 0 0 0 0;
+    font-weight: normal;
 }
 
-th.tableblock.valign-top, td.tableblock.valign-top {
-  vertical-align: top;
-}
-th.tableblock.valign-middle, td.tableblock.valign-middle {
-  vertical-align: middle;
-}
-th.tableblock.valign-bottom, td.tableblock.valign-bottom {
-  vertical-align: bottom;
+#footer {
+    margin: 2em 0 0 0;
+    font-size: 0.8em;
+    font-weight: lighter;
 }
 
 
-/*
- * manpage specific
- *
- * */
-
-body.manpage h1 {
-  padding-top: 0.5em;
-  padding-bottom: 0.5em;
-  border-top: 2px solid silver;
-  border-bottom: 2px solid silver;
-}
-body.manpage h2 {
-  border-style: none;
-}
-body.manpage div.sectionbody {
-  margin-left: 3em;
-}
-
-@media print {
-  body.manpage div#toc { display: none; }
-}
 </style>
 <script type="text/javascript">
 /*<![CDATA[*/
@@ -744,36 +323,41 @@ asciidoc.install(2);
 </div>
 </div>
 <div id="content">
-<div class="sect1">
-<h2 id="_introduction">1. Introduction</h2>
+<div id="preamble">
 <div class="sectionbody">
-<div class="paragraph"><p><tt>ptask</tt> is a GTK+ graphical user interface of <tt>taskwarrior</tt>, a command
-line tasks manager.</p></div>
+<div class="paragraph"><p><code>ptask</code> is a GTK+ graphical user interface for managing tasks.</p></div>
+<div class="paragraph"><p>It is based on <a href="http://taskwarrior.org">taskwarrior</a>, a well-known and robust command line
+tasks manager.</p></div>
+<div class="paragraph"><p>Unlike <code>taskwarrior</code>, it is possible to associate a note (long
+description) to each task.</p></div>
+<div class="paragraph"><p><code>ptask</code> is licensed under the GPLv2 terms and should compile on any
+modern GNU/Linux distribution.</p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_installation_using_distribution_packages">2. Installation Using Distribution Packages</h2>
+<h2 id="_installation_on_ubuntu">1. Installation on Ubuntu</h2>
 <div class="sectionbody">
-<div class="sect2">
-<h3 id="_ubuntu">2.1. Ubuntu</h3>
-<div class="paragraph"><p>To install <tt>ptask</tt>, the easiest way is to use the dedicated PPA:</p></div>
+<div class="paragraph"><p>To install <code>ptask</code> on Ubuntu and derivates, the easiest way is to use the dedicated PPA:</p></div>
 <div class="listingblock">
 <div class="content">
-<pre><tt>sudo apt-add-repository ppa:jfi/ptask
+<pre><code>sudo apt-add-repository ppa:jfi/ptask
 sudo apt-get update
-sudo apt-get install ptask</tt></pre>
+sudo apt-get install ptask</code></pre>
 </div></div>
-</div>
+<div class="paragraph"><p>The PPA <code>ppa:jfi/ptask</code> contains the binary package of the last
+released version of <code>ptask</code> for the last released version of Ubuntu.</p></div>
+<div class="paragraph"><p>The PPA <code>ppa:jfi/ptask-daily</code> contains the binary package of the last
+development snapshot. It should only be used for testing purpose.</p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_installation_from_source_archive">3. Installation From Source Archive</h2>
+<h2 id="_installation_from_source_archive">2. Installation from source archive</h2>
 <div class="sectionbody">
-<div class="paragraph"><p><tt>ptask</tt> can be compiled and installed on any modern GNU/Linux
+<div class="paragraph"><p><code>ptask</code> can be compiled and installed on any modern GNU/Linux
 distribution.</p></div>
 <div class="sect2">
-<h3 id="_compilation_prerequisites">3.1. Compilation Prerequisites</h3>
-<div class="paragraph"><p>The compilation of <tt>ptask</tt> requires:</p></div>
+<h3 id="_prerequisites">2.1. Prerequisites</h3>
+<div class="paragraph"><p>The compilation of <code>ptask</code> requires:</p></div>
 <div class="ulist"><ul>
 <li>
 <p>
@@ -782,6 +366,11 @@ asciidoc
 </li>
 <li>
 <p>
+autotools
+</p>
+</li>
+<li>
+<p>
 cppcheck (optional, static source checker)
 </p>
 </li>
@@ -797,7 +386,7 @@ help2man
 </li>
 <li>
 <p>
-library gtk3
+library gtk3 &gt;= 3.12
 </p>
 </li>
 <li>
@@ -814,25 +403,91 @@ make
 <div class="paragraph"><p>For Ubuntu 12.10:</p></div>
 <div class="listingblock">
 <div class="content">
-<pre><tt>sudo apt-get install autoconf automake asciidoc cppcheck gcc gettext
-autopoint help2man libgtk-3-dev libjson0-dev make perl</tt></pre>
+<pre><code>sudo apt-get install autoconf automake asciidoc cppcheck gcc gettext autopoint help2man libgtk-3-dev libjson0-dev make perl</code></pre>
+</div></div>
+</div>
+<div class="sect2">
+<h3 id="_download_sources">2.2. Download sources</h3>
+<div class="paragraph"><p>Download a source tarballs of a release and extracts its content:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code>mkdir TMP_DIR
+cd TMP_DIR
+wget http://wpitchoune.net/ptask/files/ptask-last.tar.gz
+tar -xzvf ptask-last.tar.gz
+cd ptask-*</code></pre>
+</div></div>
+<div class="paragraph"><p>Alternatively, you can get the last development snapshot of the
+sources directly from the SVN source repository:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><code>mkdir TMP_DIR
+cd TMP_DIR
+svn co http://wpitchoune.net/svnpub/ptask/trunk
+cd trunk</code></pre>
+</div></div>
+</div>
+<div class="sect2">
+<h3 id="_compilation">2.3. Compilation</h3>
+<div class="listingblock">
+<div class="content">
+<pre><code>./configure
+make clean all</code></pre>
+</div></div>
+</div>
+<div class="sect2">
+<h3 id="_installation">2.4. Installation</h3>
+<div class="listingblock">
+<div class="content">
+<pre><code>make install</code></pre>
 </div></div>
 </div>
 </div>
 </div>
 <div class="sect1">
+<h2 id="_resources">3. Resources</h2>
+<div class="sectionbody">
+<div class="ulist"><ul>
+<li>
+<p>
+<strong>Home page</strong>: <a href="http://wpitchoune.net/ptask">http://wpitchoune.net/ptask</a>.
+</p>
+</li>
+<li>
+<p>
+<strong>RSS feed</strong>: <a href="http://wpitchoune.net/blog/category/ptask/feed/">http://wpitchoune.net/blog/category/ptask/feed/</a>.
+</p>
+</li>
+<li>
+<p>
+<strong>Release changes</strong>: <a href="NEWS.html">NEWS</a>.
+</p>
+</li>
+<li>
+<p>
+<strong>Source tarballs</strong>: <a href="http://wpitchoune.net/ptask/files">http://wpitchoune.net/ptask/files</a>.
+</p>
+</li>
+<li>
+<p>
+<strong>Documentation</strong>: <a href="http://wpitchoune.net/ptask/doc">http://wpitchoune.net/ptask/doc</a>.
+</p>
+</li>
+</ul></div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_contact">4. Contact</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Bugs and comments can be sent to <a href="mailto:jeanfi@gmail.com">jeanfi@gmail.com</a>.</p></div>
-<div class="paragraph"><p>Home page: <a href="http://wpitchoune.net/ptask">http://wpitchoune.net/ptask</a></p></div>
-<div class="paragraph"><p>Release changes: <a href="NEWS.html">NEWS</a></p></div>
 </div>
 </div>
 </div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2012-12-11 09:03:53 CET
+Last updated
+ 2014-11-21 18:14:30 CET
 </div>
 </div>
 </body>
