From ae79238ec680aa64bb8aef0b05f8cb2a2619d11f Mon Sep 17 00:00:00 2001
From: tekkub <tekkub@gmail.com>
Date: Wed, 24 Mar 2010 23:53:55 -0600
Subject: Simpler route for HTML docs, and updating!

---
 _posts/2009-07-04-git-html-help.markdown | 40 ++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 _posts/2009-07-04-git-html-help.markdown

(limited to '_posts/2009-07-04-git-html-help.markdown')

diff --git a/_posts/2009-07-04-git-html-help.markdown b/_posts/2009-07-04-git-html-help.markdown
new file mode 100644
index 0000000..dae6fd4
--- /dev/null
+++ b/_posts/2009-07-04-git-html-help.markdown
@@ -0,0 +1,40 @@
+---
+layout: default
+title: Installing Git HTML help
+description: How to install the local git HTML help files
+categories: setup
+---
+
+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.
+
+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.
+
+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!
+
+OSX
+---
+
+To install web docs we simply need to clone the main git repo to the correct path and check out the "html" branch.  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 class="terminal">
+$ git help --web commit
+fatal: '/usr/local/git/share/doc/git-doc': not a documentation directory.
+
+$ sudo mkdir -p /usr/local/git/share/doc
+$ cd /usr/local/git/share/doc
+$ sudo git clone git://git.kernel.org/pub/scm/git/git.git git-doc --branch html
+</pre>
+
+To verify that the web docs now work, run `git help --web commit`.  If your browser launches then you're good to go.  You can now set git to default to the web docs by running `git config --global help.format web`
+
+### Updating the docs
+
+Updating is a simple matter of pulling:
+
+<pre class="terminal">
+$ cd /usr/local/git/share/doc
+$ sudo git pull
+</pre>
-- 
cgit v1.3.1