STG-IMPORT(1)                   StGit Manual                   STG-IMPORT(1)

NAME         top

       stg-import - Import a GNU diff file as a new patch

SYNOPSIS         top

       stg import [options] [--] [<file>|<url>]

DESCRIPTION         top

       Create a new patch and apply the given GNU diff file (or the standard
       input). By default, the file name is used as the patch name but this
       can be overridden with the --name option. The patch can either be a
       normal file with the description at the top or it can have standard
       mail format, the Subject, From and Date headers being used for
       generating the patch information. The command can also read series
       and mbox files.

       If a patch does not apply cleanly, the failed diff is written to the
       .stgit-failed.patch file and an empty StGIT patch is added to the

       The patch description has to be separated from the data with a ---

OPTIONS         top

       -m, --mail
           Import the patch from a standard e-mail file.

       -M, --mbox
           Import a series of patches from an mbox file.

       -s, --series
           Import a series of patches from a series file or a tar archive.

       -u, --url
           Import a patch from a URL.

       -n NAME, --name NAME
           Use NAME as the patch name.

       -p N, --strip N
           Remove N leading slashes from diff paths (default 1).

       -t, --stripname
           Strip numbering and extension from patch name.

       -i, --ignore
           Ignore the applied patches in the series.

           Replace the unapplied patches in the series.

       -b BASE, --base BASE
           Use BASE instead of HEAD for file importing.

           Leave the rejected hunks in corresponding *.rej files.

       -e, --edit
           Invoke an editor for the patch description.

       -d, --showdiff
           Show the patch content in the editor buffer.

       -a "NAME <EMAIL>", --author "NAME <EMAIL>"
           Use "NAME <EMAIL>" as the author details.

       --authname AUTHNAME
           Use AUTHNAME as the author name.

       --authemail AUTHEMAIL
           Use AUTHEMAIL as the author e-mail.

       --authdate AUTHDATE
           Use AUTHDATE as the author date.

           Add a "Signed-off-by:" to the end of the patch.

           Add an "Acked-by:" line to the end of the patch.

           Add a "Reviewed-by:" line to the end of the patch.

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 ⟨⟩.
       If you have a bug report for this manual page, see
       ⟨⟩.  This page was obtained from the
       project's upstream Git repository ⟨⟩ on
       2020-02-08.  (At that time, the date of the most recent commit that
       was found in the repository was 2019-11-11.)  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

StGit                            02/08/2020                    STG-IMPORT(1)