docs

Readme.md

@@ -811,31 +811,37 @@ a watcher-like behaviour:
 
      $ watch make
 
-## bin/jade
+## jade(1)
 
-Output html to _stdout_:
+```
+
+Usage: jade [options] [dir|file ...]
+
+Options:
 
-    jade < my.jade > my.html
+  -h, --help       output usage information
+  -v, --version    output the version number
+  -o, --obj <str>  javascript options object
+  -O, --out <dir>  output the compiled html to <dir>
 
-Generate _examples/*.html_:
+Examples:
 
-    jade examples/*.jade
+  # translate jade the templates dir
+  $ jade templates
 
-Pass options:
+  # create {foo,bar}.html
+  $ jade {foo,bar}.jade
 
-    jade examples/layout.jade --options '{ locals: { title: "foo" }}'
+  # jade over stdio
+  $ jade < my.jade > my.html
 
-Usage info:
+  # jade over stdio
+  $ echo "h1 Jade!" | jade
 
-    Usage: jade [options]
-                [path ...]
-                < in.jade > out.jade  
-    Options:
-      -o, --options <str>  JavaScript options object passed
-      -h, --help           Output help information
-      -w, --watch          Watch file(s) or folder(s) for changes and re-compile
-      -v, --version        Output jade version
-      --out <dir>          Output the compiled html to <dir>
+  # foo, bar dirs rendering to /tmp
+  $ jade foo bar --out /tmp 
+
+```
 
 ## License