From f193684112247380d4f0369a932662491ea60744 Mon Sep 17 00:00:00 2001 From: Sven Strickroth Date: Fri, 3 Jan 2014 21:48:22 +0100 Subject: [PATCH] Update build instructions Signed-off-by: Sven Strickroth --- build.txt | 44 ++++++++++++++++++++++++++------------------ 1 file changed, 26 insertions(+), 18 deletions(-) diff --git a/build.txt b/build.txt index 1fdcae12b..97f6ef752 100644 --- a/build.txt +++ b/build.txt @@ -1,7 +1,6 @@ -/** -\page build Build instructions +Build instructions +================== -\section Introduction Introduction Compiling TortoiseGit is not very difficult, but it requires several steps to finish, at least the first time. @@ -12,40 +11,49 @@ and debug the binaries. No need to run the build script for every little change. So don't give up if you read through the next section and all the requirements. You only have to do this once. -\section Requirements Requirements +Requirements +------------ -\subsection Requirements1 First, you need to install the compiler package. +First, you need to install the compiler package: --# You need VS2012 Professional with Update 3 (or at least VS 2010 Professional) to allow +* You need VS2012 Professional with Update 4 to allow building of the full TortoiseGit package. If you don't have the Update 3 installed for VS2012 you cannot build binaries which run on Windows XP. This is the recommended option, but it is not free :-( If you want to build the msi make sure the "Tools for Redistributing Applications" are installed. --# If you do not have access to VS Professional you can download the free +* If you do not have access to VS Professional you can download the free Visual Studio Express 2012 for Windows Desktop. This will allow you to build the subversion libraries and the - TortoiseGitBlame, TortoiseGitUDiff, TortoiseGitIDiff, CrashRpt - and ResText projects only. You can not build the main parts of - TortoiseGit(shell extension, TortoiseGitProc, TGitCache, TortoiseGitMerge) + TortoiseGitUDiff, TortoiseGitIDiff, and ResText projects only. + You can not build the main parts of TortoiseGit(shell extension, TortoiseGitProc, + TGitCache, TortoiseGitMerge, and TortoiseGitBlame) with the Express Edition! - Install Visual Studio Express 2012 for Windows Desktop. Download it from http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-for-windows-desktop - \note Do not bother to install WiX and Votive as you cannot build very much. + Do not bother to install WiX as you cannot build very much. -\subsection Requirements2 Next you need to install some utilities/programs. -- WiX3.7 http://wix.codeplex.com/ -. +Next you might need to install some utilities/programs: +* If you want to build the MSI installer you need WiX3.8 (http://wix.codeplex.com/) +* For building the docs you need NAnt (http://nant.sourceforge.net/) and + http://code.google.com/p/tortoisesvn/downloads/detail?name=Tools-1.8.0.7z + +Get external source code +------------------------ + +TortoiseGit comes with all required code in its repository included or linked as submodules: + +Run -\section get external source code git submodule update --init -\section build Building the packages +to download all linked repositories (submodules) automatically. + +Building the packages +--------------------- Open TortoiseGit.sln Build all projects. If you want to build the installer package, make sure you build the Win32 configuration before the x64 one. - -*/ -- 2.11.4.GIT