# Minor annoyance with 'git interpret-trailers' 4 messages from 2015-08-20 to 2015-08-21. Participants: Matthieu Moy, Christian Couder. Thread: https://gitlist.dev/t/40142 ## Matthieu Moy, 2015-08-20 16:37 Subject: Minor annoyance with 'git interpret-trailers' Message-ID: URL: https://gitlist.dev/e/vpqy4h5ud9z.fsf%40anie.imag.fr ``` Hi, I use 'git interpret-trailers' as a commit-msg hook to add a Signed-off-by in a repository. When used in a one-line commit message formatted like 'foo: do something', the command interprets the one-line summary as a trailer, and inserts my Signed-off-by after it, without a blank line: foo: do something Signed-off-by: Matthieu Moy This breaks the convention "One summary line, one blank line, and then body", and shows my sign-off in the output of "git log --oneline" :-(. I think the behavior "don't insert a newline if the last line looks like a trailer" should be disabled when the message is a one-liner. Cheers, -- Matthieu Moy http://www-verimag.imag.fr/~moy/ ``` ## Christian Couder, 2015-08-20 16:53 Subject: Re: Minor annoyance with 'git interpret-trailers' Message-ID: URL: https://gitlist.dev/e/CAP8UFD0YcBdAfMJxc2bQD_zTp%2BkPk2L2sQfWYzTDn%2BtrFk%2BDMA%40mail.gmail.com In-Reply-To: ``` On Thu, Aug 20, 2015 at 6:37 PM, Matthieu Moy wrote: > Hi, > > I use 'git interpret-trailers' as a commit-msg hook to add a > Signed-off-by in a repository. > > When used in a one-line commit message formatted like > 'foo: do something', the command interprets the one-line summary as a > trailer, and inserts my Signed-off-by after it, without a blank line: > > foo: do something > Signed-off-by: Matthieu Moy > > This breaks the convention "One summary line, one blank line, and then > body", and shows my sign-off in the output of "git log --oneline" :-(. > > I think the behavior "don't insert a newline if the last line looks like > a trailer" should be disabled when the message is a one-liner. Yeah, I agree. I will take a look at fixing that soon. Thanks for the report, Christian. ``` ## Christian Couder, 2015-08-20 21:59 Subject: [PATCH] trailer: ignore first line of message Message-ID: <1440107955-26892-1-git-send-email-chriscool@tuxfamily.org> URL: https://gitlist.dev/e/1440107955-26892-1-git-send-email-chriscool%40tuxfamily.org In-Reply-To: ``` When looking for the start of the trailers in the message we are passed, we should ignore the first line of the message. The reason is that if we are passed a patch or commit message then the first line should be the patch title. If we are passed only trailers we can expect that they start with an empty line that can be ignored too. This way we can properly process commit messages that have only one line with something that looks like a trailer, for example like "area of code: change we made". Signed-off-by: Christian Couder --- t/t7513-interpret-trailers.sh | 15 ++++++++++++++- trailer.c | 3 ++- 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/t/t7513-interpret-trailers.sh b/t/t7513-interpret-trailers.sh index bd0ab46..f7ebc5e 100755 --- a/t/t7513-interpret-trailers.sh +++ b/t/t7513-interpret-trailers.sh @@ -93,12 +93,25 @@ test_expect_success 'with config option on the command line' ' Acked-by: Johan Reviewed-by: Peff EOF - echo "Acked-by: Johan" | + { echo; echo "Acked-by: Johan"; } | git -c "trailer.Acked-by.ifexists=addifdifferent" interpret-trailers \ --trailer "Reviewed-by: Peff" --trailer "Acked-by: Johan" >actual && test_cmp expected actual ' +test_expect_success 'with message that contains only a title' ' + cat >expected <<-\EOF && + area: change + + Reviewed-by: Peff + Acked-by: Johan + EOF + echo "area: change" | + git interpret-trailers --trailer "Reviewed-by: Peff" \ + --trailer "Acked-by: Johan" >actual && + test_cmp expected actual +' + test_expect_success 'with config setup' ' git config trailer.ack.key "Acked-by: " && cat >expected <<-\EOF && diff --git a/trailer.c b/trailer.c index 4b14a56..af80b8e 100644 --- a/trailer.c +++ b/trailer.c @@ -740,8 +740,9 @@ static int find_trailer_start(struct strbuf **lines, int count) /* * Get the start of the trailers by looking starting from the end * for a line with only spaces before lines with one separator. + * The start cannot be the first line. */ - for (start = count - 1; start >= 0; start--) { + for (start = count - 1; start >= 1; start--) { if (lines[start]->buf[0] == comment_line_char) continue; if (contains_only_spaces(lines[start]->buf)) { -- 2.5.0.400.gff86faf.dirty ``` ## Matthieu Moy, 2015-08-21 07:01 Subject: Re: [PATCH] trailer: ignore first line of message Message-ID: URL: https://gitlist.dev/e/vpqk2sprupd.fsf%40anie.imag.fr In-Reply-To: <1440107955-26892-1-git-send-email-chriscool@tuxfamily.org> ``` Christian Couder writes: > When looking for the start of the trailers in the message > we are passed, we should ignore the first line of the message. Thanks, this fixes my issue. There's one more corner-case I've just thought of: git commit -m 'place of code: change we made' (with the line break) Git considers this message as a summary line broken in the middle. "git log --oneline" shows it as a one-liner, as if it were 'place of code: change we made'. Even with your patch, the trailer is added without a blank line, and renders on the subject line in `git log --oneline`. My command above with a commit-msg hook outputs: [master 86f32d5] place of: code: change we made Signed-off-by: Matthieu Moy (on a single line) I do not care deeply, but you may want to let interpret-trailers deal with this case too. Thanks, -- Matthieu Moy http://www-verimag.imag.fr/~moy/ ```