X-Git-Url: https://git.madduck.net/code/vcsh.git/blobdiff_plain/e73e39bb031b0958dfe7f01686f7cc1467a09c6d..32150700f045d937d0362f690b01303aa7ea2131:/doc/vcsh.1.ronn diff --git a/doc/vcsh.1.ronn b/doc/vcsh.1.ronn index 015e76e..6755768 100644 --- a/doc/vcsh.1.ronn +++ b/doc/vcsh.1.ronn @@ -3,11 +3,11 @@ vcsh(1) - manage and sync config files via git ## SYNOPSIS -`vcsh` clone [] +`vcsh` clone [] `vcsh` delete -`vcsh` exit +`vcsh` enter `vcsh` help @@ -15,14 +15,22 @@ vcsh(1) - manage and sync config files via git `vcsh` list +`vcsh` list-tracked + +`vcsh` list-tracked-by + +`vcsh` rename + `vcsh` run -`vcsh` seed-gitignore +`vcsh` setup -`vcsh` use +`vcsh` write-gitignore `vcsh` +`vcsh` + ## DESCRIPTION @@ -42,6 +50,10 @@ vcsh. That being said, you can easily use `vcsh` without `mr` if you prefer. A sample configuration for `vcsh` and `mr` can be found at *https://github.com/RichiH/vcsh_mr_template* +Please note that you can always use a path instead of a name for . +This is needed to support mr and other scripts properly and of no concern to +an interactive user. + ## OPTIONS * clone: @@ -50,8 +62,8 @@ A sample configuration for `vcsh` and `mr` can be found at * delete: Delete an existing repository. -* exit: - Exit repository; unset ENV +* enter: + Enter repository; spawn new <$SHELL>. * help: Display help. @@ -62,19 +74,38 @@ A sample configuration for `vcsh` and `mr` can be found at * list: List all local vcsh repositories. +* list-tracked: + List all files tracked by vcsh. + +* list-tracked-by: + List files tracked by a repository. + +* rename: + Rename a repository. + * run: Run command with <$GIT_DIR> and <$GIT_WORK_TREE> set. Allows you to run any and all commands without any restrictions. Use with care. -* seed-gitignore: - Seed .gitignore.d/ from git ls-files. + Please note that there is a somewhat magic feature for run. Instead of + it accepts , as well. Anything that has a slash in it will be assumed to + be a path. `vcsh run` will then operate on this directory instead of the one + normally generated from the repository's name. + This is needed to support mr and other scripts properly and of no concern to + an interactive user. -* use: - Use repository; set ENV +* setup: + Set up repository with recommended settings. + +* write-gitignore: + Write .gitignore.d/ via git ls-files. * : Shortcut to run `vcsh` on a repo. Will prepend `git` to by itself. +* : + Shortcut to run `vcsh enter `. + ## ENVIRONMENT As noted earlier, `vcsh` will set <$GIT_DIR> and <$GIT_WORK_TREE> to the