]> git.cworth.org Git - hgbook-git/commitdiff
Port section 2.1 (Installing) from mercurial to git
authorCarl Worth <cworth@cworth.org>
Thu, 27 Sep 2007 23:06:13 +0000 (16:06 -0700)
committerCarl Worth <cworth@cworth.org>
Thu, 27 Sep 2007 23:06:13 +0000 (16:06 -0700)
tour.mdwn

index b8e475ce0c691b61e33ddce0dbe996b3225a8ccc..2721d8007ab29dfab5e521ddc75bd26f67839587 100644 (file)
--- a/tour.mdwn
+++ b/tour.mdwn
@@ -1,5 +1,5 @@
 ## Chapter 2  
 ## Chapter 2  
-A tour of Mercurial: the basics
+A tour of git: the basics
 
 ### 2.0 Copyright
 
 
 ### 2.0 Copyright
 
@@ -27,75 +27,70 @@ Changes made by Carl include the following:
     * Convert from HTML to markdown source syntax
     * Eliminate all content except Chapter 2 and Appendix D
     * Eliminate line numbers from examples
     * Convert from HTML to markdown source syntax
     * Eliminate all content except Chapter 2 and Appendix D
     * Eliminate line numbers from examples
+    * Modified to describe git instead of mercurial
 
 
-### 2.1  Installing Mercurial on your system
+### 2.1  Installing git on your system
 
 
-Prebuilt binary packages of Mercurial are available for every popular
-operating system. These make it easy to start using Mercurial on your
+Prebuilt binary packages of git are available for many popular
+operating systems. These make it easy to start using git on your
 computer immediately.
 
 #### 2.1.1  Linux
 
 Because each Linux distribution has its own packaging tools, policies,
 and rate of development, it’s difficult to give a comprehensive set of
 computer immediately.
 
 #### 2.1.1  Linux
 
 Because each Linux distribution has its own packaging tools, policies,
 and rate of development, it’s difficult to give a comprehensive set of
-instructions on how to install Mercurial binaries. The version of
-Mercurial that you will end up with can vary depending on how active
+instructions on how to install git binaries. The version of
+git that you will end up with can vary depending on how active
 the person is who maintains the package for your distribution.
 
 the person is who maintains the package for your distribution.
 
-To keep things simple, I will focus on installing Mercurial from the
+To keep things simple, I will focus on installing git from the
 command line under the most popular Linux distributions. Most of these
 distributions provide graphical package managers that will let you
 command line under the most popular Linux distributions. Most of these
 distributions provide graphical package managers that will let you
-install Mercurial with a single click; the package name to look for is
-mercurial.
+install git with a single click. The package name to look for is
+often git, but is sometimes git-core, (due to an unfortunate name
+with git, meaning GNU Interactive Tools).
 
   * Debian 
 
 
   * Debian 
 
-       apt-get install mercurial
+       apt-get install git-core
 
   * Fedora Core 
 
 
   * Fedora Core 
 
-       yum install mercurial
+       yum install git
 
   * Gentoo 
 
 
   * Gentoo 
 
-       emerge mercurial
+       emerge git
 
   * OpenSUSE 
 
 
   * OpenSUSE 
 
-       yum install mercurial
+       yum install git
 
 
-  * Ubuntu Ubuntu’s Mercurial package is based on Debian’s. To install
-it, run the following command.
+  * Ubuntu 
 
 
-       apt-get install mercurial
+       apt-get install git
 
 
-The Ubuntu package for Mercurial tends to lag behind the Debian
-version by a considerable time margin (at the time of writing, seven
-months), which in some cases will mean that on Ubuntu, you may run
-into problems that have since been fixed in the Debian package.
+#### 2.1.2  Mac OS X
 
 
-#### 2.1.2  Solaris
+A git-core package is available through
+[macports](http://macports.org). Once macports is enabled, the command
+to install git is:
 
 
-XXX. 
+       port install git-core
 
 
-#### 2.1.3  Mac OS X
+#### 2.1.3  Windows
 
 
-Lee Cantey publishes an installer of Mercurial for Mac OS X at
-[http://mercurial.berkwood.com][6]. This package works on both
-Intel- and Power-based Macs. Before you can use it, you must install a
-compatible version of Universal MacPython [[BI][7]]. This is easy to
-do; simply follow the instructions on Lee’s site.
-
-#### 2.1.4  Windows
-
-Lee Cantey also publishes an installer of Mercurial for Windows at
-[http://mercurial.berkwood.com][6]. This package has no external
-dependencies; it “just works”.
-
-Note: The Windows version of Mercurial does not automatically convert
-line endings between Windows and Unix styles. If you want to share
-work with Unix users, you must do a little additional configuration
-work. XXX Flesh this out.
+Git has long been available as part of cygwin, and works reasonably
+well in that environment. Some people find cygwin a particularly
+inelegant approach to running git and would prefer a "native"
+solution. To this end, the [msysgit
+project](http://code.google.com/p/msysgit/) is rapidly putting
+together a solution including various packages with full
+installers. These include GitMe, a package to install the entire
+development environment necessary to work on improving the msysgit
+port of git, and WinGit, a package for installing just git itself
+without the development environment, (still in Alpha as of September
+2008).
 
 ### 2.2  Getting started
 
 
 ### 2.2  Getting started