Documentation / git-commit.txton commit Brief documentation for the mysterious git-am script (42e2cba)
   1git-commit(1)
   2=============
   3
   4NAME
   5----
   6git-commit - Record your changes
   7
   8SYNOPSIS
   9--------
  10'git-commit' [-a] [-s] [-v] [(-c | -C) <commit> | -F <file> | -m <msg>] [-e] <file>...
  11
  12DESCRIPTION
  13-----------
  14Updates the index file for given paths, or all modified files if
  15'-a' is specified, and makes a commit object.  The command
  16VISUAL and EDITOR environment variables to edit the commit log
  17message.
  18
  19This command can run `commit-msg`, `pre-commit`, and
  20`post-commit` hooks.  See link:hooks.html[hooks] for more
  21information.
  22
  23OPTIONS
  24-------
  25-a::
  26        Update all paths in the index file.
  27
  28-c or -C <commit>::
  29        Take existing commit object, and reuse the log message
  30        and the authorship information (including the timestamp)
  31        when creating the commit.  With '-C', the editor is not
  32        invoked; with '-c' the user can further edit the commit
  33        message.
  34
  35-F <file>::
  36        Take the commit message from the given file.  Use '-' to
  37        read the message from the standard input.
  38
  39-m <msg>::
  40        Use the given <msg> as the commit message.
  41
  42-s::
  43        Add Signed-off-by line at the end of the commit message.
  44
  45-v::
  46        Look for suspicious lines the commit introduces, and
  47        abort committing if there is one.  The definition of
  48        'suspicious lines' is currently the lines that has
  49        trailing whitespaces, and the lines whose indentation
  50        has a SP character immediately followed by a TAB
  51        character.
  52
  53-e::
  54        The message taken from file with `-F`, command line with
  55        `-m`, and from file with `-C` are usually used as the
  56        commit log message unmodified.  This option lets you
  57        further edit the message taken from these sources.
  58
  59<file>...::
  60        Update specified paths in the index file before committing.
  61
  62
  63Author
  64------
  65Written by Linus Torvalds <torvalds@osdl.org> and
  66Junio C Hamano <junkio@cox.net>
  67
  68
  69GIT
  70---
  71Part of the gitlink:git[7] suite