Junio C Hamano | d9d71c0 | 2006-02-08 00:52:33 | [diff] [blame] | 1 | git-show(1) |
| 2 | =========== |
| 3 | |
| 4 | NAME |
| 5 | ---- |
Junio C Hamano | 7d23f5e | 2006-12-16 07:44:04 | [diff] [blame] | 6 | git-show - Show various types of objects |
Junio C Hamano | d9d71c0 | 2006-02-08 00:52:33 | [diff] [blame] | 7 | |
| 8 | |
| 9 | SYNOPSIS |
| 10 | -------- |
Junio C Hamano | fce7c7e | 2008-07-02 03:06:38 | [diff] [blame] | 11 | 'git show' [options] <object>... |
Junio C Hamano | d9d71c0 | 2006-02-08 00:52:33 | [diff] [blame] | 12 | |
| 13 | DESCRIPTION |
| 14 | ----------- |
Junio C Hamano | 7d23f5e | 2006-12-16 07:44:04 | [diff] [blame] | 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 |
Junio C Hamano | ba4b928 | 2008-07-06 05:20:31 | [diff] [blame] | 19 | 'git-diff-tree --cc'. |
Junio C Hamano | 7d23f5e | 2006-12-16 07:44:04 | [diff] [blame] | 20 | |
| 21 | For tags, it shows the tag message and the referenced objects. |
| 22 | |
Junio C Hamano | ba4b928 | 2008-07-06 05:20:31 | [diff] [blame] | 23 | For trees, it shows the names (equivalent to 'git-ls-tree' |
Junio C Hamano | 7d23f5e | 2006-12-16 07:44:04 | [diff] [blame] | 24 | with \--name-only). |
| 25 | |
| 26 | For plain blobs, it shows the plain contents. |
Junio C Hamano | d9d71c0 | 2006-02-08 00:52:33 | [diff] [blame] | 27 | |
Junio C Hamano | ba4b928 | 2008-07-06 05:20:31 | [diff] [blame] | 28 | The command takes options applicable to the 'git-diff-tree' command to |
Junio C Hamano | d333998 | 2007-02-09 08:38:48 | [diff] [blame] | 29 | control how the changes the commit introduces are shown. |
| 30 | |
Junio C Hamano | d9d71c0 | 2006-02-08 00:52:33 | [diff] [blame] | 31 | This manual page describes only the most frequently used options. |
| 32 | |
| 33 | |
| 34 | OPTIONS |
| 35 | ------- |
Junio C Hamano | 9e39507 | 2008-07-31 22:11:21 | [diff] [blame] | 36 | <object>...:: |
| 37 | The names of objects to show. |
Junio C Hamano | 2d47c62 | 2007-01-18 06:24:10 | [diff] [blame] | 38 | For a more complete list of ways to spell object names, see |
Junio C Hamano | 35738e8 | 2008-01-07 07:55:46 | [diff] [blame] | 39 | "SPECIFYING REVISIONS" section in linkgit:git-rev-parse[1]. |
Junio C Hamano | d9d71c0 | 2006-02-08 00:52:33 | [diff] [blame] | 40 | |
Junio C Hamano | 0430e3a | 2007-05-15 03:13:17 | [diff] [blame] | 41 | include::pretty-options.txt[] |
| 42 | |
| 43 | |
Junio C Hamano | a340aaa | 2006-11-23 02:47:33 | [diff] [blame] | 44 | include::pretty-formats.txt[] |
Junio C Hamano | d9d71c0 | 2006-02-08 00:52:33 | [diff] [blame] | 45 | |
Junio C Hamano | 7d23f5e | 2006-12-16 07:44:04 | [diff] [blame] | 46 | |
| 47 | EXAMPLES |
| 48 | -------- |
| 49 | |
| 50 | git show v1.0.0:: |
Junio C Hamano | 775a0f4 | 2006-12-31 01:19:14 | [diff] [blame] | 51 | Shows the tag `v1.0.0`, along with the object the tags |
| 52 | points at. |
Junio C Hamano | 7d23f5e | 2006-12-16 07:44:04 | [diff] [blame] | 53 | |
Junio C Hamano | db911ee | 2007-02-28 08:13:52 | [diff] [blame] | 54 | git show v1.0.0^\{tree\}:: |
Junio C Hamano | 7d23f5e | 2006-12-16 07:44:04 | [diff] [blame] | 55 | Shows the tree pointed to by the tag `v1.0.0`. |
| 56 | |
Junio C Hamano | db911ee | 2007-02-28 08:13:52 | [diff] [blame] | 57 | git show next~10:Documentation/README:: |
Junio C Hamano | 7d23f5e | 2006-12-16 07:44:04 | [diff] [blame] | 58 | Shows the contents of the file `Documentation/README` as |
| 59 | they were current in the 10th last commit of the branch |
| 60 | `next`. |
| 61 | |
Junio C Hamano | db911ee | 2007-02-28 08:13:52 | [diff] [blame] | 62 | git show master:Makefile master:t/Makefile:: |
Junio C Hamano | 7d23f5e | 2006-12-16 07:44:04 | [diff] [blame] | 63 | Concatenates the contents of said Makefiles in the head |
| 64 | of the branch `master`. |
| 65 | |
Junio C Hamano | 775a0f4 | 2006-12-31 01:19:14 | [diff] [blame] | 66 | Discussion |
| 67 | ---------- |
| 68 | |
| 69 | include::i18n.txt[] |
| 70 | |
Junio C Hamano | d9d71c0 | 2006-02-08 00:52:33 | [diff] [blame] | 71 | Author |
| 72 | ------ |
| 73 | Written by Linus Torvalds <torvalds@osdl.org> and |
Junio C Hamano | 0868a30 | 2008-07-22 09:20:44 | [diff] [blame] | 74 | Junio C Hamano <gitster@pobox.com>. Significantly enhanced by |
Junio C Hamano | 775a0f4 | 2006-12-31 01:19:14 | [diff] [blame] | 75 | Johannes Schindelin <Johannes.Schindelin@gmx.de>. |
Junio C Hamano | d9d71c0 | 2006-02-08 00:52:33 | [diff] [blame] | 76 | |
| 77 | |
| 78 | Documentation |
| 79 | ------------- |
| 80 | Documentation by David Greaves, Petr Baudis and the git-list <git@vger.kernel.org>. |
| 81 | |
Junio C Hamano | d9d71c0 | 2006-02-08 00:52:33 | [diff] [blame] | 82 | GIT |
| 83 | --- |
Junio C Hamano | f7c042d | 2008-06-06 22:50:53 | [diff] [blame] | 84 | Part of the linkgit:git[1] suite |