summaryrefslogtreecommitdiffstats
path: root/git-p4.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2020-04-22 14:41:44 -0700
committerJunio C Hamano <gitster@pobox.com>2020-04-22 14:41:44 -0700
commit67bf224a9fb3cd34ef712113c48f3144a9bc232a (patch)
treeb3406220064904e5c16814c16b29375806646762 /git-p4.html
parent0c3c56d58eecca238d9219bfe80754e089939b99 (diff)
downloadgit-htmldocs-67bf224a9fb3cd34ef712113c48f3144a9bc232a.tar.gz
Autogenerated HTML docs for v2.26.2-266-ge8703
Diffstat (limited to 'git-p4.html')
-rw-r--r--git-p4.html41
1 files changed, 38 insertions, 3 deletions
diff --git a/git-p4.html b/git-p4.html
index 81fe83993..9b4abbc52 100644
--- a/git-p4.html
+++ b/git-p4.html
@@ -1289,14 +1289,49 @@ options described above.</p></div>
</dd>
</dl></div>
</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_hooks_for_submit">Hooks for submit</h2>
+<div class="sectionbody">
<div class="sect2">
-<h3 id="_hook_for_submit">Hook for submit</h3>
+<h3 id="_p4_pre_submit">p4-pre-submit</h3>
<div class="paragraph"><p>The <code>p4-pre-submit</code> hook is executed if it exists and is executable.
The hook takes no parameters and nothing from standard input. Exiting with
-non-zero status from this script prevents <code>git-p4 submit</code> from launching.</p></div>
+non-zero status from this script prevents <code>git-p4 submit</code> from launching.
+It can be bypassed with the <code>--no-verify</code> command line option.</p></div>
<div class="paragraph"><p>One usage scenario is to run unit tests in the hook.</p></div>
</div>
<div class="sect2">
+<h3 id="_p4_prepare_changelist">p4-prepare-changelist</h3>
+<div class="paragraph"><p>The <code>p4-prepare-changelist</code> hook is executed right after preparing
+the default changelist message and before the editor is started.
+It takes one parameter, the name of the file that contains the
+changelist text. Exiting with a non-zero status from the script
+will abort the process.</p></div>
+<div class="paragraph"><p>The purpose of the hook is to edit the message file in place,
+and it is not supressed by the <code>--no-verify</code> option. This hook
+is called even if <code>--prepare-p4-only</code> is set.</p></div>
+</div>
+<div class="sect2">
+<h3 id="_p4_changelist">p4-changelist</h3>
+<div class="paragraph"><p>The <code>p4-changelist</code> hook is executed after the changelist
+message has been edited by the user. It can be bypassed with the
+<code>--no-verify</code> option. It takes a single parameter, the name
+of the file that holds the proposed changelist text. Exiting
+with a non-zero status causes the command to abort.</p></div>
+<div class="paragraph"><p>The hook is allowed to edit the changelist file and can be used
+to normalize the text into some project standard format. It can
+also be used to refuse the Submit after inspect the message file.</p></div>
+</div>
+<div class="sect2">
+<h3 id="_p4_post_changelist">p4-post-changelist</h3>
+<div class="paragraph"><p>The <code>p4-post-changelist</code> hook is invoked after the submit has
+successfully occured in P4. It takes no parameters and is meant
+primarily for notification and cannot affect the outcome of the
+git p4 submit action.</p></div>
+</div>
+<div class="sect2">
<h3 id="_rebase_options">Rebase options</h3>
<div class="paragraph"><p>These options can be used to modify <em>git p4 rebase</em> behavior.</p></div>
<div class="dlist"><dl>
@@ -1888,7 +1923,7 @@ Each commit imported by <em>git p4</em> has a line at the end of the log
<div id="footer">
<div id="footer-text">
Last updated
- 2020-03-10 08:03:13 PDT
+ 2020-04-22 14:37:28 PDT
</div>
</div>
</body>