stg-edit(1) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| OPTIONS \| STGIT \| COLOPHON

STG-EDIT(1)                   StGit Manual                   STG-EDIT(1)

NAME top

       stg-edit - Edit a patch

SYNOPSIS top

       stg edit [OPTIONS] [patch]

DESCRIPTION top

       Edit a patch. Various aspects of a patch may be edited, including
       the message, author, patch name, or even the patch’s diff.

       By default, the topmost patch is edited.

       With no options or when --edit is specified, the patch details
       are edited interactively. Alternatively, command line options may
       be used to modify the patch non-interactively.

       The --diff option causes the patch’s diff to be appended to the
       patch description when editing interactively. This diff may be
       edited interactively (or just used as a reference when editing
       the patch’s message). The StGit attempts to apply the modified
       diff to the patch’s parent tree. If the updated diff does not
       apply, no changes are made to the patch and the edited patch is
       saved to a file which may be corrected and then fed-back into stg
       edit --file.

OPTIONS top

       -e, --edit
           Invoke editor for patch description

       -d, --diff
           Show diff when editing patch description

       -m <message>, --message=<message>
           Use message instead of invoking the editor

       -f <path>, --file=<path>
           Use the contents of file instead of invoking the editor. Use
           "-" to read from stdin.

       --no-verify
           Disable commit-msg hook

       -s[=<value>], --signoff[=<value>]
           Add "Signed-off-by" message trailer.

           The value is optional and defaults to the committer name and
           email. This option may be provided multiple times.

       --ack[=<value>]
           Add "Acked-by" message trailer.

           The value is optional and defaults to the committer’s name
           and email. This option may be provided multiple times.

       --review[=<value>]
           Add "Reviewed-by" message trailer.

           The value is optional and defaults to the committer’s name
           and email. This option may be provided multiple times.

       --author=<name-and-email>
           Set the author "name <email>"

       --authname=<name>
           Set the author name

       --authemail=<email>
           Set the author email

       --authdate=<date>
           Set the date the patch was authored.

           Use "now" to use the current time and date.

       --committer-date-is-author-date
           Instead of using the current time as the committer date, use
           the author date of the commit as the committer date.

       --save-template=<file>
           Instead of running the command, just write the patch
           description to FILE, and exit. (If FILE is "-", write to
           stdout.)

           When driving StGit from another program, it may be useful to
           first call a command with --save-template, then let the user
           edit the message, and then call the same command with --file.

       -t <treeish>, --set-tree=<treeish>
           Set the patch’s git tree to the specified treeish without
           changing the tree of any other patches. When used on the top
           patch, the index and work tree will be updated to match the
           new tree. This low-level option is primarily meant to be used
           by tools built on top of StGit, such as the Emacs mode. See
           also the --set-tree flag of stg-push(1).

STGIT top

       Part of the StGit suite - see stg(1)

COLOPHON top

       This page is part of the stgit (Stacked Git) project.
       Information about the project can be found at 
       ⟨http://www.procode.org/stgit/⟩.  If you have a bug report for
       this manual page, see ⟨http://www.procode.org/stgit/⟩.  This page
       was obtained from the project's upstream Git repository
       ⟨https://github.com/stacked-git/stgit.git⟩ on 2023-06-23.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2023-06-19.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

StGit 2.3.0                    06/23/2023                    STG-EDIT(1)

Pages that refer to this page: stg(1)