diff local/git-quick.html @ 90:1d853842db62

Add an index with anchor tags to jump to sections.
author Rob Landley <rob@landley.net>
date Fri, 09 Nov 2007 19:56:05 -0600
parents 307408bf8982
children 1bd46b3c996d
line wrap: on
line diff
--- a/local/git-quick.html	Wed Nov 07 23:42:52 2007 -0600
+++ b/local/git-quick.html	Fri Nov 09 19:56:05 2007 -0600
@@ -1,6 +1,21 @@
 <title>Following Linux kernel development with git</title>
-<h2>A "git bisect HOWTO" with a few extras.</h2>
+<li><a href="#what">A "git bisect HOWTO" with a few extras.</a></li>
+<li><a href="#installing">Installing git</a></li>
+<li><a href="#downloading">Downloading the kernel with git</a></li>
+<li><a href="#updating">Updating your local copy</a></li>
+<li><a href="#looking">Looking at historical versions</a></li>
+<li><a href="#versions">Working with historical versions<a></li>
+<li><a href="#diff">Using git diff</a></li>
+<li><a href="#tarballs">Creating tarballs</a></li>
+<li><a href="#bisect">Bisect</a></li>
+<li><a href="#example">Example git bisect run</a></li>
+<li><a href="#commands">Command summary</a></li>
+<li><a href="#linus">Linus Tovalds talks about git</a></li>
+<a name="what><h2>A "git bisect HOWTO" with a few extras.</h2>
 <p>This document tells you how to follow Linux kernel development (and
 examine its history) with git.  It does not assume you've ever used a source
@@ -16,7 +31,7 @@
 larger tutorial</a> that explains concepts like "branches".  This one
 shouldn't get in the way of doing that sort of thing, but it doesn't go there.</p>
-<h2>Installing git</h2>
+<a name="installing"><h2>Installing git</h2>
 <p>First, install a recent version of git.  (Note that the user interface
 changed drastically in git-1.5.0, and this page only describes the new
@@ -32,7 +47,7 @@
 and extract it into /usr/share/man.  You want the man pages because "git help"
 displays them.</p>
-<h2>Downloading the kernel with git</h2>
+<a name="downloading"><h2>Downloading the kernel with git</h2>
 <p>The following command will download the current linux-kernel repository into
 a local directory called "linux-git":</p>
@@ -62,7 +77,7 @@
 ".git/FETCH_HEAD".  Normally you shouldn't need to care, since git remembers
-<h2>Updating your local copy</h2>
+<a name="updating"><h2>Updating your local copy</h2>
 <p>The command "<b>git pull</b>" downloads all the changes committed to Linus's
 git repository since the last time you updated your copy, and appends those
@@ -78,7 +93,7 @@
 with a very slow one) and still have access to the complete revision history
 you've already downloaded.</p>
-<h2>Looking at historical versions</h2>
+<a name="looking"><h2>Looking at historical versions</h2>
 <p>The <b>git log</b> command lists the changes recorded in your repository,
 starting with the most recent and working back.  The big hexadecimal numbers
@@ -101,7 +116,7 @@
 blame</b> is difficult to read on an 80 charater terminal, try <b>git blame
 $FILE | sed 's/(.*)//'</b> to see more of the file itself.)</p>
-<h2>Working with historical versions</h2>
+<a name="versions"><h2>Working with historical versions</h2>
 <p>The <b>git checkout</b> command changes your working copy of the source to a
 specific version.  The -f option to checkout backs out any local changes
@@ -128,7 +143,7 @@
 looking at, and <b>git log master</b> to compare against the most recent
 commits in the repository.</p>
-<h2>Using git diff</h2>
+<a name="diff"><h2>Using git diff</h2>
 <p>The command "git diff" shows differences between git versions.  You can
 ask it to show differences between:</p>
@@ -156,7 +171,7 @@
 behavior of removing all lines from one file and adding them to another.
 (This behavior may become the default in a future version.)</p>
-<h2>Creating tarballs</h2>
+<a name="tarballs"><h2>Creating tarballs</h2>
 <p>The <b>git archive $VERSION</b> command creates a tarball (written to
 stdout) of the given version.  Note that "master" isn't the default here,
@@ -189,7 +204,7 @@
 afterwards with <b>git checkout -f; git clean -d</b>.  (Better than
 "make distclean".)</p>
+<a name="bisect"><h2>Bisect</h2>
 <p>Possibly the most useful thing git does for non-kernel developers is
 <b>git bisect</b>, which can track down a bug to a specific revision.  This
@@ -248,7 +263,7 @@
 need to back up, the bisect log is an easily editable text file you can
 always chop a few lines off the end of.</p>
-<h2>Example git bisect run</h2>
+<a name="example"><h2>Example git bisect run</h2>
 <p>Here is a real git bisect run I did on the <a href=http://qemu.org>qemu</a>
 git repository (git://git.kernel.dk/data/git/qemu) to figure out why
@@ -348,7 +363,7 @@
-<h2>Command summary</h2>
+<a name="commands"><h2>Command summary</h2>
 <p><b>git help</b></p> - List available commands.  You can also go
 <b>git help COMMANDNAME</b> to see help on a specific command.  Note,
@@ -398,7 +413,7 @@
 arguments after that are filenames.  Add "--find-copies-harder" to detect
-<h2>Linus Tovalds talks about git</h2>
+<a name="linus"><h2>Linus Tovalds talks about git</h2>
 <p>In <a href=http://youtube.com/watch?v=4XpnKHJAok8>this Google Tech Talk</a></p>