| 1 | git-show(1) |
| 2 | =========== |
| 3 | |
| 4 | NAME |
| 5 | ---- |
| 6 | git-show - Show various types of objects |
| 7 | |
| 8 | |
| 9 | SYNOPSIS |
| 10 | -------- |
| 11 | [synopsis] |
| 12 | git show [<options>] [<object>...] |
| 13 | |
| 14 | DESCRIPTION |
| 15 | ----------- |
| 16 | Shows one or more objects (blobs, trees, tags and commits). |
| 17 | |
| 18 | For commits it shows the log message and textual diff. It also |
| 19 | presents the merge commit in a special format as produced by |
| 20 | `git diff-tree --cc`. |
| 21 | |
| 22 | For tags, it shows the tag message and the referenced objects. |
| 23 | |
| 24 | For trees, it shows the names (equivalent to `git ls-tree` |
| 25 | with `--name-only`). |
| 26 | |
| 27 | For plain blobs, it shows the plain contents. |
| 28 | |
| 29 | Some options that `git log` command understands can be used to |
| 30 | control how the changes the commit introduces are shown. |
| 31 | |
| 32 | This manual page describes only the most frequently used options. |
| 33 | |
| 34 | |
| 35 | OPTIONS |
| 36 | ------- |
| 37 | `<object>...`:: |
| 38 | The names of objects to show (defaults to `HEAD`). |
| 39 | For a more complete list of ways to spell object names, see |
| 40 | "SPECIFYING REVISIONS" section in linkgit:gitrevisions[7]. |
| 41 | |
| 42 | include::pretty-options.adoc[] |
| 43 | |
| 44 | |
| 45 | include::pretty-formats.adoc[] |
| 46 | |
| 47 | |
| 48 | DIFF FORMATTING |
| 49 | --------------- |
| 50 | The options below can be used to change the way `git show` generates |
| 51 | diff output. |
| 52 | |
| 53 | :git-log: 1 |
| 54 | :diff-merges-default: `dense-combined` |
| 55 | include::diff-options.adoc[] |
| 56 | |
| 57 | include::diff-generate-patch.adoc[] |
| 58 | |
| 59 | |
| 60 | EXAMPLES |
| 61 | -------- |
| 62 | |
| 63 | `git show v1.0.0`:: |
| 64 | Shows the tag `v1.0.0`, along with the object the tag |
| 65 | points at. |
| 66 | |
| 67 | `git show v1.0.0^{tree}`:: |
| 68 | Shows the tree pointed to by the tag `v1.0.0`. |
| 69 | |
| 70 | `git show -s --format=%s v1.0.0^{commit}`:: |
| 71 | Shows the subject of the commit pointed to by the |
| 72 | tag `v1.0.0`. |
| 73 | |
| 74 | `git show next~10:Documentation/README`:: |
| 75 | Shows the contents of the file `Documentation/README` as |
| 76 | they were current in the 10th last commit of the branch |
| 77 | `next`. |
| 78 | |
| 79 | `git show master:Makefile master:t/Makefile`:: |
| 80 | Concatenates the contents of said Makefiles in the head |
| 81 | of the branch `master`. |
| 82 | |
| 83 | DISCUSSION |
| 84 | ---------- |
| 85 | |
| 86 | include::i18n.adoc[] |
| 87 | |
| 88 | GIT |
| 89 | --- |
| 90 | Part of the linkgit:git[1] suite |