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

[PATCH v4 12/23] Makefiles: add "shared.mak", move ".DELETE_ON_ERROR" to it

From
Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Date
Nov 17, 2021, 10:20 UTC
Message-ID
<patch-v4-12.23-30ddf7da2c8-20211117T101807Z-avarab@gmail.com>
In-Reply-To
<cover-v4-00.23-00000000000-20211117T101807Z-avarab@gmail.com>

We have various behavior that's shared across our Makefiles, or that really should be (e.g. via defined templates). Let's create a top-level "shared.mak" to house those sorts of things, and start by adding the ".DELETE_ON_ERROR" flag to it.

See my own 7b76d6bf221 (Makefile: add and use the ".DELETE_ON_ERROR" flag, 2021-06-29) and db10fc6c09f (doc: simplify Makefile using .DELETE_ON_ERROR, 2021-05-21) for the addition and use of the ".DELETE_ON_ERROR" flag.

This does have the potential downside that if e.g. templates/Makefile would like to include this "shared.mak" in the future the semantics of such a Makefile will change, but as noted in the above commits (and GNU make's own documentation) any such change would be for the better, so it's safe to do this.

This also doesn't introduce a bug by e.g. having this ".DELETE_ON_ERROR" flag only apply to this new shared.mak, Makefiles have no such scoping semantics.

Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
---
 Documentation/Makefile |  6 +++---
 Makefile               | 13 +++----------
 shared.mak             |  9 +++++++++
 3 files changed, 15 insertions(+), 13 deletions(-)
 create mode 100644 shared.mak
diff --git a/Documentation/Makefile b/Documentation/Makefile
index ed656db2ae9..ba27456c86a 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -1,3 +1,6 @@
+# Import tree-wide shared Makefile behavior and libraries
+include ../shared.mak
+
 # Guard against environment variables
 MAN1_TXT =
 MAN5_TXT =
@@ -524,7 +527,4 @@ doc-l10n install-l10n::
 	$(MAKE) -C po $@
 endif
 
-# Delete the target file on error
-.DELETE_ON_ERROR:
-
 .PHONY: FORCE
diff --git a/Makefile b/Makefile
index 8205614c6ec..5ae7d012cfb 100644
--- a/Makefile
+++ b/Makefile
@@ -1,3 +1,6 @@
+# Import tree-wide shared Makefile behavior and libraries
+include shared.mak
+
 # The default target of this Makefile is...
 all::
 
@@ -2158,16 +2161,6 @@ shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
 strip: $(PROGRAMS) git$X
 	$(STRIP) $(STRIP_OPTS) $^
 
-### Flags affecting all rules
-
-# A GNU make extension since gmake 3.72 (released in late 1994) to
-# remove the target of rules if commands in those rules fail. The
-# default is to only do that if make itself receives a signal. Affects
-# all targets, see:
-#
-#    info make --index-search=.DELETE_ON_ERROR
-.DELETE_ON_ERROR:
-
 ### Target-specific flags and dependencies
 
 # The generic compilation pattern rule and automatically
diff --git a/shared.mak b/shared.mak
new file mode 100644
index 00000000000..0170bb397ae
--- /dev/null
+++ b/shared.mak
@@ -0,0 +1,9 @@
+### Flags affecting all rules
+
+# A GNU make extension since gmake 3.72 (released in late 1994) to
+# remove the target of rules if commands in those rules fail. The
+# default is to only do that if make itself receives a signal. Affects
+# all targets, see:
+#
+#    info make --index-search=.DELETE_ON_ERROR
+.DELETE_ON_ERROR:
-- 
2.34.0.796.g2c87ed6146a
Previous: Ævar Arnfjörð BjarmasonNext: Ævar Arnfjörð Bjarmason
Message 91 of 107 in “Makefiles: dependency correctness & speedup”
  1. 00/16 Makefiles: dependency correctness & speedupÆvar Arnfjörð Bjarmason, Nov 6, 2021
  2. 02/16 Makefile: clean perl/build/ even with NO_PERL=YÆvar Arnfjörð Bjarmason, Nov 6, 2021
  3. Junio C HamanoNov 9, 2021
  4. 01/16 Makefile: don't set up "perl/build" rules under NO_PERL=YÆvar Arnfjörð Bjarmason, Nov 6, 2021
  5. 03/16 Makefile: remove "mv $@ $@+" dance redundant to .DELETE_ON_ERRORÆvar Arnfjörð Bjarmason, Nov 6, 2021
  6. 04/16 Makefile: move Perl-only variable assignments under !NO_PERLÆvar Arnfjörð Bjarmason, Nov 6, 2021
  7. Junio C HamanoNov 9, 2021
  8. 05/16 Makefile: correct "GIT-PERL-{DEFINES,HEADER}" dependency graphÆvar Arnfjörð Bjarmason, Nov 6, 2021
  9. Eric SunshineNov 7, 2021
  10. 06/16 Makefile: don't have Perl over-depend on GIT-BUILD-OPTIONSÆvar Arnfjörð Bjarmason, Nov 6, 2021
  11. 07/16 Makefile: create a GIT-PYTHON-DEFINES, like "PERL"Ævar Arnfjörð Bjarmason, Nov 6, 2021
  12. Eric SunshineNov 7, 2021
  13. 08/16 Makefile: stop needing @@GIT_VERSION@@ in *.perl scriptsÆvar Arnfjörð Bjarmason, Nov 6, 2021
  14. 09/16 Makefiles: add "shared.mak", move ".DELETE_ON_ERROR" to itÆvar Arnfjörð Bjarmason, Nov 6, 2021
  15. 10/16 Makefile: move $(comma), $(empty) and $(space) to shared.makÆvar Arnfjörð Bjarmason, Nov 6, 2021
  16. 11/16 Makefile: re-add and use the "shellquote" macrosÆvar Arnfjörð Bjarmason, Nov 6, 2021
  17. 12/16 Makefile: add a "TRACK_template" for GIT-*{FLAGS,DEFINES,...}Ævar Arnfjörð Bjarmason, Nov 6, 2021
  18. 13/16 Makefile: add "$(QUIET)" boilerplate to shared.makÆvar Arnfjörð Bjarmason, Nov 6, 2021
  19. 14/16 Makefile: use $(wspfx) for $(QUIET...) in shared.makÆvar Arnfjörð Bjarmason, Nov 6, 2021
  20. 15/16 Makefiles: add and use wildcard "mkdir -p" templateÆvar Arnfjörð Bjarmason, Nov 6, 2021
  21. 16/16 Makefile: don't invoke msgfmt with --statisticsÆvar Arnfjörð Bjarmason, Nov 6, 2021
  22. 00/18 Makefiles: dependency correctness & speedupÆvar Arnfjörð Bjarmason, Nov 12, 2021
  23. 01/18 Makefile: don't invoke msgfmt with --statisticsÆvar Arnfjörð Bjarmason, Nov 12, 2021
  24. 02/18 Makefile: don't set up "perl/build" rules under NO_PERL=YÆvar Arnfjörð Bjarmason, Nov 12, 2021
  25. 03/18 Makefile: use "=" not ":=" for po/* and perl/*Ævar Arnfjörð Bjarmason, Nov 12, 2021
  26. 04/18 Makefile: clean perl/build/ even with NO_PERL=YÆvar Arnfjörð Bjarmason, Nov 12, 2021
  27. 05/18 Makefile: remove "mv $@ $@+" dance redundant to .DELETE_ON_ERRORÆvar Arnfjörð Bjarmason, Nov 12, 2021
  28. 07/18 Makefile: change "ifndef NO_PERL" to "ifdef NO_PERL"Ævar Arnfjörð Bjarmason, Nov 12, 2021
  29. 09/18 Makefile: correct "GIT-PERL-{DEFINES,HEADER}" dependency graphÆvar Arnfjörð Bjarmason, Nov 12, 2021
  30. 06/18 Makefile: guard Perl-only variable assignmentsÆvar Arnfjörð Bjarmason, Nov 12, 2021
  31. 08/18 Makefile: adjust Perl-related comments & whitespaceÆvar Arnfjörð Bjarmason, Nov 12, 2021
  32. 10/18 Makefile: create a GIT-PYTHON-DEFINES, like "PERL"Ævar Arnfjörð Bjarmason, Nov 12, 2021
  33. 12/18 Makefiles: add "shared.mak", move ".DELETE_ON_ERROR" to itÆvar Arnfjörð Bjarmason, Nov 12, 2021
  34. 13/18 Makefile: move $(comma), $(empty) and $(space) to shared.makÆvar Arnfjörð Bjarmason, Nov 12, 2021
  35. 14/18 Makefile: re-add and use the "shellquote" macrosÆvar Arnfjörð Bjarmason, Nov 12, 2021
  36. 11/18 Makefile: stop needing @@GIT_VERSION@@ in *.perl scriptsÆvar Arnfjörð Bjarmason, Nov 12, 2021
  37. 16/18 Makefile: add "$(QUIET)" boilerplate to shared.makÆvar Arnfjörð Bjarmason, Nov 12, 2021
  38. 15/18 Makefile: add a "TRACK_template" for GIT-*{FLAGS,DEFINES,...}Ævar Arnfjörð Bjarmason, Nov 12, 2021
  39. 17/18 Makefile: use $(wspfx) for $(QUIET...) in shared.makÆvar Arnfjörð Bjarmason, Nov 12, 2021
  40. 18/18 Makefiles: add and use wildcard "mkdir -p" templateÆvar Arnfjörð Bjarmason, Nov 12, 2021
  41. 00/23 Makefile: dependency fixes, make noop runtime ~1.4x fasterÆvar Arnfjörð Bjarmason, Nov 16, 2021
  42. 02/23 Makefile: don't set up "perl/build" rules under NO_PERL=YÆvar Arnfjörð Bjarmason, Nov 16, 2021
  43. 01/23 Makefile: don't invoke msgfmt with --statisticsÆvar Arnfjörð Bjarmason, Nov 16, 2021
  44. 03/23 Makefile: use "=" not ":=" for po/* and perl/*Ævar Arnfjörð Bjarmason, Nov 16, 2021
  45. Mike HommeyNov 17, 2021
  46. 04/23 Makefile: clean perl/build/ even with NO_PERL=YÆvar Arnfjörð Bjarmason, Nov 16, 2021
  47. 06/23 Makefile: guard Perl-only variable assignmentsÆvar Arnfjörð Bjarmason, Nov 16, 2021
  48. 05/23 Makefile: remove "mv $@ $@+" dance redundant to .DELETE_ON_ERRORÆvar Arnfjörð Bjarmason, Nov 16, 2021
  49. Mike HommeyNov 17, 2021
  50. Ævar Arnfjörð BjarmasonNov 17, 2021
  51. 10/23 Makefile: create a GIT-PYTHON-DEFINES, like "PERL"Ævar Arnfjörð Bjarmason, Nov 16, 2021
  52. 12/23 Makefiles: add "shared.mak", move ".DELETE_ON_ERROR" to itÆvar Arnfjörð Bjarmason, Nov 16, 2021
  53. 11/23 Makefile: stop needing @@GIT_VERSION@@ in *.perl scriptsÆvar Arnfjörð Bjarmason, Nov 16, 2021
  54. 09/23 Makefile: correct "GIT-PERL-{DEFINES,HEADER}" dependency graphÆvar Arnfjörð Bjarmason, Nov 16, 2021
  55. 08/23 Makefile: adjust Perl-related comments & whitespaceÆvar Arnfjörð Bjarmason, Nov 16, 2021
  56. 07/23 Makefile: change "ifndef NO_PERL" to "ifdef NO_PERL"Ævar Arnfjörð Bjarmason, Nov 16, 2021
  57. 13/23 Makefile: move $(comma), $(empty) and $(space) to shared.makÆvar Arnfjörð Bjarmason, Nov 16, 2021
  58. 14/23 Makefile: re-add and use the "shellquote" macrosÆvar Arnfjörð Bjarmason, Nov 16, 2021
  59. 16/23 Makefile: add "$(QUIET)" boilerplate to shared.makÆvar Arnfjörð Bjarmason, Nov 16, 2021
  60. 15/23 Makefile: add a "TRACK_template" for GIT-*{FLAGS,DEFINES,...}Ævar Arnfjörð Bjarmason, Nov 16, 2021
  61. Mike HommeyNov 17, 2021
  62. Ævar Arnfjörð BjarmasonNov 17, 2021
  63. 17/23 Makefile: use $(wspfx) for $(QUIET...) in shared.makÆvar Arnfjörð Bjarmason, Nov 16, 2021
  64. 18/23 Makefiles: add and use wildcard "mkdir -p" templateÆvar Arnfjörð Bjarmason, Nov 16, 2021
  65. Mike HommeyNov 17, 2021
  66. Ævar Arnfjörð BjarmasonNov 17, 2021
  67. Mike HommeyNov 17, 2021
  68. Ævar Arnfjörð BjarmasonNov 17, 2021
  69. Mike HommeyNov 18, 2021
  70. Ævar Arnfjörð BjarmasonNov 18, 2021
  71. 21/23 Makefile: disable GNU make built-in wildcard rulesÆvar Arnfjörð Bjarmason, Nov 16, 2021
  72. Mike HommeyNov 17, 2021
  73. Ævar Arnfjörð BjarmasonNov 17, 2021
  74. 22/23 Makefile: define $(LIB_H) in terms of $(FIND_SOURCE_FILES)Ævar Arnfjörð Bjarmason, Nov 16, 2021
  75. 23/23 Makefile: move ".SUFFIXES" rule to shared.makÆvar Arnfjörð Bjarmason, Nov 16, 2021
  76. 20/23 Makefile: use $(file) I/O instead of "FORCE" when possibleÆvar Arnfjörð Bjarmason, Nov 16, 2021
  77. 19/23 Makefile: correct the dependency graph of hook-list.hÆvar Arnfjörð Bjarmason, Nov 16, 2021
  78. Mike HommeyNov 17, 2021
  79. 00/23 Makefile: dependency fixes, make noop runtime ~1.4x fasterÆvar Arnfjörð Bjarmason, Nov 17, 2021
  80. 01/23 Makefile: don't invoke msgfmt with --statisticsÆvar Arnfjörð Bjarmason, Nov 17, 2021
  81. 02/23 Makefile: don't set up "perl/build" rules under NO_PERL=YÆvar Arnfjörð Bjarmason, Nov 17, 2021
  82. 03/23 Makefile: use "=" not ":=" for po/* and perl/*Ævar Arnfjörð Bjarmason, Nov 17, 2021
  83. 04/23 Makefile: clean perl/build/ even with NO_PERL=YÆvar Arnfjörð Bjarmason, Nov 17, 2021
  84. 05/23 Makefile: remove "mv $@ $@+" dance redundant to .DELETE_ON_ERRORÆvar Arnfjörð Bjarmason, Nov 17, 2021
  85. 07/23 Makefile: change "ifndef NO_PERL" to "ifdef NO_PERL"Ævar Arnfjörð Bjarmason, Nov 17, 2021
  86. 06/23 Makefile: guard Perl-only variable assignmentsÆvar Arnfjörð Bjarmason, Nov 17, 2021
  87. 08/23 Makefile: adjust Perl-related comments & whitespaceÆvar Arnfjörð Bjarmason, Nov 17, 2021
  88. 09/23 Makefile: correct "GIT-PERL-{DEFINES,HEADER}" dependency graphÆvar Arnfjörð Bjarmason, Nov 17, 2021
  89. 10/23 Makefile: create a GIT-PYTHON-DEFINES, like "PERL"Ævar Arnfjörð Bjarmason, Nov 17, 2021
  90. 11/23 Makefile: stop needing @@GIT_VERSION@@ in *.perl scriptsÆvar Arnfjörð Bjarmason, Nov 17, 2021
  91. 12/23 Makefiles: add "shared.mak", move ".DELETE_ON_ERROR" to itÆvar Arnfjörð Bjarmason, Nov 17, 2021
  92. 13/23 Makefile: move $(comma), $(empty) and $(space) to shared.makÆvar Arnfjörð Bjarmason, Nov 17, 2021
  93. 14/23 Makefile: re-add and use the "shellquote" macrosÆvar Arnfjörð Bjarmason, Nov 17, 2021
  94. Junio C HamanoDec 13, 2021
  95. Junio C HamanoDec 14, 2021
  96. 15/23 Makefile: add a "TRACK_template" for GIT-*{FLAGS,DEFINES,...}Ævar Arnfjörð Bjarmason, Nov 17, 2021
  97. Junio C HamanoNov 19, 2021
  98. Junio C HamanoNov 19, 2021
  99. Ævar Arnfjörð BjarmasonNov 19, 2021
  100. 16/23 Makefile: add "$(QUIET)" boilerplate to shared.makÆvar Arnfjörð Bjarmason, Nov 17, 2021
  101. 17/23 Makefile: use $(wspfx) for $(QUIET...) in shared.makÆvar Arnfjörð Bjarmason, Nov 17, 2021
  102. 18/23 Makefiles: add and use wildcard "mkdir -p" templateÆvar Arnfjörð Bjarmason, Nov 17, 2021
  103. 19/23 Makefile: correct the dependency graph of hook-list.hÆvar Arnfjörð Bjarmason, Nov 17, 2021
  104. 20/23 Makefile: use $(file) I/O instead of "FORCE" when possibleÆvar Arnfjörð Bjarmason, Nov 17, 2021
  105. 21/23 Makefile: disable GNU make built-in wildcard rulesÆvar Arnfjörð Bjarmason, Nov 17, 2021
  106. 22/23 Makefile: define $(LIB_H) in terms of $(FIND_SOURCE_FILES)Ævar Arnfjörð Bjarmason, Nov 17, 2021
  107. 23/23 Makefile: move ".SUFFIXES" rule to shared.makÆvar Arnfjörð Bjarmason, Nov 17, 2021

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.