]> git.madduck.net Git - code/vcsh.git/commitdiff

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

Improve hook documentation
authorRichard Hartmann <richih.mailinglist@gmail.com>
Mon, 16 Jan 2012 00:55:47 +0000 (01:55 +0100)
committerRichard Hartmann <richih.mailinglist@gmail.com>
Mon, 16 Jan 2012 00:55:47 +0000 (01:55 +0100)
Makefile
doc/hooks [new file with mode: 0644]
doc/vcsh.1.ronn

index 341da78154ce3b2b6fdf96e83a3f5e6686be0d8a..7c040770d67ece18dafcfd61d0fc314fd208c3d8 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -12,6 +12,7 @@ install: all
        install -m 0644 $(manpages)  $(DESTDIR)$(PREFIX)/share/man/man1
        install -d $(DESTDIR)$(PREFIX)/share/doc/vcsh
        install -m 0644 README.md $(DESTDIR)$(PREFIX)/share/doc/vcsh
        install -m 0644 $(manpages)  $(DESTDIR)$(PREFIX)/share/man/man1
        install -d $(DESTDIR)$(PREFIX)/share/doc/vcsh
        install -m 0644 README.md $(DESTDIR)$(PREFIX)/share/doc/vcsh
+       install -m 0644 doc/hooks $(DESTDIR)$(PREFIX)/share/doc/vcsh
        install -d $(DESTDIR)$(PREFIX)/share/zsh/vendor-completions
        install -m 0644 _vcsh $(DESTDIR)$(PREFIX)/share/zsh/vendor-completions
 
        install -d $(DESTDIR)$(PREFIX)/share/zsh/vendor-completions
        install -m 0644 _vcsh $(DESTDIR)$(PREFIX)/share/zsh/vendor-completions
 
diff --git a/doc/hooks b/doc/hooks
new file mode 100644 (file)
index 0000000..199123f
--- /dev/null
+++ b/doc/hooks
@@ -0,0 +1,7 @@
+Available hooks are:
+pre-enter
+post-enter
+pre-run
+post-run
+pre-setup
+post-setup
index bcea71cf4247e63e558f2b5ffc3c23708783c1f1..6a04b13dabcacd205e303eb7dcb92c9bf5be8958 100644 (file)
@@ -118,17 +118,21 @@ placed in <$XDG_CONFIG_HOME/vcsh/hooks-available>. From there, they can be
 soft-linked into <$XDG_CONFIG_HOME/vcsh/hooks-enabled>; `vcsh` will only
 execute hooks that are in this directory.
 
 soft-linked into <$XDG_CONFIG_HOME/vcsh/hooks-enabled>; `vcsh` will only
 execute hooks that are in this directory.
 
-Hooks follow a simple format. `pre-run` will be run before anything is run.
+Hooks follow a simple format. <pre-run> will be run before anything is run.
 If you want to have more than one script for a certain hook, just append
 If you want to have more than one script for a certain hook, just append
-any kind of string to order them. A system of `pre-run`, `pre-run.10`,
-`pre-run.20` etc is suggested; other options would be `pre-run-10` or
-`pre-run.sh`. A dot after the hook name is optional.
+any kind of string to order them. A system of <pre-run>, <pre-run.10>,
+<pre-run.20> etc is suggested; other options would be <pre-run-10> or
+<pre-run.sh>. A dot after the hook name is optional.
 
 
-If you want to create hooks for a specific `vcsh` repository, simply prepend
-the repository's name, followed by a dot, i.e. `zsh.pre-run`. Otherwise, the
+If you want to create hooks for a specific <vcsh> repository, simply prepend
+the repository's name, followed by a dot, i.e. <zsh.pre-run>. Otherwise, the
 same rules as above apply. The dot between the repository's name and the hook
 is mandatory, though.
 
 same rules as above apply. The dot between the repository's name and the hook
 is mandatory, though.
 
+Available hooks are <pre-enter>, <post-enter>, <pre-run>, <post-run>,
+<pre-setup>, and <post-setup>. If you need more, vcsh is trivial to patch,
+but please let upstream know so we can ship them by default.
+
 ## DETAILED HOWTO AND FURTHER READING
 
 Man pages are intended to be short and thus often useless to glean best
 ## DETAILED HOWTO AND FURTHER READING
 
 Man pages are intended to be short and thus often useless to glean best