'\" t
.\" Title: guilt-new
.\" Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot
.\" Date: 01/12/2023
.\" Manual: Guilt Manual
.\" Source: Guilt v0.36
.\" Language: English
.\"
.TH "GUILT\-NEW" "1" "01/12/2023" "Guilt v0\&.36" "Guilt Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
guilt-new \- Create a new patch
.SH "SYNOPSIS"
\fIguilt new\fR [\-f] [\-s] [\-e|\-m message]
.SH "DESCRIPTION"
Create a new patch and push it on top of the stack\&. An optional patch description can be supplied either interactively on via the command line\&.
.SH "OPTIONS"
.PP
\-f
.RS 4
Force patch creation if there are unrefreshed changes\&. These changes will get automatically imported into the new patch\&.
.RE
.PP
\-s
.RS 4
Add a Signed\-off\-by with your committer identifier string to the patch message\&.
.RE
.PP
\-e
.RS 4
Edit the patch message interactively\&. This option can be combined with \-s to easily sign off on the patch\&.
.RE
.PP
\-m
.RS 4
The "" string will used as the commit message\&. This option can be combined with \-s to easily sign off on the patch\&.
.RE
.PP
.RS 4
Name of the patch to create\&. This must be a legal relative pathname string\&. For example, "foo", "foo/bar", and "foo/bar/foobar" are all valid\&.
.RE
.SH "EXAMPLES"
Create a new patch called \fIfoobar\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
$ guilt new foobar
.fi
.if n \{\
.RE
.\}
.sp
Create a patch called \fIfoo\fR and supply a patch description interactively:
.sp
.if n \{\
.RS 4
.\}
.nf
$ guilt new \-e foo
.fi
.if n \{\
.RE
.\}
.sp
Create a patch called \fIbar\fR with a provided patch description and sign off on the patch:
.sp
.if n \{\
.RS 4
.\}
.nf
$ guilt new \-s \-m patch\-fu bar
.fi
.if n \{\
.RE
.\}
.SH "AUTHOR"
Written by Josef "Jeff" Sipek <\m[blue]\fBjeffpc@josefsipek\&.net\fR\m[]\&\s-2\u[1]\d\s+2>
.SH "DOCUMENTATION"
Documentation by Josef "Jeff" Sipek <\m[blue]\fBjeffpc@josefsipek\&.net\fR\m[]\&\s-2\u[1]\d\s+2>
.SH "GUILT"
Part of the \fBguilt\fR(7) suite (Generated for Guilt v0\&.36)
.SH "NOTES"
.IP " 1." 4
jeffpc@josefsipek.net
.RS 4
\%mailto:jeffpc@josefsipek.net
.RE