/usr/share/doc/yagtd/rest/yagtd.html

<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.4.1: http://docutils.sourceforge.net/" />
<title>yaGTD - Yet Another Getting Things Done</title>
<style type="text/css">

/*
:Author: David Goodger
:Contact: goodger@users.sourceforge.net
:Date: $Date: 2005-12-18 01:56:14 +0100 (Sun, 18 Dec 2005) $
:Revision: $Revision: 4224 $
:Copyright: This stylesheet has been placed in the public domain.

Default cascading style sheet for the HTML output of Docutils.

See http://docutils.sf.net/docs/howto/html-stylesheets.html for how to
customize this style sheet.
*/

/* used to remove borders from tables and images */
.borderless, table.borderless td, table.borderless th {
  border: 0 }

table.borderless td, table.borderless th {
  /* Override padding for "table.docutils td" with "! important".
     The right padding separates the table cells. */
  padding: 0 0.5em 0 0 ! important }

.first {
  /* Override more specific margin styles with "! important". */
  margin-top: 0 ! important }

.last, .with-subtitle {
  margin-bottom: 0 ! important }

.hidden {
  display: none }

a.toc-backref {
  text-decoration: none ;
  color: black }

blockquote.epigraph {
  margin: 2em 5em ; }

dl.docutils dd {
  margin-bottom: 0.5em }

/* Uncomment (and remove this text!) to get bold-faced definition list terms
dl.docutils dt {
  font-weight: bold }
*/

div.abstract {
  margin: 2em 5em }

div.abstract p.topic-title {
  font-weight: bold ;
  text-align: center }

div.admonition, div.attention, div.caution, div.danger, div.error,
div.hint, div.important, div.note, div.tip, div.warning {
  margin: 2em ;
  border: medium outset ;
  padding: 1em }

div.admonition p.admonition-title, div.hint p.admonition-title,
div.important p.admonition-title, div.note p.admonition-title,
div.tip p.admonition-title {
  font-weight: bold ;
  font-family: sans-serif }

div.attention p.admonition-title, div.caution p.admonition-title,
div.danger p.admonition-title, div.error p.admonition-title,
div.warning p.admonition-title {
  color: red ;
  font-weight: bold ;
  font-family: sans-serif }

/* Uncomment (and remove this text!) to get reduced vertical space in
   compound paragraphs.
div.compound .compound-first, div.compound .compound-middle {
  margin-bottom: 0.5em }

div.compound .compound-last, div.compound .compound-middle {
  margin-top: 0.5em }
*/

div.dedication {
  margin: 2em 5em ;
  text-align: center ;
  font-style: italic }

div.dedication p.topic-title {
  font-weight: bold ;
  font-style: normal }

div.figure {
  margin-left: 2em ;
  margin-right: 2em }

div.footer, div.header {
  clear: both;
  font-size: smaller }

div.line-block {
  display: block ;
  margin-top: 1em ;
  margin-bottom: 1em }

div.line-block div.line-block {
  margin-top: 0 ;
  margin-bottom: 0 ;
  margin-left: 1.5em }

div.sidebar {
  margin-left: 1em ;
  border: medium outset ;
  padding: 1em ;
  background-color: #ffffee ;
  width: 40% ;
  float: right ;
  clear: right }

div.sidebar p.rubric {
  font-family: sans-serif ;
  font-size: medium }

div.system-messages {
  margin: 5em }

div.system-messages h1 {
  color: red }

div.system-message {
  border: medium outset ;
  padding: 1em }

div.system-message p.system-message-title {
  color: red ;
  font-weight: bold }

div.topic {
  margin: 2em }

h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
  margin-top: 0.4em }

h1.title {
  text-align: center }

h2.subtitle {
  text-align: center }

hr.docutils {
  width: 75% }

img.align-left {
  clear: left }

img.align-right {
  clear: right }

ol.simple, ul.simple {
  margin-bottom: 1em }

ol.arabic {
  list-style: decimal }

ol.loweralpha {
  list-style: lower-alpha }

ol.upperalpha {
  list-style: upper-alpha }

ol.lowerroman {
  list-style: lower-roman }

ol.upperroman {
  list-style: upper-roman }

p.attribution {
  text-align: right ;
  margin-left: 50% }

p.caption {
  font-style: italic }

