Merge pull request #18 from lordvlad/clock

update readme

Author: jwerle

_posts/2015-04-19-clock.md

@@ -6,10 +6,6 @@ category: bash
 tags: [bash, utility, time]
 ---
 
-# clock
-
-Track your working hours on the command line
-
 # Install
 
 Available as a [bpkg](http://www.bpkg.io/)
@@ -19,24 +15,51 @@ bpkg install [-g] lordvlad/clock
 
 # Usage
 ```sh
-clock <command> [<task>] [-m <message>] [-f <clockfile>] [-t <dir>]
+clock <command> [<task>] [<options>]
 ```
 
 ## Commands
 -  `clock help`    show the help
 -  `clock in`      clock in, will clock out any running task
 -  `clock out`     clock out
 -  `clock log`     show all log entries, or log entries for `<task>`
--  TODO `clock list`    show sums for all tasks
+-  `clock list`    show sums for all tasks
 
 ## Task
   If no task is specified, the current working directory
-  will be used as task specifier
+  will be used as task identifier
+
+
 
 ## Options
 -  `-m|--message`      record additional message when clocking in/out
--  `-f|--file`         where to save the clocks, defaults to $HOME/.clocks
+-  `-f|--file`         where to save the clocks, defaults to `$HOME/.clocks`
+-  `   --by-task`      sort log entries by task for `clock log`
+-  `   --gt=DATE`      with `clock log`, show only entries after `DATE`, with `clock list` sum up only entries after `DATE`.
+                       `DATE` can be any string that unix' `date` understands
+- `    --lt=DATE`      with `clock log`, show only entries before `DATE`, with `clock list` sum up only entries before `DATE`.
+                       `DATE` can be any string that unix' `date` understands
+
+# Examples
+
+```sh
+$ mkdir -p tasks/{work,sleep}
+$ clock in tasks/work
+> clocked in /home/lordvlad/tasks/work
+$ clock in tasks/sleep
+> clocked out /home/lordvlad/tasks/work
+> clocked in /home/lordvlad/tasks/sleep
+$ clock out
+> clocked out /home/lordvlad/tasks/sleep
+$ clock log
+> Tue 21 Apr 2015 06:31:24 PM UTC 00:01:23        /home/lordvlad/tasks/work
+> Tue 21 Apr 2015 06:32:47 PM UTC 00:00:04        /home/lordvlad/tasks/sleep
+$ clock list
+> 00:00:04        /home/lordvlad/tasks/sleep
+> 00:01:23        /home/lordvlad/tasks/work
+```
+
 
 # Links
-* [Source Code](https://github.com/lordvlad/clock)
-* [Author](https://github.com/lordvlad)
+* [Source Code (Github)](https://github.com/lordvlad/clock)
+* [Author (lordvlad)](https://github.com/lordvlad)