stg-import - Man Page

Import a GNU diff file as a new patch

Synopsis

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

Description

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

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

-C N

Ensure N lines of surrounding context for each change.

-i,  --ignore

Ignore the applied patches in the series.

--replace

Replace the unapplied patches in the series.

-b BASE, --base BASE

Use BASE instead of HEAD for file importing.

--reject

Leave the rejected hunks in corresponding *.rej files.

--keep-cr

Do not remove "\r" from email lines ending with "\r\n".

--message-id

Create Message-Id trailer in patch description based on the Message-ID email header. This option is applicable when importing with --mail or --mbox. This behavior may also be enabled via the stgit.import.message-id configuration option.

-e,  --edit

Invoke an editor for the patch description.

-d,  --showdiff

Show the patch content in the editor buffer.

--author "NAME <EMAIL>"

Set the author details.

--authname NAME

Set the author name.

--authemail EMAIL

Set the author email.

--authdate DATE

Set the author date.

--sign

Add a "Signed-off-by:" trailer to the end of the message using the committer name and email for the trailer value.

--sign-by VALUE

Add a "Signed-off-by:" trailer with a custom VALUE to the end of the message.

--ack

Add an "Acked-by:" trailer to the end of the message using the commiter name and email for the trailer value.

--ack-by VALUE

Add an "Acked-by:" trailer with a custom VALUE to the end of the message.

--review

Add a "Reviewed-by:" trailer to the end of the message using the commiter name and email for the trailer value.

--review-by VALUE

Add a "Reviewed-by:" trailer with custom VALUE to the end of the message.

Stgit

Part of the StGit suite - see stg(1)

Info

01/22/2022 StGit 1.4 StGit Manual