Difference between revisions of "Quick Windows Git Installation"

From reSIProcate
Jump to navigation Jump to search
(Created page with " * Use the context menu to start the clone: File:git-clone-21.png * If this is the first time you run Git, it will ask you to complete the profile setup: [[File:git-clo...")
 
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
  
* Use the context menu to start the clone:
+
== Overview ==
  
[[File:git-clone-21.png]]
+
* These instructions are for using the popular [http://sourceforge.net/projects/gitextensions/files/Git%20Extensions/ Git Extentions for Windows] to work with the reSIProcate source tree in git
 +
* Download the "complete" MSI, it includes the Git and Kdiff installers too
 +
* KDiff Installer becomes hidden under Git Extensions progress window, must look for it underneath or it will appear to sit there forever
 +
* must not commit to repository using CRLF, use option 1 if not sure
 +
* if you change any installation paths, you also have to specify them in the profile setup later
 +
* all options can be changed easily later
 +
* When finished installing Git Extensions, proceed to make a [[Quick Windows Git Clone Checkout|Git clone of the reSIProcate project]]
  
* If this is the first time you run Git, it will ask you to complete the profile setup:
+
== Details ==
  
[[File:git-clone-22.png]]
 
  
* The only things you need to complete are the User name and email address
+
[[Image:Git-setup-01.png]]
* These values will be embedded in any commits you make
 
* Commits are hashed and can't be changed later, so it is imperative that you set appropriate long-term values
 
* A long-term personal email address is usually recommended
 
* You can change these values later, but changing them will not change any commits that you have already contributed to a repository
 
  
[[File:git-clone-23.png]]
+
[[Image:Git-setup-02.png]]
  
* The files will be in C:\DEV\resiprocate after the clone:
+
* If you have your own copy of git or a diff tool already, you don't need these, otherwise, select them and you can change them later:
  
[[File:git-clone-24.png]]
+
[[Image:Git-setup-03.png]]
  
* Click "Clone" to proceed:
+
[[Image:Git-setup-04.png]]
  
[[File:git-clone-25.png]]
+
[[Image:Git-setup-05.png]]
  
* Wait a couple of minutes, it is downloading the full history of every file in every branch:
+
* Make sure it matches your Visual Studio installation, if any:
  
[[File:git-clone-26.png]]
+
[[Image:Git-setup-06.png]]
  
* It is not finished and ready to use:
+
[[Image:Git-setup-07.png]]
  
[[File:git-clone-27.png]]
+
* Here is the place where you have to look for the KDiff setup window hidden underneath, otherwise it just appears to be stuck here:
  
* Use the context menu to access Git functions:
+
[[Image:Git-setup-09.png]]
  
[[File:git-clone-28.png]]
+
[[Image:Git-setup-10.png]]
  
* Notice how the browser can easily show all activity on a file on all branches in chronological order?
+
[[Image:Git-setup-11.png]]
* Browsing the file in other branches is lightning fast because everything is cached locally by the "Clone" operation
 
  
[[File:git-clone-29.png]]
+
[[Image:Git-setup-12.png]]
 +
 
 +
[[Image:Git-setup-13.png]]
 +
 
 +
[[Image:Git-setup-14.png]]
 +
 
 +
[[Image:Git-setup-15.png]]
 +
 
 +
[[Image:Git-setup-16.png]]
 +
 
 +
[[Image:Git-setup-17.png]]
 +
 
 +
* Choosing the second option is safe and is more convenient:
 +
 
 +
[[Image:Git-setup-18.png]]
 +
 
 +
* Do not choose the third option, CRLF should not be committed to the repository
 +
* Most people use the first option
 +
* If your local filesystem is shared between Linux and Windows environments (e.g. using Samba shared folders), you may want to use the second option:
 +
 
 +
[[Image:Git-setup-19.png]]
 +
 
 +
[[Image:Git-setup-20.png]]
 +
 
 +
== Next steps ==
 +
 
 +
* Now you can proceed to make a [[Quick Windows Git Clone Checkout|Git clone of the reSIProcate project]]

Latest revision as of 02:39, 18 September 2014

Overview[edit]

  • These instructions are for using the popular Git Extentions for Windows to work with the reSIProcate source tree in git
  • Download the "complete" MSI, it includes the Git and Kdiff installers too
  • KDiff Installer becomes hidden under Git Extensions progress window, must look for it underneath or it will appear to sit there forever
  • must not commit to repository using CRLF, use option 1 if not sure
  • if you change any installation paths, you also have to specify them in the profile setup later
  • all options can be changed easily later
  • When finished installing Git Extensions, proceed to make a Git clone of the reSIProcate project

Details[edit]

Git-setup-01.png

Git-setup-02.png

  • If you have your own copy of git or a diff tool already, you don't need these, otherwise, select them and you can change them later:

Git-setup-03.png

Git-setup-04.png

Git-setup-05.png

  • Make sure it matches your Visual Studio installation, if any:

Git-setup-06.png

Git-setup-07.png

  • Here is the place where you have to look for the KDiff setup window hidden underneath, otherwise it just appears to be stuck here:

Git-setup-09.png

Git-setup-10.png

Git-setup-11.png

Git-setup-12.png

Git-setup-13.png

Git-setup-14.png

Git-setup-15.png

Git-setup-16.png

Git-setup-17.png

  • Choosing the second option is safe and is more convenient:

Git-setup-18.png

  • Do not choose the third option, CRLF should not be committed to the repository
  • Most people use the first option
  • If your local filesystem is shared between Linux and Windows environments (e.g. using Samba shared folders), you may want to use the second option:

Git-setup-19.png

Git-setup-20.png

Next steps[edit]