diff options
| author | J. Bruce Fields <bfields@citi.umich.edu> | 2007-01-29 01:55:33 -0500 |
|---|---|---|
| committer | J. Bruce Fields <bfields@citi.umich.edu> | 2007-01-29 02:00:35 -0500 |
| commit | 4a7979ca829530c4e5661d553449b0b073a50db3 (patch) | |
| tree | 05404a1aeaea1acf569b2af8a6ba5b0076503ae0 | |
| parent | 9a241220fd19c93a89501bfef51ce4ec79a79033 (diff) | |
| download | git-4a7979ca829530c4e5661d553449b0b073a50db3.tar.gz git-4a7979ca829530c4e5661d553449b0b073a50db3.tar.xz | |
user-manual: document git-show-branch example
Document Junio's show-branch trick for finding out which tags are
descendents of a given comit.
Signed-off-by: "J. Bruce Fields" <bfields@citi.umich.edu>
| -rw-r--r-- | Documentation/user-manual.txt | 30 |
1 files changed, 28 insertions, 2 deletions
diff --git a/Documentation/user-manual.txt b/Documentation/user-manual.txt index b4980a2a0..5f41a2d02 100644 --- a/Documentation/user-manual.txt +++ b/Documentation/user-manual.txt @@ -933,12 +933,38 @@ actually is an ancestor of v1.5.0-rc1. Alternatively, note that ------------------------------------------------- -$ git log v1.5.0-rc1..305db0fd +$ git log v1.5.0-rc1..e05db0fd ------------------------------------------------- -will produce empty output if and only if v1.5.0-rc1 includes 305db0fd, +will produce empty output if and only if v1.5.0-rc1 includes e05db0fd, because it outputs only commits that are not reachable from v1.5.0-rc1. +As yet another alternative, the gitlink:git-show-branch[1] command lists +the commits reachable from its arguments with a display on the left-hand +side that indicates which arguments that commit is reachable from. So, +you can run something like + +------------------------------------------------- +$ git show-branch e05db0fd v1.5.0-rc0 v1.5.0-rc1 v1.5.0-rc2 +! [e05db0fd] Fix warnings in sha1_file.c - use C99 printf format if +available + ! [v1.5.0-rc0] GIT v1.5.0 preview + ! [v1.5.0-rc1] GIT v1.5.0-rc1 + ! [v1.5.0-rc2] GIT v1.5.0-rc2 +... +------------------------------------------------- + +then search for a line that looks like + +------------------------------------------------- ++ ++ [e05db0fd] Fix warnings in sha1_file.c - use C99 printf format if +available +------------------------------------------------- + +Which shows that e05db0fd is reachable from itself, from v1.5.0-rc1, and +from v1.5.0-rc2, but not from v1.5.0-rc0. + + Developing with git =================== |