summaryrefslogtreecommitdiffstats
path: root/cobra
diff options
context:
space:
mode:
authortv <tv@also>2011-06-20 00:37:12 +0200
committertv <tv@also>2011-06-20 00:37:12 +0200
commit73aa6e838658a6f38c9de2f01990295576b69ad5 (patch)
treef25c75e12bbf06d193a515c258f23903f607f53b /cobra
parentfad4b8801c4303490b1919b623b009aba3064213 (diff)
cobra: initial README
Diffstat (limited to 'cobra')
-rw-r--r--cobra/README33
1 files changed, 33 insertions, 0 deletions
diff --git a/cobra/README b/cobra/README
new file mode 100644
index 00000000..145ecd14
--- /dev/null
+++ b/cobra/README
@@ -0,0 +1,33 @@
+
+# usage
+cobra [target...]
+
+# description
+cobra tries to satisfies all specified targets and all of it dependencies.
+
+# targets
+targets can be a lot of different things, e.g. directories
+
+## dirctory targets
+try to do the right thing when the cobra search path contains a directory
+that contains an index.{js,sh,py,etc.} file.
+
+## cobra search path
+like your sh's PATH
+
+## example: cobra as some kind of make
+$ echo $COBRA_PATH
+.
+$ ls .
+foo/ bar/ baz/
+$ cat foo/cobra.json
+{ "deps": "bar", "baz" }
+$ cat bar/cobra.json
+No such file or directory
+$ cat baz/cobra.json
+No such file or directory
+$ cobra foo
+[cobra bar]
+[cobra baz]
+[cobra foo]
+$ exit