]> oss.titaniummirror.com Git - oss-web.git/blobdiff - in/git-utils.md
Change TOP link to Home and NEWS to News. Cleaner output in breadcrumbs.
[oss-web.git] / in / git-utils.md
index 31e8f223e19ad1aac0fca2d40ecddd9dbccce987..7185502cecbbd944daf9e6ca033f00ade2bce67d 100644 (file)
@@ -1,9 +1,9 @@
 title: GIT Utilities
 linktitle: git-utils
-parent: TOP
+parent: Home
 ctime: 2009-12-10
 
-Repositories: [git-utils](TBD).
+Repositories: [git-utils](/gitweb/?p=git-utils.git;a=summary).
 
 # GIT
 
@@ -11,17 +11,22 @@ Read about [GIT](http://git-scm.com) here.
 
 # Utilities
 
-Over time, TMI is starting to collect a number of small utilities for git.
-These are available from our [git-utils](TBD) repository.  Each utility has
-a man page describing its operation, so we'll only highlight the basics here.
+TMI is starting to collect a number of small utilities for git.  Each utility
+has a man page describing its operation.
 
-* git-empty-branch.  Create an empty branch in a local git repository.
+* `git-empty-branch`.  Create an empty branch in a local git repository.
 
-* git-local.  Store local branches temporarily in a shared git repository,
-  probably hosted on a server used by the local development team.  git-local
-  offers upload, download, remove and list operations.
+* `git-local`.  Store local branches in a shared git repository under a private
+  namespace.  Upload, download, remove and list operations are provided.  We
+  use this tool to backup up local commits not yet suitable for pushing into a
+  local shared branch.
 
-* git-publish-branch.  A shell version of a ruby script created by William
+* `git-publish-branch`.  A shell version of the ruby script created by William
   Morgan.  See his [git utilities page](http://git-wt-commit.rubyforge.org).
-  This has been a locally popular utility, and we did not want to see ruby
-  effectively become yet another pre-requisite for git.
+  We did not want to have to install ruby just for this one little utility.
+
+# Installation
+
+To install the utilities, copy the scripts to `/usr/local/bin` and ensure they
+have execute permission.  Then copy the `*.1` files, which are the man pages,
+to `/usr/local/man/man1`.