X-Git-Url: https://git.madduck.net/code/vcsh.git/blobdiff_plain/519af748f900277d8ecac0594f70b24423deef98..c1b6930b5e9ec3e3871ed04150f100b1ff12aa8f:/doc/vcsh.1.ronn diff --git a/doc/vcsh.1.ronn b/doc/vcsh.1.ronn index f286dc0..7ebf9f5 100644 --- a/doc/vcsh.1.ronn +++ b/doc/vcsh.1.ronn @@ -25,7 +25,9 @@ vcsh(1) - manage config files in $HOME via fake bare git repositories `vcsh` run -`vcsh` setup +`vcsh` upgrade + +`vcsh` version `vcsh` which @@ -110,8 +112,11 @@ an interactive user. This is needed to support mr and other scripts properly and of no concern to an interactive user. -* setup: - Set up repository with recommended settings. +* upgrade: + Upgrade repository to currently recommended settings. + +* version: + Print version information. * which : Find in name of any tracked file. @@ -146,14 +151,16 @@ executed in the context of your shell. Interesting knobs you can turn: * <$VCSH_GITIGNORE>: - Can be either or . + Can be , , or . - will seed the repo-specific <.gitignore> with all file and directory + will seed the repo-specific ignore file with all file and directory names which `git ls-files` returns. will descend through all directories recursively additionally to the above. + will not write any ignore file. + Defaults to . Less interesting knobs you could turn: @@ -202,7 +209,7 @@ same rules as above apply. The dot between the repository's name and the hook is mandatory, though. Available hooks are , , , , -, and . If you need more, vcsh is trivial to patch, +, and . 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 @@ -232,8 +239,9 @@ None are known at this time, but reports and/or patches are more than welcome. ## INTEROPERABILITY -If you rely on `git submodule`, use `git` 1.7.12 or later. Earlier versions -do not clean internal variables properly before descending into a submodule. +If you rely on `git submodule` use `git` 1.7.12 or later. Earlier versions +do not clean internal variables properly before descending into submodules, +resulting in unhappy end users. ## HISTORY