p.credits {
  font-style: italic ;
  font-size: smaller }

p.label {
  white-space: nowrap }

p.rubric {
  font-weight: bold ;
  font-size: larger ;
  color: maroon ;
  text-align: center }

p.sidebar-title {
  font-family: sans-serif ;
  font-weight: bold ;
  font-size: larger }

p.sidebar-subtitle {
  font-family: sans-serif ;
  font-weight: bold }

p.topic-title {
  font-weight: bold }

pre.address {
  margin-bottom: 0 ;
  margin-top: 0 ;
  font-family: serif ;
  font-size: 100% }

pre.literal-block, pre.doctest-block {
  margin-left: 2em ;
  margin-right: 2em ;
  background-color: #eeeeee }

span.classifier {
  font-family: sans-serif ;
  font-style: oblique }

span.classifier-delimiter {
  font-family: sans-serif ;
  font-weight: bold }

span.interpreted {
  font-family: sans-serif }

span.option {
  white-space: nowrap }

span.pre {
  white-space: pre }

span.problematic {
  color: red }

span.section-subtitle {
  /* font-size relative to parent (h1..h6 element) */
  font-size: 80% }

table.citation {
  border-left: solid 1px gray;
  margin-left: 1px }

table.docinfo {
  margin: 2em 4em }

table.docutils {
  margin-top: 0.5em ;
  margin-bottom: 0.5em }

table.footnote {
  border-left: solid 1px black;
  margin-left: 1px }

table.docutils td, table.docutils th,
table.docinfo td, table.docinfo th {
  padding-left: 0.5em ;
  padding-right: 0.5em ;
  vertical-align: top }

table.docutils th.field-name, table.docinfo th.docinfo-name {
  font-weight: bold ;
  text-align: left ;
  white-space: nowrap ;
  padding-left: 0 }

h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
  font-size: 100% }

