Documentation/git-show.txt

   1 git-show(1)
   2 ===========
   3
   4 NAME
   5 ----
   6 git-show - Show various types of objects
   7
   8
   9 SYNOPSIS
  10 --------
  11 [verse]
  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.txt[]
  43
  44
  45 include::pretty-formats.txt[]
  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.txt[]
  56
  57 include::diff-generate-patch.txt[]
  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.txt[]
  87
  88 GIT
  89 ---
  90 Part of the linkgit:git[1] suite