2005-06-17 18:30:04 +00:00
|
|
|
|
|
|
|
Git installation
|
|
|
|
|
|
|
|
Normally you can just do "make" followed by "make install", and that
|
|
|
|
will install the git programs in your own ~/bin/ directory. If you want
|
|
|
|
to do a global install, you can do
|
|
|
|
|
2006-01-21 23:54:12 +00:00
|
|
|
$ make prefix=/usr all doc ;# as yourself
|
|
|
|
# make prefix=/usr install install-doc ;# as root
|
2005-06-17 18:30:04 +00:00
|
|
|
|
2005-11-09 20:40:03 +00:00
|
|
|
(or prefix=/usr/local, of course). Just like any program suite
|
|
|
|
that uses $prefix, the built results have some paths encoded,
|
|
|
|
which are derived from $prefix, so "make all; make prefix=/usr
|
|
|
|
install" would not work.
|
2005-06-17 18:30:04 +00:00
|
|
|
|
2006-07-02 23:56:48 +00:00
|
|
|
Alternatively you can use autoconf generated ./configure script to
|
|
|
|
set up install paths (via config.mak.autogen), so you can write instead
|
|
|
|
|
2006-08-08 16:35:23 +00:00
|
|
|
$ make configure ;# as yourself
|
2006-07-02 23:56:48 +00:00
|
|
|
$ ./configure --prefix=/usr ;# as yourself
|
|
|
|
$ make all doc ;# as yourself
|
|
|
|
# make install install-doc ;# as root
|
|
|
|
|
|
|
|
|
2005-06-17 18:30:04 +00:00
|
|
|
Issues of note:
|
|
|
|
|
|
|
|
- git normally installs a helper script wrapper called "git", which
|
|
|
|
conflicts with a similarly named "GNU interactive tools" program.
|
|
|
|
|
|
|
|
Tough. Either don't use the wrapper script, or delete the old GNU
|
|
|
|
interactive tools. None of the core git stuff needs the wrapper,
|
|
|
|
it's just a convenient shorthand and while it is documented in some
|
2005-09-08 00:26:23 +00:00
|
|
|
places, you can always replace "git commit" with "git-commit"
|
2007-06-07 07:04:01 +00:00
|
|
|
instead.
|
2005-06-17 18:30:04 +00:00
|
|
|
|
|
|
|
But let's face it, most of us don't have GNU interactive tools, and
|
|
|
|
even if we had it, we wouldn't know what it does. I don't think it
|
|
|
|
has been actively developed since 1997, and people have moved over to
|
|
|
|
graphical file managers.
|
|
|
|
|
2006-07-03 06:54:47 +00:00
|
|
|
- You can use git after building but without installing if you
|
|
|
|
wanted to. Various git commands need to find other git
|
|
|
|
commands and scripts to do their work, so you would need to
|
|
|
|
arrange a few environment variables to tell them that their
|
|
|
|
friends will be found in your built source area instead of at
|
|
|
|
their standard installation area. Something like this works
|
|
|
|
for me:
|
|
|
|
|
|
|
|
GIT_EXEC_PATH=`pwd`
|
|
|
|
PATH=`pwd`:$PATH
|
2006-09-29 07:34:51 +00:00
|
|
|
GITPERLLIB=`pwd`/perl/blib/lib
|
2006-07-03 21:16:32 +00:00
|
|
|
export GIT_EXEC_PATH PATH GITPERLLIB
|
2006-07-03 06:54:47 +00:00
|
|
|
|
2005-06-17 18:30:04 +00:00
|
|
|
- Git is reasonably self-sufficient, but does depend on a few external
|
|
|
|
programs and libraries:
|
|
|
|
|
|
|
|
- "zlib", the compression library. Git won't build without it.
|
|
|
|
|
2007-07-17 06:59:54 +00:00
|
|
|
- "openssl". Unless you specify otherwise, you'll get the SHA1
|
|
|
|
library from here.
|
2005-06-17 18:30:04 +00:00
|
|
|
|
|
|
|
If you don't have openssl, you can use one of the SHA1 libraries
|
|
|
|
that come with git (git includes the one from Mozilla, and has
|
2006-02-28 23:07:20 +00:00
|
|
|
its own PowerPC and ARM optimized ones too - see the Makefile).
|
2005-06-17 18:30:04 +00:00
|
|
|
|
2005-09-08 00:26:23 +00:00
|
|
|
- "libcurl" and "curl" executable. git-http-fetch and
|
|
|
|
git-fetch use them. If you do not use http
|
2006-07-09 07:44:30 +00:00
|
|
|
transfer, you are probably OK if you do not have
|
2005-07-23 00:30:26 +00:00
|
|
|
them.
|
2005-06-17 18:30:04 +00:00
|
|
|
|
2005-11-05 19:12:05 +00:00
|
|
|
- expat library; git-http-push uses it for remote lock
|
|
|
|
management over DAV. Similar to "curl" above, this is optional.
|
|
|
|
|
2006-07-09 07:44:30 +00:00
|
|
|
- "wish", the Tcl/Tk windowing shell is used in gitk to show the
|
2007-07-17 06:59:54 +00:00
|
|
|
history graphically, and in git-gui.
|
2005-09-12 00:00:49 +00:00
|
|
|
|
|
|
|
- "ssh" is used to push and pull over the net
|
2005-11-11 19:27:03 +00:00
|
|
|
|
|
|
|
- "perl" and POSIX-compliant shells are needed to use most of
|
|
|
|
the barebone Porcelainish scripts.
|
|
|
|
|
|
|
|
- Some platform specific issues are dealt with Makefile rules,
|
|
|
|
but depending on your specific installation, you may not
|
|
|
|
have all the libraries/tools needed, or you may have
|
|
|
|
necessary libraries at unusual locations. Please look at the
|
|
|
|
top of the Makefile to see what can be adjusted for your needs.
|
2005-12-05 18:38:30 +00:00
|
|
|
You can place local settings in config.mak and the Makefile
|
|
|
|
will include them. Note that config.mak is not distributed;
|
|
|
|
the name is reserved for local settings.
|
2006-01-21 23:54:12 +00:00
|
|
|
|
2007-06-18 08:43:34 +00:00
|
|
|
- To build and install documentation suite, you need to have
|
|
|
|
the asciidoc/xmlto toolchain. Because not many people are
|
|
|
|
inclined to install the tools, the default build target
|
|
|
|
("make all") does _not_ build them. The documentation is
|
|
|
|
written for AsciiDoc 7, but "make ASCIIDOC8=YesPlease doc"
|
|
|
|
will let you format with AsciiDoc 8.
|
|
|
|
|
|
|
|
Alternatively, pre-formatted documentation are available in
|
|
|
|
"html" and "man" branches of the git repository itself. For
|
|
|
|
example, you could:
|
2006-01-21 23:54:12 +00:00
|
|
|
|
|
|
|
$ mkdir manual && cd manual
|
2007-01-12 21:01:46 +00:00
|
|
|
$ git init
|
2006-06-21 06:54:26 +00:00
|
|
|
$ git fetch-pack git://git.kernel.org/pub/scm/git/git.git man html |
|
2006-01-21 23:54:12 +00:00
|
|
|
while read a b
|
|
|
|
do
|
|
|
|
echo $a >.git/$b
|
|
|
|
done
|
|
|
|
$ cp .git/refs/heads/man .git/refs/heads/master
|
|
|
|
$ git checkout
|
|
|
|
|
|
|
|
to checkout the pre-built man pages. Also in this repository:
|
|
|
|
|
|
|
|
$ git checkout html
|
|
|
|
|
|
|
|
would instead give you a copy of what you see at:
|
|
|
|
|
|
|
|
http://www.kernel.org/pub/software/scm/git/docs/
|