format-patch: "--rfc=-(WIP)" appends to produce [PATCH (WIP)]
commitce36894509bac4c03fd524fc668b1e43d6e56ee1
authorJunio C Hamano <gitster@pobox.com>
Tue, 23 Apr 2024 17:52:34 +0000 (23 10:52 -0700)
committerJunio C Hamano <gitster@pobox.com>
Tue, 23 Apr 2024 18:00:39 +0000 (23 11:00 -0700)
treefb147cad8677f6f5c9bb3f91a6f2ac675e497e53
parentce48fb2eabccc269443f33d0f148d0061b94a101
format-patch: "--rfc=-(WIP)" appends to produce [PATCH (WIP)]

In the previous step, the "--rfc" option of "format-patch" learned
to take an optional string value to prepend to the subject prefix,
so that --rfc=WIP can give "[WIP PATCH]".

There may be cases in which the extra string wants to come after the
subject prefix.  Extend the mechanism to allow "--rfc=-(WIP)" [*] to
signal that the extra string is to be appended instead of getting
prepended, resulting in "[PATCH (WIP)]".

In the documentation, discourage (ab)using "--rfc=-RFC" to say
"[PATCH RFC]" just to be different, when "[RFC PATCH]" is the norm.

[Footnote]

 * The syntax takes inspiration from Perl's open syntax that opens
   pipes "open fh, '|-', 'cmd'", where the dash signals "the other
   stuff comes here".

Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-format-patch.txt
builtin/log.c
t/t4014-format-patch.sh