preface.txt

   1 = Git Magic =
   2 Ben Lynn
   3 August 2007
   4
   5 == Preface ==
   6
   7 http://git.or.cz/[Git] is a version control Swiss army knife. A reliable versatile multipurpose revision control tool whose extraordinary flexibility makes it tricky to learn, let alone master. I'm recording what I've figured out so far in these pages, because I initially had difficulty understanding http://www.kernel.org/pub/software/scm/git/docs/user-manual.html[the Git user manual].
   8
   9 As Arthur C. Clarke observed, any sufficiently advanced technology is indistinguishable from magic. This is a great way to approach Git: newbies can ignore its inner workings and view Git as a gizmo that can amaze friends and infuriate enemies with its wondrous abilities.
  10
  11 Rather than go into details, we provide rough instructions for particular effects. After repeated use, gradually you will understand how each trick works, and how to tailor the recipes for your needs.
  12
  13 .Other Editions
  14
  15  - http://docs.google.com/View?id=dfwthj68_675gz3bw8kj[Chinese translation]: by JunJie, Meng and JiangWei.
  16  - link:book.html[Single webpage]: barebones HTML, with no CSS.
  17  - link:book.pdf[PDF file]: printer-friendly.
  18
  19 === Thanks! ===
  20
  21 Kudos to Dustin Sallings, Alberto Bertogli, James Cameron, Douglas Livingstone, Michael Budde, Richard Albury, Tarmigan and Derek Mahar for suggestions and improvements. [If I've left you out, please tell me because I often forget to update this section.]
  22
  23 === License ===
  24
  25 This guide is released under http://www.gnu.org/licenses/gpl-3.0.html[the GNU General Public License version 3]. Naturally, the source is kept in a Git
  26 repository, and can be obtained by typing:
  27
  28  $ git clone git://repo.or.cz/gitmagic.git  # Creates "gitmagic" directory.
  29
  30 See below for other mirrors.
  31
  32 === Links ===
  33
  34 I once listed some references, but it's too time-consuming to maintain.
  35 Besides, anyone can simply use http://www.google.com/[a search engine]
  36 to find Git
  37 http://www.google.com/search?q=git+tutorial[tutorials],
  38 http://www.google.com/search?q=git+guide[guides], and
  39 http://www.google.com/search?q=git+comparison[comparisons] with
  40 http://www.google.com/search?q=git+subversion[Subversion],
  41 http://www.google.com/search?q=git+mercurial[Mercurial], and other version control systems.
  42
  43 .Free Git hosting
  44
  45  - http://repo.or.cz/[http://repo.or.cz/] hosts free projects,
  46 http://repo.or.cz/w/gitmagic.git[including this guide].
  47  - http://gitorious.org/[http://gitorious.org/] is another Git hosting site aimed at open-source projects.
  48  - http://github.com/[http://github.com/] hosts open-source projects for free, http://github.com/blynn/gitmagic/tree/master[including this guide], and private projects for a fee.