diff options
| author | Jonathan Nieder <jrnieder@gmail.com> | 2010-11-09 11:12:48 -0600 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2010-11-09 09:42:57 -0800 |
| commit | 60aa9cf8f370b69eb7feaad2e1cbcd04280bc799 (patch) | |
| tree | 1b8ba89a5608450b4f045ed76828f390cdaaf806 /Documentation | |
| parent | ae3cdfe1123d153f720bbe4a4abc97ed3e9f65a4 (diff) | |
| download | git-60aa9cf8f370b69eb7feaad2e1cbcd04280bc799.tar.gz git-60aa9cf8f370b69eb7feaad2e1cbcd04280bc799.tar.xz | |
Documentation: document show -s
Git's diff machinery has supported a -s (silence diff output) option
as far back as v0.99~900 (Silent flag for show-diff, 2005-04-13), but
the option is only advertised in an odd corner of the git diff-tree
manual.
The main use is to retrieve basic metadata about a commit:
git show -s rev
Explain this in the 'git log' manual and provide an example in the
'git show' examples section. This is kind of a cop-out, since it
would be more useful to explain it in the 'git show' manual proper,
which says:
The command takes options applicable to the git
diff-tree command to control how the changes the
commit introduces are shown.
This manual page describes only the most frequently
used options.
Fixing that is a larger task for another day.
Reported-by: Will Hall <will@gnatter.net>
Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/git-show.txt | 4 | ||||
| -rw-r--r-- | Documentation/rev-list-options.txt | 3 |
2 files changed, 7 insertions, 0 deletions
diff --git a/Documentation/git-show.txt b/Documentation/git-show.txt index 2049c60f7..f0a8a1aff 100644 --- a/Documentation/git-show.txt +++ b/Documentation/git-show.txt @@ -54,6 +54,10 @@ git show v1.0.0:: git show v1.0.0^\{tree\}:: Shows the tree pointed to by the tag `v1.0.0`. +git show -s --format=%s v1.0.0^\{commit\}:: + Shows the subject of the commit pointed to by the + tag `v1.0.0`. + git show next~10:Documentation/README:: Shows the contents of the file `Documentation/README` as they were current in the 10th last commit of the branch diff --git a/Documentation/rev-list-options.txt b/Documentation/rev-list-options.txt index 7a4256706..1aaaf5ae8 100644 --- a/Documentation/rev-list-options.txt +++ b/Documentation/rev-list-options.txt @@ -146,6 +146,9 @@ options may be given. See linkgit:git-diff-files[1] for more options. -t:: Show the tree objects in the diff output. This implies '-r'. + +-s:: + Suppress diff output. endif::git-rev-list[] Commit Limiting |