.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "GIT-PUBLISH 1" .TH GIT-PUBLISH 1 "2020-01-03" "perl v5.30.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" git\-publish \- Prepare and store patch revisions as git tags .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& git\-publish [options] \-\- [common format\-patch options] .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" git-publish prepares patches and stores them as git tags for future reference. It works with individual patches as well as patch series. Revision numbering is handled automatically. .PP No constraints are placed on git workflow, both vanilla git commands and custom workflow scripts are compatible with git-publish. .PP Email sending and pull requests are fully integrated so that publishing patches can be done in a single command. .PP Hook scripts are invoked during patch preparation so that custom checks or test runs can be automated. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-\-version\fR" 4 .IX Item "--version" Show program's version number and exit. .IP "\fB\-h\fR" 4 .IX Item "-h" .PD 0 .IP "\fB\-\-help\fR" 4 .IX Item "--help" .PD Show help message and exit. .IP "\fB\-\-annotate\fR" 4 .IX Item "--annotate" Review and edit each patch email. .IP "\fB\-b \s-1BASE\s0\fR" 4 .IX Item "-b BASE" .PD 0 .IP "\fB\-\-base=BASE\fR" 4 .IX Item "--base=BASE" .PD Branch which this is based off (defaults to master). .IP "\fB\-\-cc=CC\fR" 4 .IX Item "--cc=CC" Specify a Cc: email recipient. .IP "\fB\-\-cc\-cmd=CC_CMD\fR" 4 .IX Item "--cc-cmd=CC_CMD" Specify a command add whose output to add the Cc: email recipient list. See \fBgit\-send\-email\fR\|(1) for details. .IP "\fB\-\-no\-check\-url\fR" 4 .IX Item "--no-check-url" Do not check whether the pull request \s-1URL\s0 is publicly accessible. .IP "\fB\-\-check\-url\fR" 4 .IX Item "--check-url" Check whether the pull request \s-1URL\s0 is publicly accessible. This is the default. .IP "\fB\-\-edit\fR" 4 .IX Item "--edit" Edit message but do not tag a new version. Use this to draft the cover letter before actually tagging a new version. .IP "\fB\-\-no\-inspect\-emails\fR" 4 .IX Item "--no-inspect-emails" Do not prompt for confirmation before sending emails. .IP "\fB\-\-inspect\-emails\fR" 4 .IX Item "--inspect-emails" Show confirmation before sending emails. .IP "\fB\-n \s-1NUMBER\s0\fR" 4 .IX Item "-n NUMBER" .PD 0 .IP "\fB\-\-number=NUMBER\fR" 4 .IX Item "--number=NUMBER" .PD Explicitly specify the version number (auto-generated by default). .IP "\fB\-\-no\-message\fR" 4 .IX Item "--no-message" .PD 0 .IP "\fB\-\-no\-cover\-letter\fR" 4 .IX Item "--no-cover-letter" .PD Do not add a message. .IP "\fB\-m\fR" 4 .IX Item "-m" .PD 0 .IP "\fB\-\-message\fR" 4 .IX Item "--message" .IP "\fB\-\-cover\-letter\fR" 4 .IX Item "--cover-letter" .PD Add a message. .IP "\fB\-\-no\-binary\fR" 4 .IX Item "--no-binary" Do not output contents of changes in binary files, instead display a notice that those files changed. Patches generated using this option cannot be applied properly, but they are still useful for code review. .IP "\fB\-p \s-1PROFILE_NAME\s0\fR" 4 .IX Item "-p PROFILE_NAME" .PD 0 .IP "\fB\-\-profile=PROFILE_NAME\fR" 4 .IX Item "--profile=PROFILE_NAME" .PD Select default settings from the given profile. .IP "\fB\-\-pull\-request\fR" 4 .IX Item "--pull-request" Tag and send as a pull request. .IP "\fB\-\-sign\-pull\fR" 4 .IX Item "--sign-pull" Sign tag when sending pull request. .IP "\fB\-\-no\-sign\-pull\fR" 4 .IX Item "--no-sign-pull" Do not sign tag when sending pull request. .IP "\fB\-k \s-1KEYID\s0\fR" 4 .IX Item "-k KEYID" .PD 0 .IP "\fB\-\-keyid=KEYID\fR" 4 .IX Item "--keyid=KEYID" .PD Use the given \s-1GPG\s0 key to sign tag when sending pull request .IP "\fB\-\-blurb\-template\fR" 4 .IX Item "--blurb-template" Use a pre-defined blurb message for the series \s-1HEAD.\s0 .IP "\fB\-\-subject\-prefix=PREFIX\fR" 4 .IX Item "--subject-prefix=PREFIX" Set the email Subject: header prefix. .IP "\fB\-\-clear\-subject\-prefix\fR" 4 .IX Item "--clear-subject-prefix" Clear the per-branch subject prefix. The subject prefix persists between versions by default. Use this option to reset it. .IP "\fB\-\-setup\fR" 4 .IX Item "--setup" Add git alias in ~/.gitconfig so that the \*(L"git publish\*(R" git sub-command works. .IP "\fB\-t \s-1TOPIC\s0\fR" 4 .IX Item "-t TOPIC" .PD 0 .IP "\fB\-\-topic=TOPIC\fR" 4 .IX Item "--topic=TOPIC" .PD Set the topic name (defaults to current branch name). .IP "\fB\-\-to=TO\fR" 4 .IX Item "--to=TO" Specify a primary email recipient. .IP "\fB\-s\fR" 4 .IX Item "-s" .PD 0 .IP "\fB\-\-signoff\fR" 4 .IX Item "--signoff" .PD Add Signed-off-by: to commits when emailing. .IP "\fB\-\-notes\fR" 4 .IX Item "--notes" Append the notes for the commit after the three-dash line. See \fBgit\-notes\fR\|(1) for details. .IP "\fB\-\-suppress\-cc=SUPPRESS_CC\fR" 4 .IX Item "--suppress-cc=SUPPRESS_CC" Override auto-cc when sending email. See \fBgit\-send\-email\fR\|(1) for details. .IP "\fB\-v\fR" 4 .IX Item "-v" .PD 0 .IP "\fB\-\-verbose\fR" 4 .IX Item "--verbose" .PD Show executed git commands (useful for troubleshooting). .IP "\fB\-\-forget\-cc\fR" 4 .IX Item "--forget-cc" Forget all previous Cc: email addresses. .IP "\fB\-\-override\-to\fR" 4 .IX Item "--override-to" Ignore any profile or saved To: email addresses. .IP "\fB\-\-override\-cc\fR" 4 .IX Item "--override-cc" Ignore any profile or saved Cc: email addresses. .IP "\fB\-R \s-1IN_REPLY_TO\s0\fR" 4 .IX Item "-R IN_REPLY_TO" .PD 0 .IP "\fB\-\-in\-reply\-to=IN_REPLY_TO\fR" 4 .IX Item "--in-reply-to=IN_REPLY_TO" .PD Specify the In-Reply-To: of the cover letter (or the single patch). .SH "DISCUSSION" .IX Header "DISCUSSION" .SS "Setup" .IX Subsection "Setup" Run git-publish in setup mode to configure the git alias: .PP .Vb 1 \& $ git\-publish \-\-setup .Ve .PP You can now use 'git publish' like a built-in git command. .SS "Quickstart" .IX Subsection "Quickstart" Create a \*(L"topic branch\*(R" on which to do your work (implement a new feature or fix a bug): .PP .Vb 5 \& $ git checkout \-b add\-funny\-jokes \& ... \& $ git commit \& ... \& $ git commit .Ve .PP Send a patch series via email: .PP .Vb 1 \& $ git publish \-\-to patches@example.org \-\-cc maintainer@example.org .Ve .PP Address code review comments and send a new revision: .PP .Vb 3 \& $ git rebase \-i master \& ... \& $ git publish \-\-to patches@example.org \-\-cc maintainer@example.org .Ve .PP Refer back to older revisions: .PP .Vb 1 \& $ git show add\-funny\-jokes\-v1 .Ve .PP This concludes the basic workflow for sending patch series. .SS "Storing patch revisions" .IX Subsection "Storing patch revisions" To store the first revision of a patch series: .PP .Vb 2 \& $ git checkout my\-feature \& $ git publish .Ve .PP This creates the my\-feature\-v1 git tag. Running git-publish again at a later point will create tags with incrementing version numbers: .PP .Vb 4 \& my\-feature\-v1 \& my\-feature\-v2 \& my\-feature\-v3 \& ... .Ve .PP To refer back to a previous version, simply check out that git tag. This way a record is kept of each patch revision that has been published. .PP \fIOverriding the version number\fR .IX Subsection "Overriding the version number" .PP The version number can be set manually. This is handy when starting out with git-publish on branches that were previously manually versioned: .PP .Vb 2 \& $ git checkout my\-existing\-feature \& $ git publish \-\-number 7 .Ve .PP This creates the my\-existing\-feature\-v7 tag. .PP \fIOverriding the branch name\fR .IX Subsection "Overriding the branch name" .PP By default git-publish refuses to create a revision for the 'master' branch. Usually one works with so-called topic branches, one branch for each feature under development. Using the 'master' branch may indicate that one has forgotten to switch onto the intended topic branch. It is possible to override the topic name and even publish on 'master': .PP .Vb 2 \& $ git checkout branch\-a \& $ git publish \-\-topic branch\-b .Ve .PP This creates branch\-b\-v1 instead of branch\-a\-v1 and can be used to skip the check for 'master'. .SS "Tag messages" .IX Subsection "Tag messages" Tag messages have a summary (or subject line) and a description (or blurb). When send email integration is used the summary is put into the cover letter Subject: line while the description is put into the body. .PP When prompting for tag messages on v2, v3, or other incremental revisions, the previous revision's tag message is used as the starting point. This is handy for updating the existing description and keeping a changelog of the difference between revisions. .PP The \fBgit\-config\fR\|(1) format.coverLetter value is honored. The default 'auto' value adds a cover letter if there is more than 1 patch. The cover letter can also be forced with 'true' or 'false'. .PP To insist on creating a tag message: .PP .Vb 1 \& $ git publish \-\-message .Ve .PP To refrain from creating a tag message: .PP .Vb 1 \& $ git publish \-\-no\-message .Ve .PP For convenience these options are also available as \-\-cover\-letter and \&\-\-no\-cover\-letter just like in \fBgit\-format\-patch\fR\|(1). .PP \fIEditing tag messages without publishing\fR .IX Subsection "Editing tag messages without publishing" .PP Sometimes it is useful to edit the tag message before publishing. This can be used to note down changelog entries as you prepare the next version of a patch series. .PP To edit the tag message without publishing: .PP .Vb 1 \& $ git publish \-\-edit .Ve .PP This does not tag a new version. Instead a \-staging tag will be created and the tag message will be picked up when you publish next time. For example, if you on branch my-feature and have already published v1 and v2, editing the tag message will create the tag my-feature-staging. When you publish next time the my\-feature\-v3 tag will be created and use the tag message you staged earlier. .SS "Setting the base branch" .IX Subsection "Setting the base branch" git-publish detects whether the branch contains a single commit or multiple commits by comparing against a base branch ('master' by default). You can specify the base branch like this: .PP .Vb 1 \& $ git publish \-\-base my\-parent .Ve .PP Most of the time 'master' works fine. .PP It is also possible to persist which base branch to use. This is useful if you find yourself often specifying a base branch manually. It can be done globally for all branches in a reposity or just for a specific branch: .PP .Vb 2 \& $ git config git\-publish.base origin/master # for all branches \& $ git config branch.foo.gitpublishbase origin/master # for one branch .Ve .SS "Send email integration" .IX Subsection "Send email integration" git-publish can call \fBgit\-send\-email\fR\|(1) after creating a git tag. If there is a tag message it will be used as the cover letter. Email can be sent like this: .PP .Vb 2 \& $ git publish \-\-to patches@example.org \e \& \-\-cc alex@example.org \-\-cc bob@example.org .Ve .PP After the git tag has been created as usual, commits on top of the base branch are sent as the patch series. The base branch defaults to 'master' and can be set manually with \-\-base. .PP The \fBgit\-send\-email\fR\|(1) aliasesfile feature works since the email addresses are passed through without interpretation by git-publish. .PP Patch emails can be manually edited before being sent, these changes only affect outgoing emails and are not stored permanently: .PP .Vb 1 \& $ git publish \-\-to patches@example.org \-\-annotate .Ve .PP git-publish can background itself so patch emails can be inspected from the shell: .PP .Vb 1 \& $ git publish \-\-to patches@example.org \-\-inspect\-emails .Ve .PP Signed-off-by: lines can be applied to patch emails, only outgoing emails are affected and not the local git commits: .PP .Vb 1 \& $ git publish \-\-to patches@example.org \-\-signoff .Ve .PP Sending [\s-1RFC\s0] series instead of regular [\s-1PATCH\s0] series can be done by customizing the Subject: line: .PP .Vb 1 \& $ git publish \-\-to patches@example.org \-\-subject\-prefix RFC .Ve .PP Using this way, specified \*(L"\-\-subject\-prefix\*(R" will be stored as per-branch subject prefix, and will be used for the next git-publish as well. .PP One can override the stored per-branch subject prefix by providing the \&\-\-subject\-prefix parameter again, or to clear it permanently, we can use: .PP .Vb 1 \& $ git publish \-\-clear\-subject\-prefix .Ve .PP git-publish remembers the list of addresses \s-1CC\s0'd on previous revisions of a patchset by default. To clear that internal list: .PP .Vb 1 \& $ git publish \-\-to patches@example.org \-\-forget\-cc \-\-cc new@example.org .Ve .PP In the above example, new@example.org will be saved to the internal list for next time. .PP \&\s-1CC\s0 addresses accumulate and cascade. Following the previous example, if we want to send a new version to both new@example.org and old@example.org: .PP .Vb 1 \& $ git\-publish \-\-cc old@example.org .Ve .PP To temporarily ignore any CCs in the profile or saved list, and send only to the addresses specified on the \s-1CLI:\s0 .PP .Vb 1 \& $ git\-publish \-\-override\-cc \-\-cc onetime@example.org \-\-to patches@example.org .Ve .PP CCs specified alongside \-\-override\-cc are not remembered for future revisions. .PP .Vb 1 \& $ git publish \-\-to patches@example.org \-\-notes .Ve .PP To include git-notes into a patch. .PP One can attach notes to a commit with `git notes add `. For having the notes \*(L"following\*(R" a commit on rebase operation, you can use `git config notes.rewriteRef refs/notes/commits`. For more information, give a look at \fBgit\-notes\fR\|(1). .SS "Creating profiles for frequently used projects" .IX Subsection "Creating profiles for frequently used projects" Instead of providing command-line options each time a patch series is published, the options can be stored in \fBgit\-config\fR\|(1) files: .PP .Vb 11 \& $ cat >>.git/config \& [gitpublishprofile "example"] \& prefix = PATCH for\-example \& to = patches@example.org \& cc = maintainer1@example.org \& cc = maintainer2@example.org \& ^D \& $ git checkout first\-feature \& $ git publish \-\-profile example \& $ git checkout second\-feature \& $ git publish \-\-profile example .Ve .PP The \*(L"example\*(R" profile is equivalent to the following command-line: .PP .Vb 1 \& $ git publish \-\-subject\-prefix \*(AqPATCH for\-example\*(Aq \-\-to patches@example.org \-\-cc maintainer1@example.org \-\-cc maintainer2@example.org .Ve .PP If command-line options are given together with a profile, then the command-line options take precedence. .PP The following profile options are available: .PP .Vb 12 \& [gitpublishprofile "example"] \& base = v2.1.0 # same as \-\-base \& remote = origin # used if branch..remote not set \& prefix = PATCH # same as \-\-patch \& to = patches@example.org # same as \-\-to \& cc = maintainer@example.org # same as \-\-cc \& suppresscc = all # same as \-\-suppress\-cc \& message = true # same as \-\-message \& signoff = true # same as \-\-signoff \& inspect\-emails = true # same as \-\-inspect\-emails \& notes = true # same as \-\-notes \& blurb\-template = A blurb template # same as \-\-blurb\-template .Ve .PP The special \*(L"default\*(R" profile name is active when no \-\-profile command-line option was given. The default profile does not set any options but can be extended in \fBgit\-config\fR\|(1) files: .PP .Vb 3 \& $ cat >>.git/config \& [gitpublishprofile "default"] \& suppresscc = all # do not auto\-cc people .Ve .PP If a file named .gitpublish exists in the repository top-level directory, it is automatically searched in addition to the \fBgit\-config\fR\|(1) .git/config and ~/.gitconfig files. Since the .gitpublish file can be committed into git, this can be used to provide a default profile for branches that you expect to repeatedly use as a base for new work. .SS "Sending pull requests" .IX Subsection "Sending pull requests" git-publish can send signed pull requests. Signed tags are pushed to a remote git repository that must be readable by the person who will merge the pull request. .PP Ensure that the branch has a default remote repository saved: .PP .Vb 1 \& $ git config branch.foo.remote my\-public\-repo .Ve .PP The remote must be accessible to the person receiving the pull request. Normally the remote \s-1URI\s0 should be git:// or https://. If the remote is configured for ssh:// then \fBgit\-config\fR\|(1) can be supplemented with a public url and private pushurl. This ensures that pull requests always use the public \&\s-1URI:\s0 .PP .Vb 3 \& [remote ""] \& url = https://myhost.com/repo.git \& pushurl = me@myhost.com:repo.git .Ve .PP Send a pull request: .PP .Vb 1 \& $ git publish \-\-pull\-request \-\-to patches@example.org \-\-annotate .Ve .SH "CONFIGURATION" .IX Header "CONFIGURATION" There are three possible levels of configuration with the following order of precedence: .IP "1. Per-branch options only apply to a specific branch." 4 .IX Item "1. Per-branch options only apply to a specific branch." .PD 0 .IP "2. Per-profile options apply when the profile is enabled with \fB\-\-profile\fR." 4 .IX Item "2. Per-profile options apply when the profile is enabled with --profile." .IP "3. Global options apply in all cases." 4 .IX Item "3. Global options apply in all cases." .PD .PP The following configuration options are available: .IP "\fBbranch.BRANCHNAME.gitpublishbase\fR" 4 .IX Item "branch.BRANCHNAME.gitpublishbase" .PD 0 .IP "\fBgitpublishprofile.PROFILENAME.base\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.base" .IP "\fBgit\-publish.base\fR" 4 .IX Item "git-publish.base" .PD Same as the \fB\-\-base\fR option. .IP "\fBbranch.BRANCHNAME.gitpublishto\fR" 4 .IX Item "branch.BRANCHNAME.gitpublishto" .PD 0 .IP "\fBgitpublishprofile.PROFILENAME.to\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.to" .PD Same as the \fB\-\-to\fR option. .IP "\fBbranch.BRANCHNAME.gitpublishcc\fR" 4 .IX Item "branch.BRANCHNAME.gitpublishcc" .PD 0 .IP "\fBgitpublishprofile.PROFILENAME.cc\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.cc" .PD Same as the \fB\-\-cc\fR option. .IP "\fBbranch.BRANCHNAME.gitpublishcccmd\fR" 4 .IX Item "branch.BRANCHNAME.gitpublishcccmd" .PD 0 .IP "\fBgitpublishprofile.PROFILENAME.gitpublishcccmd\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.gitpublishcccmd" .PD Same as the \fB\-\-cc\-cmd\fR option. .IP "\fBgitpublishprofile.PROFILENAME.remote\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.remote" The remote where the pull request tag will be pushed. .IP "\fBgitpublishprofile.PROFILENAME.message\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.message" Same as the \fB\-\-message\fR option. .IP "\fBbranch.BRANCHNAME.gitpublishprefix\fR" 4 .IX Item "branch.BRANCHNAME.gitpublishprefix" .PD 0 .IP "\fBgitpublishprofile.PROFILENAME.prefix\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.prefix" .PD Same as the \fB\-\-subject\-prefix\fR option. .IP "\fBgitpublishprofile.PROFILENAME.suppresscc\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.suppresscc" Same as the \fB\-\-suppress\-cc\fR option. .IP "\fBgitpublishprofile.PROFILENAME.signoff\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.signoff" Same as the \fB\-\-signoff\fR option. .IP "\fBgitpublishprofile.PROFILENAME.inspect\-emails\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.inspect-emails" Same as the \fB\-\-inspect\-emails\fR option. .IP "\fBgitpublishprofile.PROFILENAME.notes\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.notes" Same as the \fB\-\-notes\fR option. .IP "\fBgitpublishprofile.PROFILENAME.checkUrl\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.checkUrl" .PD 0 .IP "\fBgit\-publish.checkUrl\fR" 4 .IX Item "git-publish.checkUrl" .PD Same as the \fB\-\-no\-check\-url\fR and \fB\-\-check\-url\fR options. .IP "\fBgitpublishprofile.PROFILENAME.signPull\fR" 4 .IX Item "gitpublishprofile.PROFILENAME.signPull" .PD 0 .IP "\fBgit\-publish.signPull\fR" 4 .IX Item "git-publish.signPull" .PD Same as the \fB\-\-no\-sign\-pull\fR and \fB\-\-sign\-pull\fR options. .IP "\fBgit\-publish.signingkey\fR" 4 .IX Item "git-publish.signingkey" Same as the \fB\-\-keyid\fR option. .SH "HOOKS" .IX Header "HOOKS" git-publish supports the \fBgithooks\fR\|(5) mechanism for running user scripts at important points during the workflow. The script can influence the outcome of the operation, for example, by rejecting a patch series that is about to be sent out. .PP Available hooks include: .IP "\fBpre-publish-send-email\fR" 4 .IX Item "pre-publish-send-email" Invoked before \fBgit\-send\-email\fR\|(1). Takes the path to the patches directory as an argument. If the exit code is non-zero, the series will not be sent. .IP "\fBpre-publish-tag\fR" 4 .IX Item "pre-publish-tag" Invoked before creating the \-staging tag on current branch. Takes one argument which refers to the base commit or branch. If the exit code is non-zero, git-publish will abort. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBgit\-format\-patch\fR\|(1), \fBgit\-send\-email\fR\|(1), \fBgit\-config\fR\|(1), \fBgit\-notes\fR\|(1), \fBgithooks\fR\|(5) .SH "AUTHOR" .IX Header "AUTHOR" Stefan Hajnoczi .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright (C) 2011\-2018 Stefan Hajnoczi