Documentation/guilt-new.txt

   1 guilt-new(1)
   2 ============
   3
   4 NAME
   5 ----
   6 guilt-new - Create a new patch
   7
   8 SYNOPSIS
   9 --------
  10 include::usage-guilt-new.txt[]
  11
  12 DESCRIPTION
  13 -----------
  14 Create a new patch and push it on top of the stack. An optional patch
  15 description can be supplied either interactively on via the command line.
  16
  17 OPTIONS
  18 -------
  19 -f::
  20         Force patch creation if there are unrefreshed changes. These changes
  21         will get automatically imported into the new patch.
  22
  23 -s::
  24         Add a Signed-off-by with your committer identifier string to the
  25         patch message.
  26
  27 -e::
  28         Edit the patch message interactively. This option can be combined
  29         with -s to easily sign off on the patch.
  30
  31 -m <message>::
  32         The "<message>" string will used as the commit message. This option
  33         can be combined with -s to easily sign off on the patch.
  34
  35 <patchname>::
  36         Name of the patch to create. This must be a legal relative pathname
  37         string. For example, "foo", "foo/bar", and "foo/bar/foobar" are all
  38         valid.
  39
  40 EXAMPLES
  41 --------
  42
  43 Create a new patch called 'foobar':
  44
  45         $ guilt new foobar
  46
  47 Create a patch called 'foo' and supply a patch description interactively:
  48
  49         $ guilt new -e foo
  50
  51 Create a patch called 'bar' with a provided patch description and sign off
  52 on the patch:
  53
  54         $ guilt new -s -m patch-fu bar
  55
  56 Author
  57 ------
  58 Written by Josef "Jeff" Sipek <jeffpc@josefsipek.net>
  59
  60 Documentation
  61 -------------
  62 Documentation by Josef "Jeff" Sipek <jeffpc@josefsipek.net>
  63
  64 include::footer.txt[]