diff --git a/README.md b/README.md index 12b4932..0e37abe 100644 --- a/README.md +++ b/README.md @@ -8,24 +8,23 @@ This tool was created in support of the ["Orthogonal Git Workflow"][orthogonal-g A `Makefile` is provided for running tests and producing documentation for Grawkit. Run `make help` in the project root for more information. -A full test-suite is provided (depending only on `make` and `awk`), which should serve as a good example of the existing feature-set. +A full test-suite is provided (depending only on `make` and `awk`), which should serve as a good example of the existing feature-set. Run it with `make test`. -## Status & Examples +## Installation -Grawkit has basic support for common `git` commands such as `git branch`, `git tag` and `git merge`, allowing for fairly complex graphs. The integrated test-suite serves as an example, presented here: +Copy the included `grawkit` AWK script into your local search path (most commonly +`$HOME/.local/bin`), or just use it directly in this folder. - - - - - - - - - - - - - - - - - - - - - - - - - -
Command-LineGenerated Graph
git commit -m "Adding a new commit"
-git commit
git commit -m "Commit on master"
+## Status & Usage
+
+Grawkit has basic support for common `git` commands such as `git branch`, `git tag` and `git merge`, allowing for fairly complex graphs. The integrated test-suite serves as an example, check the `tests` folder for more.
+
+In order to use this tool, either run the `grawkit` executable against a file containing supported
+`git` commands (any command not recognized will be silently ignored), or pass these in standard
+input. For instance, given the following file `test.txt`:
+
+```sh
+git commit -m "Commit on master"
 git commit -m "More stuff"
 
 git branch test-stuff
@@ -35,78 +34,20 @@ git commit -m 'Testing stuff'
 git commit
 
 git checkout master
-git commit
git branch test-merging
-
-git commit -m "Commit on master"
-git commit -m "Still on master"
-
-git checkout test-merging
-git commit -m 'A sample commit'
-
-git checkout master
-git commit -m "Another master commit"
-
-git merge test-merging
git commit -m "Commit on master"
-
-git branch test-first
-git branch test-second
-
-git commit -m "Still on master"
-git tag v.1.0.0
-
-git checkout test-first
 git commit
+```
 
-git branch test-third
+You can execute either:
 
-git checkout test-second
-git commit
-git merge test-first
-git tag v.2.0.0-rc1
+```
+cat test.txt | grawkit
+# or
+grawkit test.txt
+```
 
-git checkout master
-git merge test-second
+Which will produce SVG markup to standard output, rendered as:
 
-git checkout test-third
-git commit
git branch develop
-git checkout develop
-git commit
-
-git branch feature/XYZ-12_fix-foo
-git checkout feature/XYZ-12_fix-foo
-git commit
-git commit
-
-git checkout develop
-git branch feature/ZZ-704_take-it-to-the-limit
-git checkout feature/ZZ-704_take-it-to-the-limit
-git commit
-
-git checkout develop
-git merge feature/XYZ-12_fix-foo
-
-git branch feature/ABC-66_make-bar
-git checkout feature/ABC-66_make-bar
-git commit
-git commit
-
-git checkout develop
-git merge feature/ZZ-704_take-it-to-the-limit
+ ## License