gtg team mailing list archive

[Bertrand Rousseau <bertrand.rousseau@xxxxxxxxx>]

Bertrand Rousseau has proposed merging lp:~bertrand-rousseau/gtg/bugfix-940833-897440-update-readme into lp:gtg.

Requested reviews:
  Gtg developers (gtg)
Related bugs:
  Bug #897440 in Getting Things GNOME!: "Update README file"
  https://bugs.launchpad.net/gtg/+bug/897440
  Bug #940833 in Getting Things GNOME!: "V0.2.9: missing dependencies in README file"
  https://bugs.launchpad.net/gtg/+bug/940833

For more details, see:
https://code.launchpad.net/~bertrand-rousseau/gtg/bugfix-940833-897440-update-readme/+merge/120008
-- 
https://code.launchpad.net/~bertrand-rousseau/gtg/bugfix-940833-897440-update-readme/+merge/120008
Your team Gtg developers is requested to review the proposed merge of lp:~bertrand-rousseau/gtg/bugfix-940833-897440-update-readme into lp:gtg.

=== modified file 'HACKING'
--- HACKING	2012-07-13 17:24:28 +0000
+++ HACKING	2012-08-16 19:39:20 +0000
@@ -2,11 +2,6 @@
 GTG Hacking Guide
 =================
 
-Code reference documentation is online at:
-
-   http://allievi.sssup.it/GTG/
-
-
 Testing
 -------
 

=== modified file 'README'
--- README	2012-07-13 17:24:28 +0000
+++ README	2012-08-16 19:39:20 +0000
@@ -1,9 +1,9 @@
 ====== Getting Things GNOME! ======
 
-Getting Things GNOME! (GTG) is a personal organizer for the GNOME desktop
-environment inspired by the Getting Things Done (GTD) methodology. GTG is
-designed with flexibility, adaptability, and ease of use in mind so it can be
-used as more than just GTD software.
+Getting Things GNOME! (GTG) is a personal task and TODO list items organizer
+for the GNOME desktop environment inspired by the Getting Things Done (GTD)
+methodology. GTG is designed with flexibility, adaptability, and ease of use
+in mind so it can be used as more than just GTD software.
 
 GTG is intended to help you track everything you need to do and need to know,
 from small tasks to large projects.
@@ -11,12 +11,15 @@
 ===== Dependencies =====
 
 GTG depends on the following packages:
+
  * Python, version 2.6 or above
  * PyGTK
+ * python-support
  * python-configobj
  * python-xdg
  * python-liblarch 
- * python-liblarch-gtk
+ * python-dbus
+ * yelp (to read GTG documentation)
  * python-suds (dependency of MantisBT backend)
  * python-evolution (dependency of Evolution backend)
 
@@ -25,10 +28,13 @@
 Please refer to your system documentation for information on how to install
 these modules if they're not currently available.
 
-To install these packages on Debian-based systems, execute the following
-command:
-    $ sudo apt-get install python-gtk2 python-gnome2 python-glade2 \
-         python-xdg python-configobj python-pydoctor
+To install the all the required packages providing the basic features on
+Debian-based systems, execute the following command:
+    $ sudo apt-get install python-support python-gtk2 python-gnome2 \
+         python-glade2 python-xdg python-configobj python-liblarch yelp
+
+To enable API documentation generation, execute this command:
+    $ sudo apt-get install python-pydoctor
 
 For evolution backend, you need python-evolution by command:
     $ sudo apt-get install python-evolution
@@ -36,8 +42,6 @@
 For MantisBT backend, you need python-suds by command:
     $ sudo apt-get install python-suds
 
-Note that the python-pydoctor package is broken in karmic.
-
 ===== Installing and Running =====
 
 To install GTG, either unpack the tarball:
@@ -65,28 +69,52 @@
 
     $ sudo python setup.py install --install-layout=deb
 
-==== Usage ====
-
-When writing a task, keep in mind that:
- 1) A line beginning with "-" will automatically create a subtask on that line
- 2) A word beginning with "@" is a tag
-
-===== Quick add =====
-
-In the quickadd line you can use "attribute:argument" with any title.
-Valid attributes are: "tags", "defer", "due"
-E.g.:
- "due:friday task description"
- "more work due:today"
- "due:tomorrow foo work"
- "my bar task tags:@foo"
-
-
-Please refer to http://gtg.fritalk.com/pages/documentation
+==== How To Use GTG? ====
+
+Please refer to our documentation to get a thorough explanation on how GTG
+works.
+
+To do this, you will need the yelp help viewer. On Debian-based systems, you
+can install yelp by executing this command:
+
+    $ sudo apt-get install yelp
+
+You can then view the documentation either by accessing it through GTG (press
+F1 or use the help menu), or by using the command line using the following
+command:
+
+    $ yelp help:gtg
+
+If you want to read the documentation directly from the source code, use
+this command (from the source root dir):
+
+    $ yelp doc/userdoc/C/index.page
+
+==== Using GTG from the command line ====
+
+GTG provides two command line tools that allows to interact with GTG:
+
+ * gtcli
+ * gtg_new_task
+
+gtcli provides many options to display, list or edit tasks. gtg_new_task
+provides a GTG command line client that allows to easily add tasks.
+
+If you want to know more about how to use these tools, please refer to the
+tools man page.
+
+If you have installed gtg, you can access those by executing:
+
+    $ man gtcli
+    $ man gtg_new_task
 
 ===== Want to know more? =====
 
  * GTG Website: http://gtg.fritalk.com/
  * GTG project page on Launchpad: https://launchpad.net/gtg
  * GTG Wiki: http://live.gnome.org/gtg/
- * GTG code documentation:  http://allievi.sssup.it/GTG/
+
+Feel free to join our user mailing-list to receive news about GTG. You can
+register on this mailing-list from this page: https://launchpad.net/~gtg-user
+
+Thanks for using GTG!