tt.docutils {
  background-color: #eeeeee }

ul.auto-toc {
  list-style-type: none }

</style>
</head>
<body>
<div class="document" id="yagtd-yet-another-getting-things-done">
<h1 class="title">yaGTD - Yet Another Getting Things Done</h1>
<p>A primitive Getting Things Done to-do list manager.</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field"><th class="field-name">Author:</th><td class="field-body">MiKael NAVARRO &lt;<a class="reference" href="mailto:klnavarro&#64;gmail.com">klnavarro&#64;gmail.com</a>&gt;.</td>
</tr>
</tbody>
</table>
<div class="contents topic">
<p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
<ul class="simple">
<li><a class="reference" href="#id1" id="id6" name="id6">yaGTD - Yet Another Getting Things Done</a><ul>
<li><a class="reference" href="#licence" id="id7" name="id7">Licence</a></li>
<li><a class="reference" href="#requirements" id="id8" name="id8">Requirements</a></li>
</ul>
</li>
<li><a class="reference" href="#getting-started" id="id9" name="id9">Getting started</a><ul>
<li><a class="reference" href="#adding-tasks" id="id10" name="id10">Adding tasks</a><ul>
<li><a class="reference" href="#specifying-a-context" id="id11" name="id11">Specifying a context</a></li>
<li><a class="reference" href="#specifying-projects" id="id12" name="id12">Specifying projects</a></li>
<li><a class="reference" href="#specifying-status" id="id13" name="id13">Specifying status</a></li>
<li><a class="reference" href="#adding-references" id="id14" name="id14">Adding references</a></li>
<li><a class="reference" href="#setting-a-date" id="id15" name="id15">Setting a date</a></li>
<li><a class="reference" href="#others-options" id="id16" name="id16">Others options</a></li>
</ul>
</li>
<li><a class="reference" href="#navigating-through-the-tasks" id="id17" name="id17">Navigating through the tasks</a><ul>
<li><a class="reference" href="#viewing-tasks" id="id18" name="id18">Viewing tasks</a></li>
<li><a class="reference" href="#viewing-by-context" id="id19" name="id19">Viewing by context</a></li>
<li><a class="reference" href="#viewing-by-project" id="id20" name="id20">Viewing by project</a></li>
<li><a class="reference" href="#viewing-by-status" id="id21" name="id21">Viewing by status</a></li>
<li><a class="reference" href="#monitoring-tasks" id="id22" name="id22">Monitoring tasks</a></li>
<li><a class="reference" href="#searching-for-tasks" id="id23" name="id23">Searching for tasks</a></li>
</ul>
</li>
<li><a class="reference" href="#changing-the-tasks" id="id24" name="id24">Changing the tasks</a><ul>
<li><a class="reference" href="#replacing-a-task" id="id25" name="id25">Replacing a task</a></li>
<li><a class="reference" href="#editing-a-task" id="id26" name="id26">Editing a task</a></li>
<li><a class="reference" href="#modifying-a-task" id="id27" name="id27">Modifying a task</a></li>
<li><a class="reference" href="#appending-a-task" id="id28" name="id28">Appending a task</a></li>
<li><a class="reference" href="#extending-a-task" id="id29" name="id29">Extending a task</a></li>
</ul>
</li>
<li><a class="reference" href="#removing-a-task" id="id30" name="id30">Removing a task</a></li>
<li><a class="reference" href="#saving-your-work" id="id31" name="id31">Saving your work</a></li>
</ul>
</li>
</ul>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id6" id="id1" name="id1">yaGTD - Yet Another Getting Things Done</a></h1>
<p><strong>yaGTD</strong> project is a very simple utility designed to make the
management of your to-do list quick and easy.</p>
<p>I have several long-term projects at work, and I need reminders
to spend time on the important things that aren't too urgent.
When, in 2006, I read David Allen's personal-productivity book
<a class="reference" href="http://en.wikipedia.org/wiki/GTD">Getting Things Done</a>, I tried to apply this method on my personal
projects;  So, I needed a 'trusted system' ...</p>
<p>But why another to-do list?  There are hundreds of to-do lists on the
web, some commercial, some free, some need on-line connection while
other not, some are integrated into an email client and some web sites
were built to manage your to-do list, but I was looking for something
a little different.</p>
<p>What I wanted was something lightweight and flexible, a simple way to
carry and maintain my tasks around on a USB stick.
The program needed to be capable of running on different platforms and
must not depend on any data format or any web connection.</p>
<p>I tried several software for managing to-do lists, including the excellent
<a class="reference" href="http://www.henspace.co.uk/ikog/index.html">iKog</a> and <a class="reference" href="http://96db.com/pyGTD/">pyGTD</a> <a class="footnote-reference" href="#id3" id="id2" name="id2">[1]</a> programs, but I found that the former was missing the
notion of urgency and importance (preached by Stephen Covey into
<a class="reference" href="http://www.amazon.com/exec/obidos/ASIN/0671708635/areadersjournal">Seven Habits of Highly Effective People</a>), and the latter made it
too laborious to maintain data.</p>
<table class="docutils footnote" frame="void" id="id3" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id2" name="id3">[1]</a></td><td>pyGTD is now part of <a class="reference" href="http://www.vim.org/scripts/script.php?script_id=1699">VimGTD</a> (original ^^).</td></tr>
</tbody>
</table>
<p>And so, after several months of occasional experimentation, I decided
to write my own tool that includes the easy to use but powerful
commmand line interface from <a class="reference" href="http://www.henspace.co.uk/ikog/index.html">iKog</a> and the management of Covey
concepts from <a class="reference" href="http://96db.com/pyGTD/">pyGTD</a>.</p>
<p>To summarize, if you are looking for fancy menus and windows, go away;
But, if you are comfortable at the command line a simple plain text is
an age-old but perfect method for tracking your stuff, and <em>yaGTD</em> can
help you to manage efficiently this file.</p>
<div class="section">
<h2><a class="toc-backref" href="#id7" id="licence" name="licence">Licence</a></h2>
<p>yaGTD is a free software available under the terms of the GNU General
Public Licence.  Refer to the file COPYING (which should be included
in this distribution) for the specific terms of this licence.</p>
</div>
<div class="section">
<h2><a class="toc-backref" href="#id8" id="requirements" name="requirements">Requirements</a></h2>
<p>Python 2.3 or later must be installed on your system.</p>
<p>Theorically should work on all platforms.</p>
<p>See INSTALL file for more details on how to deploy yaGTD.</p>
</div>
</div>
<div class="section">
<h1><a class="toc-backref" href="#id9" id="getting-started" name="getting-started">Getting started</a></h1>
<p>Simply run:</p>
<pre class="literal-block">
$ python /path_to_the_file/yagtd.py
</pre>
<p>Use <tt class="docutils literal"><span class="pre">--help</span></tt> flag for more options;
Available commands, with a short description, are accessible
interactively with the <tt class="docutils literal"><span class="pre">help</span></tt> or the <tt class="docutils literal"><span class="pre">?</span></tt> command;
A summary of important commands and options is available with the
<tt class="docutils literal"><span class="pre">usage</span></tt> command.</p>
<img alt="yagtd.png" src="yagtd.png" />
<p>To add a task, simply type <tt class="docutils literal"><span class="pre">add</span></tt> followed by the task you want to
add:</p>
<pre class="literal-block">
GTD&gt; add Etudier GTD.
</pre>
<p>Then, to see all tasks in your todo list, enter <tt class="docutils literal"><span class="pre">list</span></tt> command.</p>
<div class="section">
<h2><a class="toc-backref" href="#id10" id="adding-tasks" name="adding-tasks">Adding tasks</a></h2>
<p>Add another task:</p>
<pre class="literal-block">
GTD&gt; add Etudier le Mind-mapping.
</pre>
<div class="section">
<h3><a class="toc-backref" href="#id11" id="specifying-a-context" name="specifying-a-context">Specifying a context</a></h3>
<p>Contexts are specified with the <tt class="docutils literal"><span class="pre">&#64;</span></tt> character:</p>
<pre class="literal-block">
GTD&gt; add Etudier le Mind-mapping. &#64;home

GTD&gt; add Ameliorer Rhinote (et contacter l'auteur). &#64;computer &#64;home
</pre>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id12" id="specifying-projects" name="specifying-projects">Specifying projects</a></h3>
<p>Projects are added with the <tt class="docutils literal"><span class="pre">p:</span></tt> keyword:</p>
<pre class="literal-block">
GTD&gt; add Etudier GTD. p:GTD
</pre>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id13" id="specifying-status" name="specifying-status">Specifying status</a></h3>
<p>Status is added with the <tt class="docutils literal"><span class="pre">!</span></tt> character:</p>
<pre class="literal-block">
GTD&gt; add Etudier GTD. !Next
</pre>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id14" id="adding-references" name="adding-references">Adding references</a></h3>
<p>Archive a task to a reference memo with the <tt class="docutils literal"><span class="pre">ref:</span></tt> keyword:</p>
<pre class="literal-block">
GTD&gt; add pyGTD, DevTodo, todotxt. ref:GTD
</pre>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id15" id="setting-a-date" name="setting-a-date">Setting a date</a></h3>
<p>You can, optionaly, add a task with a target (due) date with the
<tt class="docutils literal"><span class="pre">D:yyyy-mm-dd</span></tt> notation:</p>
<pre class="literal-block">
GTD&gt; add Etudier GTD. &#64;home p:GTD D:2006-12-16
</pre>
<p>And set the time required for a task by adding <tt class="docutils literal"><span class="pre">T:n[WDHM]</span></tt> keyword.</p>
<blockquote>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field"><th class="field-name">W:</th><td class="field-body">n weeks</td>
</tr>
<tr class="field"><th class="field-name">D:</th><td class="field-body">n days</td>
</tr>
<tr class="field"><th class="field-name">H:</th><td class="field-body">n hours</td>
</tr>
<tr class="field"><th class="field-name">M:</th><td class="field-body">n minutes</td>
</tr>
</tbody>
</table>
</blockquote>
<p>P.S. some shorcuts <tt class="docutils literal"><span class="pre">start</span></tt>, <tt class="docutils literal"><span class="pre">end</span></tt>, <tt class="docutils literal"><span class="pre">due</span></tt>, <tt class="docutils literal"><span class="pre">duein</span></tt> commands are
available for ease of use.</p>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id16" id="others-options" name="others-options">Others options</a></h3>
<p>We find here additional options from Stephen Covey:</p>
<ul class="simple">
<li><tt class="docutils literal"><span class="pre">U:</span></tt> urgency (5=today,4=this_week,3=this_month,2=this_quarter,1=this_year)</li>
<li><tt class="docutils literal"><span class="pre">I:</span></tt> importance (5=crucial,4=high,3=normal,2=low,1=someday)</li>
<li><tt class="docutils literal"><span class="pre">C:</span></tt> percent complete</li>
<li><tt class="docutils literal"><span class="pre">T:</span></tt> time requiered <tt class="docutils literal"><span class="pre">T:n[WDHM]</span></tt></li>
<li><tt class="docutils literal"><span class="pre">R:</span></tt> recurrence <tt class="docutils literal"><span class="pre">R:n[WDH]</span></tt></li>
<li><tt class="docutils literal"><span class="pre">S:</span></tt> start/creation date</li>
<li><tt class="docutils literal"><span class="pre">D:</span></tt> due (target) date</li>
<li><tt class="docutils literal"><span class="pre">E:</span></tt> end, closure date</li>
</ul>
</div>
</div>
<div class="section">
<h2><a class="toc-backref" href="#id17" id="navigating-through-the-tasks" name="navigating-through-the-tasks">Navigating through the tasks</a></h2>
<div class="section">
<h3><a class="toc-backref" href="#id18" id="viewing-tasks" name="viewing-tasks">Viewing tasks</a></h3>
<p>To see all or first #nb open tasks:</p>
<pre class="literal-block">
GTD&gt; list [nb]
</pre>
<p>Notice that all task are ordered by creation #id.</p>
<p>To see all tasks (even if completed):</p>
<pre class="literal-block">
GTD&gt; listall [nb]
</pre>
<p>To list tasks without context, i.e. in the inbox:</p>
<pre class="literal-block">
GTD&gt; listinbox [#nb]
</pre>
<p>P.S. to see references:</p>
<pre class="literal-block">
GTD&gt; listref [nb]
</pre>
<p>Sort tasks by priority (tasks appear only after Start date):</p>
<pre class="literal-block">
GTD&gt; sort [nb]
</pre>
<p>Remark: Priority is computed from Urgency, Importance and Due date <a class="footnote-reference" href="#id5" id="id4" name="id4">[2]</a></p>
<table class="docutils footnote" frame="void" id="id5" rules="none">
<colgroup><col class="label" /><col /></colgroup>
<tbody valign="top">
<tr><td class="label"><a class="fn-backref" href="#id4" name="id5">[2]</a></td><td>see source code <tt class="docutils literal"><span class="pre">gtd.py</span></tt></td></tr>
</tbody>
</table>
<p>Show todos only in today, and due in today:</p>
<pre class="literal-block">
GTD&gt; today [nb]
</pre>
<p>To see tasks overdue or coming up:</p>
<pre class="literal-block">
GTD&gt; overdue
GTD&gt; deadlines
</pre>
<p>Show details of task #nb:</p>
<pre class="literal-block">
GTD&gt; show nb
</pre>
<p>And, display status (percent complete) of your projects:</p>
<pre class="literal-block">
GTD&gt; status
</pre>
<p>Or, display contexts and next task for each context:</p>
<pre class="literal-block">
GTD&gt; contexts
</pre>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id19" id="viewing-by-context" name="viewing-by-context">Viewing by context</a></h3>
<p>To see your tasks by context (tasks appear only after Start date):</p>
<pre class="literal-block">
GTD&gt; order [nb]
</pre>
<p>If number is specified display maximum #nb tasks for each contexts.</p>
<p>Remark: Tasks are sorted by priority too.</p>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id20" id="viewing-by-project" name="viewing-by-project">Viewing by project</a></h3>
<p>To view #nb first tasks for each project:</p>
<pre class="literal-block">
GTD&gt; order nb project
</pre>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id21" id="viewing-by-status" name="viewing-by-status">Viewing by status</a></h3>
<p>To view #nb first tasks by status:</p>
<pre class="literal-block">
GTD&gt; order nb status
</pre>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id22" id="monitoring-tasks" name="monitoring-tasks">Monitoring tasks</a></h3>
<p>To have a set of tasks in memory:</p>
<pre class="literal-block">
GTD&gt; select id

GTD&gt; deselect id

GTD&gt; selected
</pre>
<p>Remark: The list is not saved!</p>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id23" id="searching-for-tasks" name="searching-for-tasks">Searching for tasks</a></h3>
<p>To help find tasks matching the given expression, for exemple to
retrieve all tasks into the specified context, project or status:</p>
<pre class="literal-block">
GTD&gt; search &#64;home

GTD&gt; search p:GTD

GTD&gt; search !Next
</pre>
<p>You can also, give a regular expresion:</p>
<pre class="literal-block">
GTD&gt; search .*gtd
</pre>
<p>Remark: Do not list completed tasks, use <tt class="docutils literal"><span class="pre">searchall</span></tt> command instead.</p>
</div>
</div>
<div class="section">
<h2><a class="toc-backref" href="#id24" id="changing-the-tasks" name="changing-the-tasks">Changing the tasks</a></h2>
<div class="section">
<h3><a class="toc-backref" href="#id25" id="replacing-a-task" name="replacing-a-task">Replacing a task</a></h3>
<p>To replace the entire task #id by a new one:</p>
<pre class="literal-block">
GTD&gt; replace id new task
</pre>
<p>Ex:</p>
<pre class="literal-block">
GTD&gt; replace 1 Etudier la methodology GTD. &#64;home p:GTD
</pre>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id26" id="editing-a-task" name="editing-a-task">Editing a task</a></h3>
<p>Interactively edit the task #id:</p>
<pre class="literal-block">
GTD&gt; edit id
</pre>
<p>Then, validate modifications by pressing &lt;return&gt;:</p>
<pre class="literal-block">
GTD edit&gt; editted task
</pre>
<p>Ex:</p>
<pre class="literal-block">
GTD&gt; edit 1

GTD edit&gt; Etudier la methode GTD. &#64;home p:GTD
</pre>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id27" id="modifying-a-task" name="modifying-a-task">Modifying a task</a></h3>
<p>Add / change elements of task #id but leave each other unchanged:</p>
<pre class="literal-block">
GTD&gt; modify id elements to change
</pre>
<p>Ex:</p>
<pre class="literal-block">
GTD&gt; modify 3 &#64;online
</pre>
<p>And, to modify elements of a set of tasks:</p>
<pre class="literal-block">
GTD&gt; modifyall regexp elements to change
</pre>
<p>Ex:</p>
<pre class="literal-block">
GTD&gt; modifyall p:GTD U:4 I:2
</pre>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id28" id="appending-a-task" name="appending-a-task">Appending a task</a></h3>
<p>Add new elements to task #id but leave existing elements unchanged:</p>
<pre class="literal-block">
GTD&gt; append id new elements
</pre>
<p>Ex:</p>
<pre class="literal-block">
GTD&gt; append 2 &#64;computer
</pre>
<p>And, to add new elements to several tasks:</p>
<pre class="literal-block">
GTD&gt; appendall regexp new elements
</pre>
<p>Ex:</p>
<pre class="literal-block">
GTD&gt; appendall p:GTD ref:documentation
</pre>
</div>
<div class="section">
<h3><a class="toc-backref" href="#id29" id="extending-a-task" name="extending-a-task">Extending a task</a></h3>
<p>Add more text (description) to task #id:</p>
<pre class="literal-block">
GTD&gt; extend id additional notes
</pre>
<p>Be careful: for the moment, extend the task title (only)!</p>
</div>
</div>
<div class="section">
<h2><a class="toc-backref" href="#id30" id="removing-a-task" name="removing-a-task">Removing a task</a></h2>
<p>Remove the given task #id:</p>
<pre class="literal-block">
GTD&gt; del id
</pre>
<p>Close the given task #id:</p>
<pre class="literal-block">
GTD&gt; close id
</pre>
<p>Remark: If the task has a recurrent time-delta, the task is automatically reprogrammed.</p>
</div>
<div class="section">
<h2><a class="toc-backref" href="#id31" id="saving-your-work" name="saving-your-work">Saving your work</a></h2>
<p>Save to todo.txt filename:</p>
<pre class="literal-block">
GTD&gt; save [path/to/todo.txt]
</pre>
<p>Load from a todo.txt filename:</p>
<pre class="literal-block">
GTD&gt; load path/to/todo.txt
</pre>
<p>Export into printable format (ReST):</p>
<pre class="literal-block">
GTD&gt; print [path/to/todo.rest]
</pre>
<p>Move done items from todo.txt to done.txt:</p>
<pre class="literal-block">
GTD&gt; archive
</pre>
<p>--
MiKael NAVARRO</p>
</div>
</div>
</div>
</body>
</html>
yagtd 0.3.4-1 / usr / share / doc / yagtd / rest / yagtd.html
