{"thread":{"id":"43765","subject":"[PATCH] Add documentation for show-branch --topics","startedAt":"2006-12-18T15:48:33Z","lastAt":"2006-12-18T15:48:33Z","messageCount":1,"participants":["Brian Gernhardt"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"298237","messageId":"20061218154812.GA5716@178.242.249.10.in-addr.arpa","threadId":"43765","inReplyTo":null,"subject":"[PATCH] Add documentation for show-branch --topics","fromName":"Brian Gernhardt","fromEmail":"benji@silverinsanity.com","sentAt":"2006-12-18T15:48:33Z","receivedAt":"2006-12-18T15:48:33Z","isPatch":true,"sender":{"key":"benji@silverinsanity.com","avatar":"https://gravatar.com/avatar/e06c101dbc25c68114d859b4a9ec7cf8a2c52fd2b0270ef0eac0e2e63ff22311?d=mp&s=160"},"body":"Add a quick paragraph explaining the --topics option for show-branch.\nThe explanation is an abbreviated version of the commit message from\nd320a5437f8304cf9ea3ee1898e49d643e005738.\n\nSigned-off-by: Brian Gernhardt <benji@silverinsanity.com>\n---\n\n git blame helped me find the original description of this feature.\n I'm not sure this is the best explanation possible, but it gives\n both a quick description and a way to figure out what it's doing.\n Which is hopefully better than nothing.\n\n Documentation/git-show-branch.txt |   10 +++++++++-\n 1 files changed, 9 insertions(+), 1 deletions(-)\n\ndiff --git a/Documentation/git-show-branch.txt b/Documentation/git-show-branch.txt\nindex a2445a4..a9a0e0c 100644\n--- a/Documentation/git-show-branch.txt\n+++ b/Documentation/git-show-branch.txt\n@@ -10,7 +10,7 @@ SYNOPSIS\n [verse]\n 'git-show-branch' [--all] [--heads] [--tags] [--topo-order] [--current]\n \t\t[--more=<n> | --list | --independent | --merge-base]\n-\t\t[--no-name | --sha1-name] [<rev> | <glob>]...\n+\t\t[--no-name | --sha1-name] [--topics] [<rev> | <glob>]...\n \n DESCRIPTION\n -----------\n@@ -86,6 +86,14 @@ OPTIONS\n \tof \"master\"), name them with the unique prefix of their\n \tobject names.\n \n+--topics::\n+\tShows only commits that are NOT on the first branch given.\n+\tThis helps track topic branches by hiding any commit that\n+\tis already in the main line of development.  When given\n+\t\"git show-branch --topics master topic1 topic2\", this\n+\twill show the revisions given by \"git rev-list ^master\n+\ttopic1 topic2\"\n+\n Note that --more, --list, --independent and --merge-base options\n are mutually exclusive.\n \n-- \n1.4.4.1.GIT\n"}]}