]> git.madduck.net Git - code/vcsh.git/blobdiff - doc/vcsh.1.ronn

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:

Make debugging more verbose
[code/vcsh.git] / doc / vcsh.1.ronn
index 541dba0bbffd394f0e16e64e17f87455040a74c3..e06c5f901a8a889c36e129ca755d4ae3ee2637a9 100644 (file)
@@ -3,16 +3,29 @@ vcsh(1) - manage and sync config files via git
 
 ## SYNOPSIS
 
-`vcsh` init <foo>
-
 `vcsh` clone <url> [<location>]
 
-`vcsh` run <foo> git command
+`vcsh` delete <repo>
 
-`vcsh` list
+`vcsh` enter <repo>
 
 `vcsh` help
 
+`vcsh` init <repo>
+
+`vcsh` list
+
+`vcsh` rename <repo> <newname>
+
+`vcsh` run <repo> <command>
+
+`vcsh` seed-gitignore <repo>
+
+`vcsh` setup <repo>
+
+`vcsh` <repo> <gitcommand>
+
+
 ## DESCRIPTION
 
 `vcsh` allows you to have several `git`(1) repositories, all maintaining their
@@ -33,21 +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
+  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 <repo>
+  it accepts <path>, 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.
 
-* help:
-  Display help
+* seed-gitignore:
+  Seed .gitignore.d/<repo> from git ls-files.
+
+* setup:
+  Set up repository with recommended settings.
+
+* <repo> <gitcommand>:
+  Shortcut to run `vcsh` on a repo. Will prepend `git` to <command> by itself.
 
 ## ENVIRONMENT