grandmaster.txt

   1 = Git Grandmastery =
   2
   3 This pretentiously named page is my dumping ground for uncategorized Git tricks.
   4
   5 == Source Releases ==
   6
   7 For my projects, Git tracks exactly the files I'd like to archive and release to users. So to create a tarball of the source code, I run:
   8
   9  $ git-archive --format=tar --prefix=proj-1.2.3/ HEAD
  10
  11 == Changelog Generation ==
  12
  13 It's good practice to keep a [[http://en.wikipedia.org/wiki/Changelog][changelog]], and some projects even require it. If you've been committing frequently, which you should, generate a Changelog by typing
  14
  15  $ git-log > ChangeLog
  16
  17 == Git Over SSH, HTTP ==
  18
  19 Suppose you have ssh access to your web server, and it does not have Git installed, which is not an uncommon situation. Then download, compile and install Git in your account.
  20
  21 Create a repository in your web directory:
  22
  23  $ GIT_DIR=proj.git git-init
  24
  25 and in the "proj.git" directory, run
  26
  27  $ git --bare update-server-info
  28  $ chmod a+x hooks/post-update
  29
  30 From your computer, you can push via ssh:
  31
  32  $ git push git+ssh://web.server/proj.git HEAD
  33
  34 and people can get your project via
  35
  36  $ git clone http://web.server/proj.git
  37
  38 == Commit What Changed ==
  39
  40 Telling Git when you've added, deleted and renamed files gets tedious. Instead, try:
  41
  42  $ git-ls-files -d -m -o | xargs git-update-index --add --remove
  43
  44 and Git will look at the files in the current directory and work everything out for itself.
  45
  46 You might want it to ignore particular files:
  47
  48  $ git-ls-files -d -m -o -x *.tmp | xargs git-update-index --add --remove
  49
  50 If you have a big list of directories and files that should never be version controlled, type them into a separate file named "ignore" and run:
  51
  52  $ git-ls-files -d -m -o -X ignore | xargs git-update-index --add --remove
  53
  54 == Building On Git ==
  55
  56 In true UNIX fashion, Git's design allows it to be easily used as a low-level component of other programs. There are GUI interfaces, web interfaces, alternative command-line interfaces, and perhaps soon you will have a script or two of your own that calls Git.
  57
  58 See [[http://git.or.cz/][the Git homepage]] for some examples.