cfg.mk

   1 # Customize maint.mk                           -*- makefile -*-
   2 # Copyright (C) 2008-2015, 2018 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 # Update version, then recompile so that tests/bison --version be
  18 # up-to-date, then compile our parser again with our up-to-date bison.
  19 .PHONY: regen
  20 regen: _version
  21         $(MAKE) $(AM_MAKEFLAGS)
  22         touch $(srcdir)/src/parse-gram.y
  23         $(MAKE) $(AM_MAKEFLAGS)
  24
  25 # Used in maint.mk's web-manual rule
  26 manual_title = The Yacc-compatible Parser Generator
  27 gendocs_options_ = -I $(abs_top_srcdir)/doc -I $(abs_top_builddir)/doc
  28
  29 # It's useful to run maintainer-*check* targets during development, but we
  30 # don't want to wait on a recompile because of an update to $(VERSION).  Thus,
  31 # override the _is-dist-target from GNUmakefile so that maintainer-*check*
  32 # targets are filtered out.
  33 _is-dist-target = $(filter-out %clean maintainer-check% maintainer-%-check, \
  34   $(filter maintainer-% dist% alpha beta major,$(MAKECMDGOALS)))
  35
  36 url_dir_list = \
  37   https://$(gnu_rel_host)/gnu/bison
  38
  39 # Tests not to run as part of "make distcheck".
  40 local-checks-to-skip =                  \
  41   sc_immutable_NEWS                     \
  42   sc_prohibit_atoi_atof
  43
  44 # The local directory containing the checked-out copy of gnulib used in
  45 # this release.  Used solely to get a date for the "announcement" target.
  46 gnulib_dir = $(srcdir)/gnulib
  47
  48 bootstrap-tools = autoconf,automake,flex,gettext,gnulib
  49
  50 announcement_Cc_ = \
  51   bug-bison@gnu.org, help-bison@gnu.org, bison-patches@gnu.org, \
  52   coordinator@translationproject.org
  53
  54 update-copyright: update-b4-copyright update-package-copyright-year
  55 update-copyright-env = \
  56   UPDATE_COPYRIGHT_FORCE=1 UPDATE_COPYRIGHT_USE_INTERVALS=1
  57
  58
  59 ## -------------------- ##
  60 ## More syntax-checks.  ##
  61 ## -------------------- ##
  62
  63 # At least for Mac OS X's grep, the order between . and [ in "[^.[]"
  64 # matters:
  65 # $ LC_ALL=fr_FR grep -nE '[^[.]' /dev/null
  66 # $ LC_ALL=C grep -nE '[^[.]' /dev/null
  67 # grep: invalid collating element or class
  68 # $ LC_ALL=fr_FR grep -nE '[^.[]' /dev/null
  69 # $ LC_ALL=C grep -nE '[^.[]' /dev/null
  70 sc_at_parser_check:
  71         @prohibit='AT_PARSER_CHECK\(\[+[^.[]|AT_CHECK\(\[+\./'          \
  72         halt='use AT_PARSER_CHECK for and only for generated parsers'   \
  73           $(_sc_search_regexp)
  74
  75 # Indent only with spaces.
  76 # Taken from Coreutils.
  77 sc_prohibit_tab_based_indentation:
  78         @prohibit='^ *  '                                               \
  79         halt='TAB in indentation; use only spaces'                      \
  80           $(_sc_search_regexp)
  81
  82 # Prohibit the use of `...` in tests/.  Use $(...) instead.
  83 # Taken from Coreutils.
  84 # Not ready for Bison yet.
  85 #sc_prohibit_test_backticks:
  86 #       @prohibit='`' in_vc_files='^tests/'             \
  87 #       halt='use $$(...), not `...` in tests/'         \
  88 #         $(_sc_search_regexp)
  89
  90 # Enforce recommended preprocessor indentation style.
  91 # Taken from Coreutils.
  92 sc_preprocessor_indentation:
  93         @if cppi --version >/dev/null 2>&1; then                        \
  94           $(VC_LIST_EXCEPT) | grep '\.[ch]$$' | xargs cppi -a -c        \
  95             || { echo '$(ME): incorrect preprocessor indentation' 1>&2; \
  96                 exit 1; };                                              \
  97         else                                                            \
  98           echo '$(ME): skipping test $@: cppi not installed' 1>&2;      \
  99         fi
 100
 101 ###########################################################
 102 # Taken from Coreutils.
 103 _p0 = \([^"'/]\|"\([^\"]\|[\].\)*"\|'\([^\']\|[\].\)*'
 104 _pre = $(_p0)\|[/][^"'/*]\|[/]"\([^\"]\|[\].\)*"\|[/]'\([^\']\|[\].\)*'\)*
 105 _pre_anchored = ^\($(_pre)\)
 106 _comment_and_close = [^*]\|[*][^/*]\)*[*][*]*/
 107 # help font-lock mode: '
 108
 109 # A sed expression that removes ANSI C and ISO C99 comments.
 110 # Derived from the one in GNU gettext's 'moopp' preprocessor.
 111 _sed_remove_comments =                                  \
 112 /[/][/*]/{                                              \
 113   ta;                                                   \
 114   :a;                                                   \
 115   s,$(_pre_anchored)//.*,\1,;                           \
 116   te;                                                   \
 117   s,$(_pre_anchored)/[*]\($(_comment_and_close),\1 ,;   \
 118   ta;                                                   \
 119   /^$(_pre)[/][*]/{                                     \
 120     s,$(_pre_anchored)/[*].*,\1 ,;                      \
 121     tu;                                                 \
 122     :u;                                                 \
 123     n;                                                  \
 124     s,^\($(_comment_and_close),,;                       \
 125     tv;                                                 \
 126     s,^.*$$,,;                                          \
 127     bu;                                                 \
 128     :v;                                                 \
 129   };                                                    \
 130   :e;                                                   \
 131 }
 132 # Quote all single quotes.
 133 _sed_rm_comments_q = $(subst ','\'',$(_sed_remove_comments))
 134 # help font-lock mode: '
 135
 136 _space_before_paren_exempt =? \\n\\$$
 137 _space_before_paren_exempt = \
 138   (^ *\#|(LA)?LR\([01]\)|percent_(code|define)|b4_syncline|m4_(define|init)|symbol)
 139 # Ensure that there is a space before each open parenthesis in C code.
 140 sc_space_before_open_paren:
 141         @if $(VC_LIST_EXCEPT) | grep -l '\.[ch]$$' > /dev/null; then    \
 142           fail=0;                                                       \
 143           for c in $$($(VC_LIST_EXCEPT) | grep '\.[ch]$$'); do          \
 144             sed '$(_sed_rm_comments_q)' $$c 2>/dev/null                 \
 145               | grep -i '[[:alnum:]]('                                  \
 146               | grep -vE '$(_space_before_paren_exempt)'                \
 147               | grep . && { fail=1; echo "*** $$c"; };                  \
 148           done;                                                         \
 149           test $$fail = 1 &&                                            \
 150             { echo '$(ME): the above files lack a space-before-open-paren' \
 151                 1>&2; exit 1; } || :;                                   \
 152         else :;                                                         \
 153         fi
 154
 155 ## -------------------------- ##
 156 ## syntax-checks exceptions.  ##
 157 ## -------------------------- ##
 158
 159 exclude = \
 160   $(foreach a,$(1),$(eval $(subst $$,$$$$,exclude_file_name_regexp--sc_$(a))))
 161 $(call exclude,                                                         \
 162   bindtextdomain=^lib/main.c$$                                          \
 163   preprocessor_indentation=^data/|^lib/|^src/parse-gram.[ch]$$          \
 164   program_name=^lib/main.c$$                                            \
 165   prohibit_always-defined_macros=^data/yacc.c$$|^djgpp/                 \
 166   prohibit_always-defined_macros+=?|^lib/timevar.c$$                    \
 167   prohibit_always-defined_macros+=?|^src/(parse-gram.c|system.h)$$      \
 168   prohibit_always-defined_macros+=?|^tests/regression.at$$              \
 169   prohibit_always_true_header_tests=^djgpp/subpipe.h$$|^lib/timevar.c$$ \
 170   prohibit_always_true_header_tests+=?|^m4/timevar.m4$$                 \
 171   prohibit_defined_have_decl_tests=?|^lib/timevar.c$$                   \
 172   prohibit_doubled_word=^tests/named-refs.at$$                          \
 173   prohibit_magic_number_exit=^doc/bison.texi$$                          \
 174   prohibit_magic_number_exit+=?|^tests/(conflicts|regression).at$$      \
 175   prohibit_strcmp=^doc/bison\.texi|tests/local\.at$$                    \
 176   prohibit_tab_based_indentation=\.(am|mk)$$|^djgpp/|^\.git             \
 177   require_config_h_first=^(lib/yyerror|data/(glr|yacc))\.c$$            \
 178   space_before_open_paren=^(data/|djgpp/)                               \
 179   two_space_separator_in_usage=^(bootstrap)                             \
 180   unmarked_diagnostics=^(djgpp/|doc/bison.texi$$|tests/c\+\+\.at$$)     \
 181 )