doc/local.mk

   1 # Make coreutils documentation.                         -*-Makefile-*-
   2 # This is included by the top-level Makefile.am.
   3
   4 # Copyright (C) 1995-2015 Free Software Foundation, Inc.
   5
   6 # This program is free software: you can redistribute it and/or modify
   7 # it under the terms of the GNU General Public License as published by
   8 # the Free Software Foundation, either version 3 of the License, or
   9 # (at your option) any later version.
  10
  11 # This program is distributed in the hope that it will be useful,
  12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 # GNU General Public License for more details.
  15
  16 # You should have received a copy of the GNU General Public License
  17 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18
  19 info_TEXINFOS = doc/coreutils.texi
  20
  21 doc_coreutils_TEXINFOS = \
  22   doc/perm.texi \
  23   doc/parse-datetime.texi \
  24   doc/constants.texi \
  25   doc/fdl.texi
  26
  27 # The following is necessary if the package name is 8 characters or longer.
  28 # If the info documentation would be split into 10 or more separate files,
  29 # then this is necessary even if the package name is 7 characters long.
  30 #
  31 # Tell makeinfo to put everything in a single info file: <package>.info.
  32 # Otherwise, it would also generate files with names like <package>.info-[123],
  33 # and those names all map to one 14-byte name (<package>.info-) on some crufty
  34 # old systems.
  35 AM_MAKEINFOFLAGS = --no-split
  36
  37 doc/constants.texi: $(top_srcdir)/src/tail.c $(top_srcdir)/src/shred.c
  38         $(AM_V_GEN)LC_ALL=C; export LC_ALL; \
  39         $(MKDIR_P) doc && \
  40         { sed -n -e 's/^#define \(DEFAULT_MAX[_A-Z]*\) \(.*\)/@set \1 \2/p' \
  41             $(top_srcdir)/src/tail.c && \
  42           sed -n -e \
  43               's/.*\(DEFAULT_PASSES\)[ =]* \([0-9]*\).*/@set SHRED_\1 \2/p'\
  44             $(top_srcdir)/src/shred.c; } > $@-t \
  45           && mv $@-t $@
  46
  47 MAINTAINERCLEANFILES += doc/constants.texi
  48
  49 # Extended regular expressions to match word starts and ends.
  50 _W = (^|[^A-Za-z0-9_])
  51 W_ = ([^A-Za-z0-9_]|$$)
  52
  53 syntax_checks =         \
  54   sc-avoid-builtin      \
  55   sc-avoid-io           \
  56   sc-avoid-non-zero     \
  57   sc-avoid-path         \
  58   sc-avoid-timezone     \
  59   sc-avoid-zeroes       \
  60   sc-exponent-grouping  \
  61   sc-lower-case-var
  62
  63 texi_files = $(srcdir)/doc/*.texi
  64
  65 .PHONY: $(syntax_checks) check-texinfo
  66
  67 # List words/regexps here that should not appear in the texinfo documentation.
  68 check-texinfo: $(syntax_checks)
  69         $(AM_V_GEN)fail=0;                                              \
  70         grep '@url{' $(texi_files) && fail=1;                           \
  71         grep '\$$@"' $(texi_files) && fail=1;                           \
  72         grep -n '[^[:punct:]]@footnote' $(texi_files) && fail=1;        \
  73         grep -n filename $(texi_files)                                  \
  74             | $(EGREP) -v 'setfilename|[{]filename[}]'                  \
  75           && fail=1;                                                    \
  76         exit $$fail
  77
  78 sc-avoid-builtin:
  79         $(AM_V_GEN)$(EGREP) -i '$(_W)builtins?$(W_)' $(texi_files)      \
  80           && exit 1 || :
  81
  82 sc-avoid-path:
  83         $(AM_V_GEN)fail=0;                                              \
  84         $(EGREP) -i '$(_W)path(name)?s?$(W_)' $(texi_files)             \
  85           | $(EGREP) -v                                                 \
  86           'PATH=|path search|search path|@vindex PATH$$|@env[{]PATH[}]' \
  87           && fail=1;                                                    \
  88         exit $$fail
  89
  90 # Use "time zone", not "timezone".
  91 sc-avoid-timezone:
  92         $(AM_V_GEN)$(EGREP) timezone $(texi_files) && exit 1 || :
  93
  94 # Check for insufficient exponent grouping, e.g.,
  95 # @math{2^64} should be @math{2^{64}}.
  96 sc-exponent-grouping:
  97         $(AM_V_GEN)$(EGREP) '\{.*\^[0-9][0-9]' $(texi_files) && exit 1 || :
  98
  99 # Say I/O, not IO.
 100 sc-avoid-io:
 101         $(AM_V_GEN)$(EGREP) '$(_W)IO$(W_)' $(texi_files) && exit 1 || :
 102
 103 # I prefer nonzero over non-zero.
 104 sc-avoid-non-zero:
 105         $(AM_V_GEN)$(EGREP) non-zero $(texi_files) && exit 1 || :
 106
 107 # Use "zeros", not "zeroes" (nothing wrong with "zeroes"; just be consistent).
 108 sc-avoid-zeroes:
 109         $(AM_V_GEN)$(EGREP) -i '$(_W)zeroes$(W_)' $(texi_files) \
 110           && exit 1 || :
 111
 112 # The quantity inside @var{...} should not contain upper case letters.
 113 # The leading backslash exemption is to permit in-macro uses like
 114 # @var{\varName\} where the upper case letter is part of a parameter name.
 115 find_upper_case_var =           \
 116   '/\@var\{/ or next;           \
 117    while (/\@var\{(.+?)}/g)     \
 118      {                          \
 119        $$v = $$1;               \
 120        $$v =~ /[A-Z]/ && $$v !~ /^\\/ and (print "$$ARGV:$$.:$$_"), $$m = 1 \
 121      }                          \
 122    END {$$m and (warn "$@: do not use upper case in \@var{...}\n"), exit 1}'
 123 sc-lower-case-var:
 124         $(AM_V_GEN)$(PERL) -e 1 || { echo $@: skipping test; exit 0; }; \
 125           $(PERL) -lne $(find_upper_case_var) $(texi_files)
 126
 127 check-local: check-texinfo