maint: HACKING: mention a few more useful git commands
[coreutils.git] / cfg.mk
blob393d4cbb3fa011031d95d63dcb6423f2c8f03283
1 # Customize maint.mk -*- makefile -*-
2 # Copyright (C) 2003-2009 Free Software Foundation, Inc.
4 # This program is free software: you can redistribute it and/or modify
5 # it under the terms of the GNU General Public License as published by
6 # the Free Software Foundation, either version 3 of the License, or
7 # (at your option) any later version.
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 # GNU General Public License for more details.
14 # You should have received a copy of the GNU General Public License
15 # along with this program. If not, see <http://www.gnu.org/licenses/>.
17 # Use alpha.gnu.org for alpha and beta releases.
18 # Use ftp.gnu.org for major releases.
19 gnu_ftp_host-alpha = alpha.gnu.org
20 gnu_ftp_host-beta = alpha.gnu.org
21 gnu_ftp_host-major = ftp.gnu.org
22 gnu_rel_host = $(gnu_ftp_host-$(RELEASE_TYPE))
24 # Used in maint.mk's web-manual rule
25 manual_title = Core GNU utilities
27 url_dir_list = \
28 ftp://$(gnu_rel_host)/gnu/coreutils
30 # The GnuPG ID of the key used to sign the tarballs.
31 gpg_key_ID = B9AB9A16
33 # Tests not to run as part of "make distcheck".
34 local-checks-to-skip = strftime-check
36 # Tools used to bootstrap this package, used for "announcement".
37 bootstrap-tools = autoconf,automake,gnulib,bison
39 # Now that we have better tests, make this the default.
40 export VERBOSE = yes
42 old_NEWS_hash = 8ed224902e335a80ec8340cd0d594d7f
44 # Ensure that the list of O_ symbols used to compute O_FULLBLOCK is complete.
45 dd = $(srcdir)/src/dd.c
46 sc_dd_O_FLAGS:
47 @rm -f $@.1 $@.2
48 @{ echo O_FULLBLOCK; perl -nle '/^ +\| (O_\w*)$$/ and print $$1' \
49 $(dd); } | sort > $@.1
50 @{ echo O_NOFOLLOW; perl -nle '/{"[a-z]+",\s*(O_\w+)},/ and print $$1' \
51 $(dd); } | sort > $@.2
52 @diff -u $@.1 $@.2 || diff=1 || diff=; \
53 rm -f $@.1 $@.2; \
54 test "$$diff" \
55 && { echo '$(ME): $(dd) has inconsistent O_ flag lists'>&2; \
56 exit 1; } || :
58 # Ensure that dd's definition of LONGEST_SYMBOL stays in sync
59 # with the strings from the two affected variables.
60 dd_c = $(srcdir)/src/dd.c
61 sc_dd_max_sym_length:
62 ifneq ($(wildcard $(dd_c)),)
63 @len=$$( (sed -n '/conversions\[\] =$$/,/^};/p' $(dd_c);\
64 sed -n '/flags\[\] =$$/,/^};/p' $(dd_c) ) \
65 |sed -n '/"/s/^[^"]*"\([^"]*\)".*/\1/p' \
66 | wc --max-line-length); \
67 max=$$(sed -n '/^#define LONGEST_SYMBOL /s///p' $(dd_c) \
68 |tr -d '"' | wc --max-line-length); \
69 if test "$$len" = "$$max"; then :; else \
70 echo 'dd.c: LONGEST_SYMBOL is not longest' 1>&2; \
71 exit 1; \
73 endif
75 # Many m4 macros names once began with `jm_'.
76 # On 2004-04-13, they were all changed to start with gl_ instead.
77 # Make sure that none are inadvertently reintroduced.
78 sc_prohibit_jm_in_m4:
79 @grep -nE 'jm_[A-Z]' \
80 $$($(VC_LIST) m4 |grep '\.m4$$'; echo /dev/null) && \
81 { echo '$(ME): do not use jm_ in m4 macro names' \
82 1>&2; exit 1; } || :
84 # Ensure that each root-requiring test is run via the "check-root" rule.
85 sc_root_tests:
86 @if test -d tests \
87 && grep check-root tests/Makefile.am>/dev/null 2>&1; then \
88 t1=sc-root.expected; t2=sc-root.actual; \
89 grep -nl '^require_root_$$' \
90 $$($(VC_LIST) tests) |sed s,tests/,, |sort > $$t1; \
91 sed -n '/^root_tests =[ ]*\\$$/,/[^\]$$/p' \
92 $(srcdir)/tests/Makefile.am \
93 | sed 's/^ *//;/^root_tests =/d' \
94 | tr -s '\012\\' ' ' | fmt -1 | sort > $$t2; \
95 diff -u $$t1 $$t2 || diff=1 || diff=; \
96 rm -f $$t1 $$t2; \
97 test "$$diff" \
98 && { echo 'tests/Makefile.am: missing check-root action'>&2; \
99 exit 1; } || :; \
102 headers_with_interesting_macro_defs = \
103 exit.h \
104 fcntl_.h \
105 fnmatch_.h \
106 intprops.h \
107 inttypes_.h \
108 lchown.h \
109 openat.h \
110 stat-macros.h \
111 stdint_.h
113 # Create a list of regular expressions matching the names
114 # of macros that are guaranteed by parts of gnulib to be defined.
115 .re-defmac:
116 @(cd $(srcdir)/lib; \
117 for f in $(headers_with_interesting_macro_defs); do \
118 test -f $$f && \
119 sed -n '/^# *define \([^_ (][^ (]*\)[ (].*/s//\1/p' $$f; \
120 done; \
121 ) | sort -u \
122 | grep -Ev 'ATTRIBUTE_NORETURN|SIZE_MAX' \
123 | sed 's/^/^# *define /' \
124 > $@-t
125 @mv $@-t $@
127 # Don't define macros that we already get from gnulib header files.
128 sc_always_defined_macros: .re-defmac
129 @if test -f $(srcdir)/src/system.h; then \
130 trap 'rc=$$?; rm -f .re-defmac; exit $$rc' 0 1 2 3 15; \
131 grep -f .re-defmac $$($(VC_LIST)) \
132 && { echo '$(ME): define the above via some gnulib .h file' \
133 1>&2; exit 1; } || :; \
136 # Create a list of regular expressions matching the names
137 # of files included from system.h. Exclude a couple.
138 .re-list:
139 @sed -n '/^# *include /s///p' $(srcdir)/src/system.h \
140 | grep -Ev 'sys/(param|file)\.h' \
141 | sed 's/ .*//;;s/^["<]/^# *include [<"]/;s/\.h[">]$$/\\.h[">]/' \
142 > $@-t
143 @mv $@-t $@
145 # Files in src/ should not include directly any of
146 # the headers already included via system.h.
147 sc_system_h_headers: .re-list
148 @if test -f $(srcdir)/src/system.h; then \
149 trap 'rc=$$?; rm -f .re-list; exit $$rc' 0 1 2 3 15; \
150 grep -nE -f .re-list \
151 $$($(VC_LIST) src | \
152 grep -Ev '((copy|system)\.h|parse-gram\.c)$$') \
153 && { echo '$(ME): the above are already included via system.h'\
154 1>&2; exit 1; } || :; \
157 sc_sun_os_names:
158 @grep -nEi \
159 'solaris[^[:alnum:]]*2\.(7|8|9|[1-9][0-9])|sunos[^[:alnum:]][6-9]' \
160 $$($(VC_LIST_EXCEPT)) && \
161 { echo '$(ME): found misuse of Sun OS version numbers' 1>&2; \
162 exit 1; } || :
164 ALL_RECURSIVE_TARGETS += sc_tight_scope
165 sc_tight_scope:
166 @$(MAKE) -C src $@
168 # Perl-based tests used to exec perl from a #!/bin/sh script.
169 # Now they all start with #!/usr/bin/perl and the portability
170 # infrastructure is in tests/Makefile.am. Make sure no old-style
171 # script sneaks back in.
172 sc_no_exec_perl_coreutils:
173 @if test -f $(srcdir)/tests/Coreutils.pm; then \
174 grep '^exec *\$$PERL.*MCoreutils' $$($(VC_LIST) tests) && \
175 { echo 1>&2 '$(ME): found anachronistic Perl-based tests'; \
176 exit 1; } || :; \
179 # Ensure that date's --help output stays in sync with the info
180 # documentation for GNU strftime. The only exception is %N,
181 # which date accepts but GNU strftime does not.
182 extract_char = sed 's/^[^%][^%]*%\(.\).*/\1/'
183 sc_strftime_check:
184 @if test -f $(srcdir)/src/date.c; then \
185 grep '^ %. ' $(srcdir)/src/date.c | sort \
186 | $(extract_char) > $@-src; \
187 { echo N; \
188 info libc date calendar format | grep '^ `%.'\' \
189 | $(extract_char); } | sort > $@-info; \
190 diff -u $@-src $@-info || exit 1; \
191 rm -f $@-src $@-info; \
194 include $(srcdir)/dist-check.mk