compat / vcbuild / READMEon commit rev-list: documentation and test for --left/right-only (59c8afd)
   1The Steps of Build Git with VS2008
   2
   31. You need the build environment, which contains the Git dependencies
   4   to be able to compile, link and run Git with MSVC.
   5
   6   You can either use the binary repository:
   7
   8       WWW: http://repo.or.cz/w/msvcgit.git
   9       Git: git clone git://repo.or.cz/msvcgit.git
  10       Zip: http://repo.or.cz/w/msvcgit.git?a=snapshot;h=master;sf=zip
  11
  12   and call the setup_32bit_env.cmd batch script before compiling Git,
  13   (see repo/package README for details), or the source repository:
  14
  15       WWW: http://repo.or.cz/w/gitbuild.git
  16       Git: git clone git://repo.or.cz/gitbuild.git
  17       Zip: (None, as it's a project with submodules)
  18
  19   and build the support libs as instructed in that repo/package.
  20
  212. Ensure you have the msysgit environment in your path, so you have
  22   GNU Make, bash and perl available.
  23
  24       WWW: http://repo.or.cz/w/msysgit.git
  25       Git: git clone git://repo.or.cz/msysgit.git
  26       Zip: http://repo.or.cz/w/msysgit.git?a=snapshot;h=master;sf=zip
  27
  28   This environment is also needed when you use the resulting
  29   executables, since Git might need to run scripts which are part of
  30   the git operations.
  31
  323. Inside Git's directory run the command:
  33       make common-cmds.h
  34   to generate the common-cmds.h file needed to compile git.
  35
  364. Then either build Git with the GNU Make Makefile in the Git projects
  37   root
  38       make MSVC=1
  39   or generate Visual Studio solution/projects (.sln/.vcproj) with the
  40   command
  41       perl contrib/buildsystems/generate -g Vcproj
  42   and open and build the solution with the IDE
  43       devenv git.sln /useenv
  44   or build with the IDE build engine directly from the command line
  45       devenv git.sln /useenv /build "Release|Win32"
  46   The /useenv option is required, so Visual Studio picks up the
  47   environment variables for the support libraries required to build
  48   Git, which you set up in step 1.
  49
  50Done!