# [PATCH v2] git-check-ref-format: clarify man for --normalize 3 messages from 2017-02-19 to 2017-02-20. Participants: Damien Regad, Jeff King, Junio C Hamano. Thread: https://gitlist.dev/t/45178 ## Damien Regad, 2017-02-19 22:32 Subject: [PATCH v2] git-check-ref-format: clarify man for --normalize Message-ID: <44113ef6-5669-5e02-f848-27c17fac55e5@gmail.com> URL: https://gitlist.dev/e/44113ef6-5669-5e02-f848-27c17fac55e5%40gmail.com ``` Use of 'iff' may be confusing to people not familiar with this term. Improving the --normalize option's documentation to remove the use of 'iff', and clearly describe what happens when the condition is not met. --- Documentation/git-check-ref-format.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Documentation/git-check-ref-format.txt b/Documentation/git-check-ref-format.txt index 8611a99..92777ce 100644 --- a/Documentation/git-check-ref-format.txt +++ b/Documentation/git-check-ref-format.txt @@ -100,10 +100,10 @@ OPTIONS --normalize:: Normalize 'refname' by removing any leading slash (`/`) characters and collapsing runs of adjacent slashes between - name components into a single slash. Iff the normalized + name components into a single slash. If the normalized refname is valid then print it to standard output and exit - with a status of 0. (`--print` is a deprecated way to spell - `--normalize`.) + with a status of 0, otherwise exit with a non-zero status. + (`--print` is a deprecated way to spell `--normalize`.) EXAMPLES -- 2.7.4 ``` ## Jeff King, 2017-02-20 00:47 Subject: Re: [PATCH v2] git-check-ref-format: clarify man for --normalize Message-ID: <20170220004717.7nqwk62vnuqv2rbb@sigill.intra.peff.net> URL: https://gitlist.dev/e/20170220004717.7nqwk62vnuqv2rbb%40sigill.intra.peff.net In-Reply-To: <44113ef6-5669-5e02-f848-27c17fac55e5@gmail.com> ``` On Sun, Feb 19, 2017 at 11:32:32PM +0100, Damien Regad wrote: > Use of 'iff' may be confusing to people not familiar with this term. > > Improving the --normalize option's documentation to remove the use of > 'iff', and clearly describe what happens when the condition is not met. Looks good to me. Thanks for following up. -Peff ``` ## Junio C Hamano, 2017-02-20 09:10 Subject: Re: [PATCH v2] git-check-ref-format: clarify man for --normalize Message-ID: URL: https://gitlist.dev/e/xmqqtw7pjki3.fsf%40gitster.mtv.corp.google.com In-Reply-To: <20170220004717.7nqwk62vnuqv2rbb@sigill.intra.peff.net> ``` Jeff King writes: > On Sun, Feb 19, 2017 at 11:32:32PM +0100, Damien Regad wrote: > >> Use of 'iff' may be confusing to people not familiar with this term. >> >> Improving the --normalize option's documentation to remove the use of >> 'iff', and clearly describe what happens when the condition is not met. > > Looks good to me. Thanks for following up. Looks good except that there does not seem to be sign-off. Damien, no need to resend the patch but I need to hear you say that you have read Documentation/SubmittingPatches and you want your sign-off added. Thanks. ```