X-Git-Url: https://git.madduck.net/code/vcsh.git/blobdiff_plain/2a61549feb63117b5ffaa6fef5f80feb293b3dbe..5314563bc7d91f82d74478d42a100ffdd399ceb2:/doc/vcsh.1.ronn diff --git a/doc/vcsh.1.ronn b/doc/vcsh.1.ronn index 2705377..e06c5f9 100644 --- a/doc/vcsh.1.ronn +++ b/doc/vcsh.1.ronn @@ -3,17 +3,28 @@ vcsh(1) - manage and sync config files via git ## SYNOPSIS -`vcsh` init - `vcsh` clone [] -`vcsh` run git command +`vcsh` delete + +`vcsh` enter + +`vcsh` help + +`vcsh` init `vcsh` list -`vcsh` seed-gitignore +`vcsh` rename + +`vcsh` run + +`vcsh` seed-gitignore + +`vcsh` setup + +`vcsh` -`vcsh` help ## DESCRIPTION @@ -35,24 +46,46 @@ A sample configuration for `vcsh` and `mr` can be found at ## OPTIONS +* clone: + Clone an existing repository. + +* delete: + Delete an existing repository. + +* enter: + Enter repository; spawn new <$SHELL>. + +* help: + Display help. + * init: Initialize an empty repository. -* clone: - Clone an existing repository. +* list: + List all local vcsh repositories. + +* 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. -* list: - List all local vcsh repositories. + 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. * seed-gitignore: Seed .gitignore.d/ from git ls-files. -* help: - Display help. +* setup: + Set up repository with recommended settings. + +* : + Shortcut to run `vcsh` on a repo. Will prepend `git` to by itself. ## ENVIRONMENT