stg-import(1) — Linux manual page


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 stack.

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

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

       -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 2021-04-01.  (At that time, the
       date of the most recent commit that was found in the repository
       was 2021-02-15.)  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                          04/01/2021                  STG-IMPORT(1)