threads / patch / 11919

patch, 4 partsRetain extra blank lines between the summary and the body

Subject: [PATCH 3/4] Retain extra blank lines between the summary and the body

## tl;dr

4 messages between Feb 6, 2008 and Feb 7, 2008. Diffs are folded; open one to read it.

replies: 3people: 2as markdown or json

Daniel Barkalow· Feb 6, 2008, 16:43 UTC · lore

This is so that it's possible to have a message that will generate an email with the first line blank. If the email you're generating is actually a template, you may have a single line filling in for a ~3-line paragraph, meaning that the space starts with a blank line, which was impossible before as output from the message-splitting code.

Signed-off-by: Daniel Barkalow <barkalow@iabervon.org>
---
 pretty.c |    4 ----
 1 files changed, 0 insertions(+), 4 deletions(-)
Show changes to pretty.c +0 −4
diff --git a/pretty.c b/pretty.c
index f82380b..98efac2 100644
--- a/pretty.c
+++ b/pretty.c
@@ -713,7 +713,6 @@ void pp_remainder(enum cmit_fmt fmt,
 		  struct strbuf *sb,
 		  int indent)
 {
-	int first = 1;
 	for (;;) {
 		const char *line = *msg_p;
 		int linelen = get_one_line(line);
@@ -723,12 +722,9 @@ void pp_remainder(enum cmit_fmt fmt,
 			break;
 
 		if (is_empty_line(line, &linelen)) {
-			if (first)
-				continue;
 			if (fmt == CMIT_FMT_SHORT)
 				break;
 		}
-		first = 0;
 
 		strbuf_grow(sb, linelen + indent + 20);
 		if (indent) {
-- 
1.5.4.27.gf6864
Junio C Hamano· Feb 6, 2008, 20:30 UTC · re: Daniel Barkalow · lore

Re: [PATCH 3/4] Retain extra blank lines between the summary and the body

Daniel Barkalow <barkalow@iabervon.org> writes:
Show 36 quoted lines
> This is so that it's possible to have a message that will generate an
> email with the first line blank. If the email you're generating is
> actually a template, you may have a single line filling in for a
> ~3-line paragraph, meaning that the space starts with a blank line,
> which was impossible before as output from the message-splitting code.
>
> Signed-off-by: Daniel Barkalow <barkalow@iabervon.org>
> ---
>  pretty.c |    4 ----
>  1 files changed, 0 insertions(+), 4 deletions(-)
>
> diff --git a/pretty.c b/pretty.c
> index f82380b..98efac2 100644
> --- a/pretty.c
> +++ b/pretty.c
> @@ -713,7 +713,6 @@ void pp_remainder(enum cmit_fmt fmt,
>  		  struct strbuf *sb,
>  		  int indent)
>  {
> -	int first = 1;
>  	for (;;) {
>  		const char *line = *msg_p;
>  		int linelen = get_one_line(line);
> @@ -723,12 +722,9 @@ void pp_remainder(enum cmit_fmt fmt,
>  			break;
>  
>  		if (is_empty_line(line, &linelen)) {
> -			if (first)
> -				continue;
>  			if (fmt == CMIT_FMT_SHORT)
>  				break;
>  		}
> -		first = 0;
>  
>  		strbuf_grow(sb, linelen + indent + 20);
>  		if (indent) {

I have to wonder if this regresses the normal codepath to cleanse commit messages that have extra blanks at the beginning.

Daniel Barkalow· Feb 6, 2008, 22:17 UTC · re: Junio C Hamano · lore

Re: [PATCH 3/4] Retain extra blank lines between the summary and the body

On Wed, 6 Feb 2008, Junio C Hamano wrote:
Show 42 quoted lines
> Daniel Barkalow <barkalow@iabervon.org> writes:
> 
> > This is so that it's possible to have a message that will generate an
> > email with the first line blank. If the email you're generating is
> > actually a template, you may have a single line filling in for a
> > ~3-line paragraph, meaning that the space starts with a blank line,
> > which was impossible before as output from the message-splitting code.
> >
> > Signed-off-by: Daniel Barkalow <barkalow@iabervon.org>
> > ---
> >  pretty.c |    4 ----
> >  1 files changed, 0 insertions(+), 4 deletions(-)
> >
> > diff --git a/pretty.c b/pretty.c
> > index f82380b..98efac2 100644
> > --- a/pretty.c
> > +++ b/pretty.c
> > @@ -713,7 +713,6 @@ void pp_remainder(enum cmit_fmt fmt,
> >  		  struct strbuf *sb,
> >  		  int indent)
> >  {
> > -	int first = 1;
> >  	for (;;) {
> >  		const char *line = *msg_p;
> >  		int linelen = get_one_line(line);
> > @@ -723,12 +722,9 @@ void pp_remainder(enum cmit_fmt fmt,
> >  			break;
> >  
> >  		if (is_empty_line(line, &linelen)) {
> > -			if (first)
> > -				continue;
> >  			if (fmt == CMIT_FMT_SHORT)
> >  				break;
> >  		}
> > -		first = 0;
> >  
> >  		strbuf_grow(sb, linelen + indent + 20);
> >  		if (indent) {
> 
> I have to wonder if this regresses the normal codepath to
> cleanse commit messages that have extra blanks at the
> beginning.

When we discussed this ages ago, I think we came to the conclusion that it didn't matter. The code doesn't remove extra blank lines from between body paragraphs, so it's a bit arbitrary to remove them between the first line and the following paragraph. And people tend not to have commit messages with blank lines there (in fact, I think git strips them out on commit).

	-Daniel
*This .sig left intentionally blank*
Junio C Hamano· Feb 7, 2008, 09:09 UTC · re: Daniel Barkalow · lore

Re: [PATCH 3/4] Retain extra blank lines between the summary and the body

Daniel Barkalow <barkalow@iabervon.org> writes:
Show 5 quoted lines
> When we discussed this ages ago, I think we came to the conclusion that it 
> didn't matter. The code doesn't remove extra blank lines from between body 
> paragraphs, so it's a bit arbitrary to remove them between the first line 
> and the following paragraph. And people tend not to have commit messages 
> with blank lines there (in fact, I think git strips them out on commit).

Ah, then "Stripping only at the beginning is inconsistent and wrong" would be a better description. Then that's fine by me in either case.

Thanks for a reminder.

← back to recent threads