]> git.ipfire.org Git - thirdparty/git.git/commit
doc: am: fill out hook discussion
authorKristoffer Haugsbakk <code@khaugsbakk.name>
Mon, 9 Feb 2026 17:34:37 +0000 (18:34 +0100)
committerJunio C Hamano <gitster@pobox.com>
Mon, 9 Feb 2026 18:34:05 +0000 (10:34 -0800)
commitb10e0cb1f391a4466f8d7c4b2550a8b89fda3573
treef9d3c923427ad0642453c8fef12c4e5706b0ed00
parentc2f700ac27f8d382acb8d4e49b0f714234604fe4
doc: am: fill out hook discussion

Document `--verify` and rephrase the `--[no-]verify` section to lead
with the default, in imperative mood.[1]

Historically it makes sense that only the negated forms are documented;
they are all run by default and thus you only need to use hook options
if you want to turn some of them off. But, beyond just desiring uniform
documentation,[2] it’s very much possible to have, say, a Git alias with
`--no-verify` that you might sometimes want to turn back on with
the *positive* form.

Also mention the options in the “Hooks” section and mention that
`post-applypatch` cannot be skipped.

† 1: See e.g. acffc5e9 (doc: convert git-remote to synopsis style,
     2025-12-20)
† 2: https://lore.kernel.org/git/xmqqcyct1mtq.fsf@gitster.g/

Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-am.adoc