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

[PATCH] format-patch: autonumber by default

From
Brian Gernhardt <benji@silverinsanity.com>
Date
Oct 2, 2008, 20:41 UTC
Message-ID
<20081002204145.GA98400@Hermes>
In-Reply-To
<91634D16-B28A-4458-97A9-C469B5AF4E5D@silverinsanity.com>

format-patch is most commonly used for multiple patches at once when sending a patchset, in which case we want to number the patches; on the other hand, single patches are not usually expected to be numbered.

In other words, the typical behavior expected from format-patch is the one obtained by enabling autonumber, so we set it to be the default.

Users that want to disable numbering for a particular patchset can do so with the existing -N command-line switch. Users that want to change the default behavior can use the format.numbering config key.

Signed-off-by: Brian Gernhardt <benji@silverinsanity.com>
---
 This is what I was talking about.  The appropriate setting to turn it off is
 "false", not "noauto".
 Re-sending with the correct CC list.
 Documentation/config.txt           |    9 +++++----
 Documentation/git-format-patch.txt |    8 +++++---
 builtin-log.c                      |    3 ++-
 3 files changed, 12 insertions(+), 8 deletions(-)
diff --git a/Documentation/config.txt b/Documentation/config.txt
index da18a54..5ba3ffa 100644
--- a/Documentation/config.txt
+++ b/Documentation/config.txt
@@ -640,10 +640,11 @@ fetch.unpackLimit::
 	`transfer.unpackLimit` is used instead.
 
 format.numbered::
-	A boolean which can enable sequence numbers in patch subjects.
-	Setting this option to "auto" will enable it only if there is
-	more than one patch.  See --numbered option in
-	linkgit:git-format-patch[1].
+	A boolean which can enable or disable sequence numbers in patch
+	subjects.  It defaults to "auto" which enables it only if there
+	is more than one patch.  It can be enabled or disabled for all
+	messages by setting it to "true" or "false".  See --numbered
+	option in linkgit:git-format-patch[1].
 
 format.headers::
 	Additional email headers to include in a patch to be submitted
diff --git a/Documentation/git-format-patch.txt b/Documentation/git-format-patch.txt
index adb4ea7..ac36ce8 100644
--- a/Documentation/git-format-patch.txt
+++ b/Documentation/git-format-patch.txt
@@ -58,8 +58,10 @@ output, unless the --stdout option is specified.
 If -o is specified, output files are created in <dir>.  Otherwise
 they are created in the current working directory.
 
-If -n is specified, instead of "[PATCH] Subject", the first line
-is formatted as "[PATCH n/m] Subject".
+By default, the subject of a single patch is "[PATCH] First Line" and
+the subject when multiple patches are output is "[PATCH n/m] First
+Line". To force 1/1 to be added for a single patch, use -n.  To omit
+patch numbers from the subject, use -N
 
 If given --thread, 'git-format-patch' will generate In-Reply-To and
 References headers to make the second and subsequent patch mails appear
@@ -81,7 +83,7 @@ include::diff-options.txt[]
 
 -n::
 --numbered::
-	Name output in '[PATCH n/m]' format.
+	Name output in '[PATCH n/m]' format, even with a single patch.
 
 -N::
 --no-numbered::
diff --git a/builtin-log.c b/builtin-log.c
index fc5e4da..93987ee 100644
--- a/builtin-log.c
+++ b/builtin-log.c
@@ -426,7 +426,7 @@ static int istitlechar(char c)
 
 static const char *fmt_patch_suffix = ".patch";
 static int numbered = 0;
-static int auto_number = 0;
+static int auto_number = 1;
 
 static char **extra_hdr;
 static int extra_hdr_nr;
@@ -485,6 +485,7 @@ static int git_format_config(const char *var, const char *value, void *cb)
 			return 0;
 		}
 		numbered = git_config_bool(var, value);
+		auto_number &&= numbered;
 		return 0;
 	}
 
-- 
1.6.0.2.589.gcd70
Previous: Brian GernhardtNext: Brian Gernhardt
Message 14 of 21 in “format-patch: autonumber by default”
  1. format-patch: autonumber by defaultGiuseppe Bilotta, Oct 2, 2008
  2. Johannes SchindelinOct 2, 2008
  3. Giuseppe BilottaOct 2, 2008
  4. Johannes SchindelinOct 2, 2008
  5. format-patch: autonumber by defaultGiuseppe Bilotta, Oct 2, 2008
  6. Jakub NarebskiOct 2, 2008
  7. Andreas EricssonOct 2, 2008
  8. format-patch: autonumber by defaultGiuseppe Bilotta, Oct 2, 2008
  9. Jeff KingOct 2, 2008
  10. format-patch: autonumber by defaultGiuseppe Bilotta, Oct 2, 2008
  11. Jeff KingOct 2, 2008
  12. Brian GernhardtOct 2, 2008
  13. format-patch: autonumber by defaultBrian Gernhardt, Oct 2, 2008
  14. format-patch: autonumber by defaultBrian Gernhardt, Oct 2, 2008
  15. Brian GernhardtOct 2, 2008
  16. format-patch: autonumber by defaultBrian Gernhardt, Oct 2, 2008
  17. Eric W. BiedermanNov 4, 2009
  18. Junio C HamanoNov 4, 2009
  19. Brian GernhardtNov 4, 2009
  20. Andreas EricssonOct 2, 2008
  21. Johannes SixtOct 2, 2008

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.