summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorZack Hobson2013-11-21 14:52:11 -0800
committerZack Hobson2013-11-21 14:52:11 -0800
commitf0f2c7e2954d061079ed51cb6c4ce98e5b3f4127 (patch)
treef51e83e2a9ca32d6881a801648543bf3496c3071
parent4e755f701276b154bc3553e32ea45f5236a1e668 (diff)
downloadhcl-f0f2c7e2954d061079ed51cb6c4ce98e5b3f4127.tar.bz2
Documentation improvements.
-rw-r--r--.document2
-rw-r--r--HACKING.markdown6
-rw-r--r--Rakefile5
-rw-r--r--lib/hcl/app.rb5
4 files changed, 13 insertions, 5 deletions
diff --git a/.document b/.document
index 2a525aa..7ec2c89 100644
--- a/.document
+++ b/.document
@@ -1 +1 @@
---files CHANGELOG
+- CHANGELOG HACKING.markdown
diff --git a/HACKING.markdown b/HACKING.markdown
index a2066b8..b158189 100644
--- a/HACKING.markdown
+++ b/HACKING.markdown
@@ -14,3 +14,9 @@ To run HCl in place (e.g. for testing out local changes) you can use bundle exec
bundle exec bin/hcl
+## Generating API documentation
+
+To generate and view the API documentation:
+
+ rake doc
+ open doc/index.html
diff --git a/Rakefile b/Rakefile
index 2e28c79..9a6f1d3 100644
--- a/Rakefile
+++ b/Rakefile
@@ -9,7 +9,6 @@ end
task :default => :test
require 'yard'
-YARD::Rake::YardocTask.new do |t|
- t.options = %w[--files CHANGELOG]
-end
+YARD::Rake::YardocTask.new
+task :doc => :yard
diff --git a/lib/hcl/app.rb b/lib/hcl/app.rb
index c86e3c5..970bd6d 100644
--- a/lib/hcl/app.rb
+++ b/lib/hcl/app.rb
@@ -87,12 +87,15 @@ Commands:
# start a task using an alias
hcl [start] @<task_alias> [+<time>] [<message>]
- # add a line to your running timer
+ # add a line to a running timer
hcl note <message>
# stop a running timer
hcl stop [<message>]
+ # log a task and time without leaving a timer running
+ hcl log @<task_alias> [+<time>] [<message>]
+
# resume the last stopped timer or a specific task
hcl resume [@<task_alias>]