|author||Karl Schultz <email@example.com>||2010-02-11 10:54:18 -0700|
|committer||Karl Schultz <firstname.lastname@example.org>||2010-02-11 10:56:30 -0700|
Add git tips
1 files changed, 77 insertions, 0 deletions
diff --git a/docs/repository.html b/docs/repository.html
index 7e515a6da54..95d274a7a2c 100644
@@ -122,6 +122,83 @@ Questions about branch status/activity should be posted to the
mesa3d-dev mailing list.
+<H2>Developer Git Tips</H2>
+<li>Setting up to edit the master branch
+If you try to do a pull by just saying<code> git pull </code>
+and git complains that you have not specified a
+ git config branch.master.remote origin
+ git config branch.master.merge master
+Otherwise, you have to say<code> git pull origin master </code>
+each time you do a pull.
+<li>Small changes to master
+If you are an experienced git user working on substancial modifications,
+you are probably
+working on a separate branch and would rebase your branch prior to
+merging with master.
+But for small changes to the master branch itself,
+you also need to use the rebase feature in order to avoid an
+unnecessary and distracting branch in master.
+If it has been awhile since you've done the initial clone, try
+ git pull
+to get the latest files before you start working.
+Make your changes and use
+ git add <files to commit>
+ git commit
+to get your changes ready to push back into the fd.o repository.
+It is possible (and likely) that someone has changed master since
+you did your last pull. Even if your changes do not conflict with
+their changes, git will make a fast-forward
+merge branch, branching from the point in time
+where you did your last pull and merging it to a point after the other changes.
+To avoid this,
+ git pull --rebase
+ git push
+If you are familiar with CVS or similar system, this is similar to doing a
+<code> cvs update </code> in order to update your source tree to
+the current repository state, instead of the time you did the last update.
+(CVS doesn't work like git in this respect, but this is easiest way
+to explain it.)
+In any case, your repository now looks like you made your changes after
+all the other changes.
+If the rebase resulted in conflicts or changes that could affect
+the proper operation of your changes, you'll need to investigate
+those before doing the push.
+If you want the rebase action to be the default action, then
+ git config branch.master.rebase true
+ git config --global branch.autosetuprebase=always
+See <a href="http://www.eecs.harvard.edu/~cduan/technical/git/" target="_parent">Understanding Git Conceptually</a> for a fairly clear explanation about all of this.