summaryrefslogtreecommitdiff
path: root/_posts/2009-07-04-git-html-help.textile
diff options
context:
space:
mode:
authortekkub <tekkub@gmail.com>2009-07-06 14:30:45 -0600
committertekkub <tekkub@gmail.com>2009-07-06 14:30:45 -0600
commit09852073b638c0f3130665c044595dadf44da817 (patch)
tree727088f1c11f921cfe140e02bd845d498569f2e1 /_posts/2009-07-04-git-html-help.textile
parentd64bd8c2c3c6ba462780f734568f5963ce56332d (diff)
Rework index lists
Diffstat (limited to '_posts/2009-07-04-git-html-help.textile')
-rw-r--r--_posts/2009-07-04-git-html-help.textile49
1 files changed, 49 insertions, 0 deletions
diff --git a/_posts/2009-07-04-git-html-help.textile b/_posts/2009-07-04-git-html-help.textile
new file mode 100644
index 0000000..7ccfd9f
--- /dev/null
+++ b/_posts/2009-07-04-git-html-help.textile
@@ -0,0 +1,49 @@
+---
+layout: guide
+title: Git HTML help
+subtitle: This guide will help you install the local git HTML help files and set git to use them by default instead of the man pages.
+description: How to install the local git HTML help files
+categories: setup
+---
+
+Most git installations will install man files for help, but not the HTML help files (the same files seen on git's "online documentation":http://www.kernel.org/pub/software/scm/git-core/docs/). Installing these help files is a fairly simple process.
+
+h3. OSX
+
+The following commands were run on an installation of the "git-osx-installer":http://code.google.com/p/git-osx-installer/. Your documentation path may be different, pay attention to the output of @git help --web commit@ for where your git is set to look for the HTML files.
+
+<pre>$ git help --web commit
+fatal: '/usr/local/git/share/doc/git-doc': not a documentation directory.
+
+$ git clone git://git.kernel.org/pub/scm/git/git.git
+Initialized empty Git repository in /Users/tekkub/git/.git/
+remote: Counting objects: 101588, done.
+remote: Compressing objects: 100% (27214/27214), done.
+remote: Total 101588 (delta 73797), reused 100304 (delta 72681)
+Receiving objects: 100% (101588/101588), 24.50 MiB | 377 KiB/s, done.
+Resolving deltas: 100% (73797/73797), done.
+Checking out files: 100% (1652/1652), done.
+
+$ cd git
+$ make quick-install-html
+GIT_VERSION = 1.6.3.3.385.g60647
+make -C Documentation quick-install-html
+ GEN doc.dep
+ SUBDIR ../
+make[2]: `GIT-VERSION-FILE' is up to date.
+ SUBDIR ../
+make[2]: `GIT-VERSION-FILE' is up to date.
+'/bin/sh' ./install-doc-quick.sh origin/html /Users/tekkub/share/doc/git-doc
+
+$ cd /usr/local/git/share/
+$ sudo mkdir doc
+$ cd doc/
+$ sudo mv ~/share/doc/git-doc .
+$ git help --web commit
+ (web browser launches)
+
+$ git config --global help.format web</pre>
+
+h3. Windows
+
+"Msysgit":http://code.google.com/p/msysgit/ installs and sets the HTML help files as the default automatically. You don't need to do anything!