diff options
| author | tekkub <tekkub@gmail.com> | 2009-07-04 21:05:54 -0600 |
|---|---|---|
| committer | tekkub <tekkub@gmail.com> | 2009-07-04 21:05:54 -0600 |
| commit | bdcddea6b629bdeb63d52e96d75be5c9c0fff8d4 (patch) | |
| tree | 1b046e132c44164c675d5f35952ac74e79f1cbd4 /_posts | |
| parent | f4092cbf7f3896b7eeab8ba4544e93f5010c05c2 (diff) | |
Add git html help install guide
Diffstat (limited to '_posts')
| -rw-r--r-- | _posts/2009-07-04-git-html-help.textile | 49 |
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! |