projects / thirdparty / git.git / blame
| Commit | Line | Data |
|---|---|---|
| 4e783b41 PB |
1 | git-show(1) |
| 2 | =========== | |
| 3 | ||
| 4 | NAME | |
| 5 | ---- | |
| 5d7eeee2 | 6 | git-show - Show various types of objects |
| 4e783b41 PB |
7 | |
| 8 | ||
| 9 | SYNOPSIS | |
| 10 | -------- | |
| 5d7eeee2 | 11 | 'git-show' [options] <object>... |
| 4e783b41 PB |
12 | |
| 13 | DESCRIPTION | |
| 14 | ----------- | |
| 5d7eeee2 JS |
15 | Shows one or more objects (blobs, trees, tags and commits). |
| 16 | ||
| 17 | For commits it shows the log message and textual diff. It also | |
| 18 | presents the merge commit in a special format as produced by | |
| 19 | 'git-diff-tree --cc'. | |
| 20 | ||
| 21 | For tags, it shows the tag message and the referenced objects. | |
| 22 | ||
| 23 | For trees, it shows the names (equivalent to gitlink:git-ls-tree[1] | |
| 24 | with \--name-only). | |
| 25 | ||
| 26 | For plain blobs, it shows the plain contents. | |
| 4e783b41 PB |
27 | |
| 28 | This manual page describes only the most frequently used options. | |
| 29 | ||
| 30 | ||
| 31 | OPTIONS | |
| 32 | ------- | |
| 99e09cce JH |
33 | <object>:: |
| 34 | The name of the object to show. | |
| 41a5564e SP |
35 | For a more complete list of ways to spell object names, see |
| 36 | "SPECIFYING REVISIONS" section in gitlink:git-rev-parse[1]. | |
| 4e783b41 | 37 | |
| 5d1faf87 | 38 | include::pretty-formats.txt[] |
| 4e783b41 | 39 | |
| 5d7eeee2 JS |
40 | |
| 41 | EXAMPLES | |
| 42 | -------- | |
| 43 | ||
| 44 | git show v1.0.0:: | |
| 99e09cce JH |
45 | Shows the tag `v1.0.0`, along with the object the tags |
| 46 | points at. | |
| 5d7eeee2 JS |
47 | |
| 48 | git show v1.0.0^{tree}:: | |
| 49 | Shows the tree pointed to by the tag `v1.0.0`. | |
| 50 | ||
| 51 | git show next~10:Documentation/README | |
| 52 | Shows the contents of the file `Documentation/README` as | |
| 53 | they were current in the 10th last commit of the branch | |
| 54 | `next`. | |
| 55 | ||
| 56 | git show master:Makefile master:t/Makefile | |
| 57 | Concatenates the contents of said Makefiles in the head | |
| 58 | of the branch `master`. | |
| 59 | ||
| 5dc7bcc2 JH |
60 | Discussion |
| 61 | ---------- | |
| 62 | ||
| 63 | include::i18n.txt[] | |
| 64 | ||
| 4e783b41 PB |
65 | Author |
| 66 | ------ | |
| 67 | Written by Linus Torvalds <torvalds@osdl.org> and | |
| 99e09cce JH |
68 | Junio C Hamano <junkio@cox.net>. Significantly enhanced by |
| 69 | Johannes Schindelin <Johannes.Schindelin@gmx.de>. | |
| 4e783b41 PB |
70 | |
| 71 | ||
| 72 | Documentation | |
| 73 | ------------- | |
| 74 | Documentation by David Greaves, Petr Baudis and the git-list <git@vger.kernel.org>. | |
| 75 | ||
| 76 | This manual page is a stub. You can help the git documentation by expanding it. | |
| 77 | ||
| 78 | GIT | |
| 79 | --- | |
| 80 | Part of the gitlink:git[7] suite | |
| 81 |