git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: Making a patch: "git format-patch" does not produce the documented format

From
Junio C Hamano <gitster@pobox.com>
Date
Aug 2, 2013, 23:28 UTC
Message-ID
<7vzjszoep8.fsf@alter.siamese.dyndns.org>
In-Reply-To
<201308022211.r72MBT9G020153@freeze.ariadne.com>
worley@alum.mit.edu (Dale R. Worley) writes:
> I'm preparing some clarifications of SubmittingPatches to explain
> things that a new person (e.g., me) would not know.

I am not sure if SubmittingPatches is a good place, though. The document is a guidance for people who contribute to _this_ project.

But the specialness of the first paragraph applies to any project that uses Git, so people other than those who contribute to this project should be aware of it.

Originally we literally used "first line", but that made many things like shortlog output and patch Subject: useless when people write a block of text starting from the first line without a title. Also after resurrecting such a text from e-mail, "am" couldn't tell if the "first line" on the "Subject:" is meant to be the first line of the same first paragraph (which is not what we encourage), or it is properly a single line title, and need a blank line before the first line of the body. So quite a while ago, we changed the rule to take "the first paragraph" and use that in these places where we want to give a title of a patch.

Previous: Dale R. Worley
Message 4 of 4 in “Making a patch: "git format-patch" does not produce the documented format”
  1. Dale R. WorleyJul 31, 2013
  2. John KeepingJul 31, 2013
  3. Dale R. WorleyAug 2, 2013
  4. Junio C HamanoAug 2, 2013

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.