-Welcome to your wiki! This is the default page we've installed for your convenience. Go ahead and edit it.
-This wiki uses the [[http://www.wikicreole.org/|Creole]] syntax, and is fully compatible with the 1.0 specification.
-The wiki itself is actually a hg repository, which means you can clone it, edit it locally/offline, add images or any other file type, and push it back to us. It will be live immediately.
-$ hg clone http://bitbucket.org/trevor/timebook/wiki/
-Wiki pages are normal files, with the .wiki extension. You can edit them locally, as well as creating new ones.
-=== Syntax highlighting ===
-You can also highlight snippets of text, we use the excellent [[http://www.pygments.org/|Pygments]] library.
-Here's an example of some Python code:
- formatter = lambda t: "funky"+t
-You can check out the source of this page to see how that's done, and make sure to bookmark [[http://pygments.org/docs/lexers/|the vast library of Pygment lexers]], we accept the 'short name' or the 'mimetype' of anything in there.
+Timebook is a small utility which aims to be a low-overhead way of
+tracking what you spend time on. It can be used to prepare annotated
+time logs of work for presentation to a client, or simply track how you
+spend your free time. Timebook is implemented as a python script which
+maintains its state in a sqlite3 database.
+Timebook maintains a list of *timesheets* -- distinct lists timed
+*periods*. Each period has a start and end time, with the exception of the
+most recent period, which may have no end time set. This indicates that
+this period is still running. Timesheets containing such periods are
+considered *active*. It is possible to have multiple timesheets active
+simultaneously, though a single time sheet may only have one period
+Interactions with timebook are performed through the ``t`` command on
+the command line. ``t`` is followed by one of timebook's subcommands.
+Often used subcommands include ``start``, ``stop``, ``switch``,
+``info``, ``list`` and ``show``. Commands may be abbreviated as long as
+they are unambiguous: thus ``t switch foo`` and ``t sw foo`` are
+identical. Likewise, commands which display timesheets accept
+abbreviated timesheet names. ``t show f`` is thus equivalent to ``t show
+foo`` if ``foo`` is the only timesheet which begins with "f". Note that
+this does not apply to ``t switch``, since this command also creates
+timesheets. (Using the earlier example, if ``t switch f`` is entered, it
+would thus be ambiguous whether a new timesheet ``f`` or switching to
+the existing timesheet ``foo`` was desired).
+The basic usage is as follows::
+ $ t start document timebook
+The first command, ``t switch writing``, switches to the timesheet
+"writing" (or creates it if it does not exist). ``t start document
+timebook`` creates a new period in the current timesheet, and annotates
+it with the description "document timebook". Note that this command
+would be in error if the ``writing`` timesheet was already active.
+Finally, ``t stop`` records the current time as the end time for the
+most recent period in the ``writing`` timesheet.
+To display the current timesheet, invoke the ``t show`` command::
+ Day Start End Duration Notes
+ Mar 14, 2009 19:53:30 - 20:06:15 0:12:45 document timebook
+ 20:07:02 - 0:00:01 write home about timebook
+Each period in the timesheet is listed on a row. If the timesheet is
+active, the final period in the timesheet will have no end time. After
+each day, the total time tracked in the timesheet for that day is
+listed. Note that this is computed by summing the durations of the
+periods beginning in the day. In the last row, the total time tracked in
+To get a complete listing of commands, see the output of ``t --help``.