cfg.mk

   1 # Customize maint.mk                           -*- makefile -*-
   2 # Copyright (C) 2003-2010 Free Software Foundation, Inc.
   3
   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.
   8
   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.
  13
  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/>.
  16
  17 # Used in maint.mk's web-manual rule
  18 manual_title = Core GNU utilities
  19
  20 # Tests not to run as part of "make distcheck".
  21 local-checks-to-skip =
  22
  23 # Tools used to bootstrap this package, used for "announcement".
  24 bootstrap-tools = autoconf,automake,gnulib,bison
  25
  26 # Now that we have better tests, make this the default.
  27 export VERBOSE = yes
  28
  29 old_NEWS_hash = beab130e9d41bf8014a0594cfe8b28d4
  30
  31 # Add an exemption for sc_makefile_at_at_check.
  32 _makefile_at_at_check_exceptions = ' && !/^cu_install_program =/'
  33
  34 # Ensure that the list of O_ symbols used to compute O_FULLBLOCK is complete.
  35 dd = $(srcdir)/src/dd.c
  36 sc_dd_O_FLAGS:
  37         @rm -f $@.1 $@.2
  38         @{ echo O_FULLBLOCK; perl -nle '/^ +\| (O_\w*)$$/ and print $$1' \
  39           $(dd); } | sort > $@.1
  40         @{ echo O_NOFOLLOW; perl -nle '/{"[a-z]+",\s*(O_\w+)},/ and print $$1' \
  41           $(dd); } | sort > $@.2
  42         @diff -u $@.1 $@.2 || diff=1 || diff=;                          \
  43         rm -f $@.1 $@.2;                                                \
  44         test "$$diff"                                                   \
  45           && { echo '$(ME): $(dd) has inconsistent O_ flag lists'>&2;   \
  46                exit 1; } || :
  47
  48 # Ensure that dd's definition of LONGEST_SYMBOL stays in sync
  49 # with the strings from the two affected variables.
  50 dd_c = $(srcdir)/src/dd.c
  51 sc_dd_max_sym_length:
  52 ifneq ($(wildcard $(dd_c)),)
  53         @len=$$( (sed -n '/conversions\[\] =$$/,/^};/p' $(dd_c);\
  54                  sed -n '/flags\[\] =$$/,/^};/p' $(dd_c) )      \
  55                 |sed -n '/"/s/^[^"]*"\([^"]*\)".*/\1/p'         \
  56               | wc --max-line-length);                          \
  57         max=$$(sed -n '/^#define LONGEST_SYMBOL /s///p' $(dd_c) \
  58               |tr -d '"' | wc --max-line-length);               \
  59         if test "$$len" = "$$max"; then :; else                 \
  60           echo 'dd.c: LONGEST_SYMBOL is not longest' 1>&2;      \
  61           exit 1;                                               \
  62         fi
  63 endif
  64
  65 # Many m4 macros names once began with `jm_'.
  66 # On 2004-04-13, they were all changed to start with gl_ instead.
  67 # Make sure that none are inadvertently reintroduced.
  68 sc_prohibit_jm_in_m4:
  69         @grep -nE 'jm_[A-Z]'                                            \
  70                 $$($(VC_LIST) m4 |grep '\.m4$$'; echo /dev/null) &&     \
  71             { echo '$(ME): do not use jm_ in m4 macro names'            \
  72               1>&2; exit 1; } || :
  73
  74 # Ensure that each root-requiring test is run via the "check-root" rule.
  75 sc_root_tests:
  76         @if test -d tests \
  77               && grep check-root tests/Makefile.am>/dev/null 2>&1; then \
  78         t1=sc-root.expected; t2=sc-root.actual;                         \
  79         grep -nl '^require_root_$$'                                     \
  80           $$($(VC_LIST) tests) |sed s,tests/,, |sort > $$t1;            \
  81         sed -n '/^root_tests =[  ]*\\$$/,/[^\]$$/p'                     \
  82           $(srcdir)/tests/Makefile.am                                   \
  83             | sed 's/^  *//;/^root_tests =/d'                           \
  84             | tr -s '\012\\' '  ' | fmt -1 | sort > $$t2;               \
  85         diff -u $$t1 $$t2 || diff=1 || diff=;                           \
  86         rm -f $$t1 $$t2;                                                \
  87         test "$$diff"                                                   \
  88           && { echo 'tests/Makefile.am: missing check-root action'>&2;  \
  89                exit 1; } || :;                                          \
  90         fi
  91
  92 # Ensure that the syntax_check_exceptions file list in Makefile.am
  93 # stays in sync with corresponding files in the repository.
  94 sce = syntax_check_exceptions
  95 sc_x_sc_dist_check:
  96         @test "$$( ($(VC_LIST) | sed -n '/^.x-sc_/p';                   \
  97                    sed -n '/^$(sce) =[   ]*\\$$/,/[^\]$$/p'             \
  98                      $(srcdir)/Makefile.am                              \
  99                        | sed 's/^  *//;/^$(sce) =/d'                    \
 100                        | tr -s '\012\\' '  ' | fmt -1                   \
 101                    ) | sort | uniq -u)"                                 \
 102           && { echo 'Makefile.am: $(sce) mismatch' >&2; exit 1; } || :;
 103
 104 headers_with_interesting_macro_defs = \
 105   exit.h        \
 106   fcntl_.h      \
 107   fnmatch_.h    \
 108   intprops.h    \
 109   inttypes_.h   \
 110   lchown.h      \
 111   openat.h      \
 112   stat-macros.h \
 113   stdint_.h
 114
 115 # Create a list of regular expressions matching the names
 116 # of macros that are guaranteed by parts of gnulib to be defined.
 117 .re-defmac:
 118         @(cd $(srcdir)/lib;                                             \
 119           for f in $(headers_with_interesting_macro_defs); do           \
 120             test -f $$f &&                                              \
 121               sed -n '/^# *define \([^_ (][^ (]*\)[ (].*/s//\1/p' $$f;  \
 122            done;                                                        \
 123          ) | sort -u                                                    \
 124            | grep -Ev 'ATTRIBUTE_NORETURN|SIZE_MAX'                     \
 125            | sed 's/^/^# *define /'                                     \
 126           > $@-t
 127         @mv $@-t $@
 128
 129 # Don't define macros that we already get from gnulib header files.
 130 sc_always_defined_macros: .re-defmac
 131         @if test -f $(srcdir)/src/system.h; then                        \
 132           trap 'rc=$$?; rm -f .re-defmac; exit $$rc' 0 1 2 3 15;        \
 133           grep -f .re-defmac $$($(VC_LIST))                             \
 134             && { echo '$(ME): define the above via some gnulib .h file' \
 135                   1>&2;  exit 1; } || :;                                \
 136         fi
 137
 138 # Create a list of regular expressions matching the names
 139 # of files included from system.h.  Exclude a couple.
 140 .re-list:
 141         @sed -n '/^# *include /s///p' $(srcdir)/src/system.h \
 142           | grep -Ev 'sys/(param|file)\.h' \
 143           | sed 's/ .*//;;s/^["<]/^# *include [<"]/;s/\.h[">]$$/\\.h[">]/' \
 144           > $@-t
 145         @mv $@-t $@
 146
 147 # Files in src/ should not include directly any of
 148 # the headers already included via system.h.
 149 sc_system_h_headers: .re-list
 150         @if test -f $(srcdir)/src/system.h; then                        \
 151           trap 'rc=$$?; rm -f .re-list; exit $$rc' 0 1 2 3 15;          \
 152           grep -nE -f .re-list                                          \
 153               $$($(VC_LIST_EXCEPT) | grep '^src/')                      \
 154             && { echo '$(ME): the above are already included via system.h'\
 155                   1>&2;  exit 1; } || :;                                \
 156         fi
 157
 158 sc_sun_os_names:
 159         @grep -nEi \
 160             'solaris[^[:alnum:]]*2\.(7|8|9|[1-9][0-9])|sunos[^[:alnum:]][6-9]' \
 161             $$($(VC_LIST_EXCEPT)) &&                                    \
 162           { echo '$(ME): found misuse of Sun OS version numbers' 1>&2;  \
 163             exit 1; } || :
 164
 165 ALL_RECURSIVE_TARGETS += sc_tight_scope
 166 sc_tight_scope:
 167         @$(MAKE) -C src $@
 168
 169 ALL_RECURSIVE_TARGETS += sc_check-AUTHORS
 170 sc_check-AUTHORS:
 171         @$(MAKE) -C src $@
 172
 173 # Perl-based tests used to exec perl from a #!/bin/sh script.
 174 # Now they all start with #!/usr/bin/perl and the portability
 175 # infrastructure is in tests/Makefile.am.  Make sure no old-style
 176 # script sneaks back in.
 177 sc_no_exec_perl_coreutils:
 178         @if test -f $(srcdir)/tests/Coreutils.pm; then                  \
 179           grep '^exec  *\$$PERL.*MCoreutils' $$($(VC_LIST) tests) &&    \
 180             { echo 1>&2 '$(ME): found anachronistic Perl-based tests';  \
 181               exit 1; } || :;                                           \
 182         fi
 183
 184 # Don't use "readlink" or "readlinkat" directly
 185 sc_prohibit_readlink:
 186         @re='\<readlink(at)? \('                                        \
 187         msg='do not use readlink(at); use via xreadlink or areadlink*'  \
 188           $(_prohibit_regexp)
 189
 190 # Don't use address of "stat" or "lstat" functions
 191 sc_prohibit_stat_macro_address:
 192         @re='\<l?stat '':|&l?stat\>'                                    \
 193         msg='stat() and lstat() may be function-like macros'            \
 194           $(_prohibit_regexp)
 195
 196 # Ensure that date's --help output stays in sync with the info
 197 # documentation for GNU strftime.  The only exception is %N,
 198 # which date accepts but GNU strftime does not.
 199 extract_char = sed 's/^[^%][^%]*%\(.\).*/\1/'
 200 sc_strftime_check:
 201         @if test -f $(srcdir)/src/date.c; then                          \
 202           grep '^  %.  ' $(srcdir)/src/date.c | sort                    \
 203             | $(extract_char) > $@-src;                                 \
 204           { echo N;                                                     \
 205             info libc date calendar format | grep '^    `%.'\'          \
 206               | $(extract_char); } | sort > $@-info;                    \
 207           diff -u $@-src $@-info || exit 1;                             \
 208           rm -f $@-src $@-info;                                         \
 209         fi
 210
 211 # Indent only with spaces.
 212 sc_prohibit_tab_based_indentation:
 213         @re='^ *        '                                               \
 214         msg='TAB in indentation; use only spaces'                       \
 215           $(_prohibit_regexp)
 216
 217 # Don't use "indent-tabs-mode: nil" anymore.  No longer needed.
 218 sc_prohibit_emacs__indent_tabs_mode__setting:
 219         @re='^( *[*#] *)?indent-tabs-mode:'                             \
 220         msg='use of emacs indent-tabs-mode: setting'                    \
 221           $(_prohibit_regexp)
 222
 223 # Ensure that each file that contains fail=1 also contains fail=0.
 224 # Otherwise, setting file=1 in the environment would make tests fail unexpectedly.
 225 sc_prohibit_fail_0:
 226         @re='\<fail=0\>'                                                \
 227         msg='fail=0 initialization'                                     \
 228           $(_prohibit_regexp)
 229
 230 # Ensure that "stdio--.h" is used where appropriate.
 231 sc_require_stdio_safer:
 232         @if $(VC_LIST_EXCEPT) | grep -l '\.[ch]$$' > /dev/null; then    \
 233           files=$$(grep -l '\bfreopen \?(' $$($(VC_LIST_EXCEPT)         \
 234               | grep '\.[ch]$$'));                                      \
 235           test -n "$$files" && grep -LE 'include "stdio--.h"' $$files   \
 236               | grep . &&                                               \
 237           { echo '$(ME): the above files should use "stdio--.h"'        \
 238                 1>&2; exit 1; } || :;                                   \
 239         else :;                                                         \
 240         fi
 241
 242 # Prefer xnanosleep over other less-precise sleep methods
 243 sc_prohibit_sleep:
 244         @re='\<(nano|u)?sleep \('                                       \
 245         msg='prefer xnanosleep over other sleep interfaces'             \
 246           $(_prohibit_regexp)
 247
 248 include $(srcdir)/dist-check.mk
 249
 250 update-copyright-env = \
 251   UPDATE_COPYRIGHT_USE_INTERVALS=1 \
 252   UPDATE_COPYRIGHT_MAX_LINE_LENGTH=79