clone.txt

   1 = Cloning Around =
   2
   3 In older version control systems, checkout was the standard way to get a saved state. On checkout, you'd get a bunch of files in the requested saved state.
   4
   5 In Git, the standard way to get files is to create a clone of the entire repository. In other words, you practically create a mirror of the central repository, so you can do anything the central repostiory can do.
   6
   7 == Sync Computers ==
   8
   9 This is the reason I first used Git. I can tolerate making tarballs or using <tt>rsync</tt> for backups. The problem was sometimes I'd edit on my laptop, other times on my desktop, and they may not have talked to each other in between.
  10
  11 Initialize a Git repository and commit your files as above on one machine. Then on the other:
  12
  13  $ git-clone other.computer:/path/to/files
  14
  15 to create a second copy of the files and Git respository. From now on,
  16
  17  $ git-commit -a
  18  $ git-pull other.computer:/path/to/files
  19
  20 will pull in the state of the files on the other computer into the one you're working on. If you've recently made conflicting edits in the same file, Git will let you know and you should commit again after resolving them.
  21
  22 If you have not committed any changes on the other computer, you may type
  23
  24  $ git-push other.computer:/path/to/files
  25
  26 to push the current state to the other computer. Next time you're logged in to the other computer, run
  27
  28  $ git-checkout HEAD .
  29
  30 to update the files before working on them. Be aware that you'll lose any uncommitted changes after.
  31
  32 == Classic Source Control ==
  33
  34 Copy your project to a directory in your main server. Initialize a Git
  35 repository: <tt>git init ; git add . ; git commit -m "Initial commit"</tt>.
  36
  37 To check out source, a developer types
  38
  39  $ git clone main.server:/path/to/files
  40
  41 After making changes, the code is checked in to the main server by:
  42
  43  $ git commit -a
  44  $ git push
  45
  46 If the main server has been updated, the latest version needs to be checked out before the push. To sync to the latest version:
  47
  48  $ git commit -a
  49  $ git pull
  50
  51 == Forking a Project ==
  52
  53 Sick of the way a project is being run? Think you could do a better job?
  54
  55 First, on your server:
  56
  57  $ git clone main.server:/path/to/files
  58
  59 Then tell everyone to check out your fork of the project at your server.
  60
  61 At any later time, you can merge in the changes from the original project with:
  62
  63  $ git pull
  64
  65 == Ultimate Backups ==
  66
  67 How would you like multiple tamper-proof geographically diverse redundant archives?
  68
  69 TODO
  70
  71 == Guerilla Version Control ==
  72
  73 TODO
  74
  75 == Working On Features In Parallel ==
  76
  77 TODO
  78
  79 == Source Control Engine Tools and Utilities ==
  80
  81 TODO