branches/8.2.x/missing

#! /bin/sh
# Common wrapper for a few potentially missing GNU programs.

scriptversion=2018-03-07.03; # UTC

# Copyright (C) 1996-2018 Free Software Foundation, Inc.
# Originally written by Fran,cois Pinard <pinard@iro.umontreal.ca>, 1996.

# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2, or (at your option)
# any later version.

# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.

# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <https://www.gnu.org/licenses/>.

# As a special exception to the GNU General Public License, if you
# distribute this file as part of a program that contains a
# configuration script generated by Autoconf, you may include it under
# the same distribution terms that you use for the rest of that program.

if test $# -eq 0; then
  echo 1>&2 "Try '$0 --help' for more information"
  exit 1
fi

case $1 in

  --is-lightweight)
    # Used by our autoconf macros to check whether the available missing
    # script is modern enough.
    exit 0
    ;;

  --run)
    # Back-compat with the calling convention used by older automake.
    shift
    ;;

  -h|--h|--he|--hel|--help)
    echo "\
$0 [OPTION]... PROGRAM [ARGUMENT]...

Run 'PROGRAM [ARGUMENT]...', returning a proper advice when this fails due
to PROGRAM being missing or too old.

Options:
  -h, --help      display this help and exit
  -v, --version   output version information and exit

Supported PROGRAM values:
  aclocal   autoconf  autoheader   autom4te  automake  makeinfo
  bison     yacc      flex         lex       help2man

Version suffixes to PROGRAM as well as the prefixes 'gnu-', 'gnu', and
'g' are ignored when checking the name.

Send bug reports to <bug-automake@gnu.org>."
    exit $?
    ;;

  -v|--v|--ve|--ver|--vers|--versi|--versio|--version)
    echo "missing $scriptversion (GNU Automake)"
    exit $?
    ;;

  -*)
    echo 1>&2 "$0: unknown '$1' option"
    echo 1>&2 "Try '$0 --help' for more information"
    exit 1
    ;;

esac

# Run the given program, remember its exit status.
"$@"; st=$?

# If it succeeded, we are done.
test $st -eq 0 && exit 0

# Also exit now if we it failed (or wasn't found), and '--version' was
# passed; such an option is passed most likely to detect whether the
# program is present and works.
case $2 in --version|--help) exit $st;; esac

# Exit code 63 means version mismatch.  This often happens when the user
# tries to use an ancient version of a tool on a file that requires a
# minimum version.
if test $st -eq 63; then
  msg="probably too old"
elif test $st -eq 127; then
  # Program was missing.
  msg="missing on your system"
else
  # Program was found and executed, but failed.  Give up.
  exit $st
fi

perl_URL=https://www.perl.org/
flex_URL=https://github.com/westes/flex
gnu_software_URL=https://www.gnu.org/software

program_details ()
{
  case $1 in
    aclocal|automake)
      echo "The '$1' program is part of the GNU Automake package:"
      echo "<$gnu_software_URL/automake>"
      echo "It also requires GNU Autoconf, GNU m4 and Perl in order to run:"
      echo "<$gnu_software_URL/autoconf>"
      echo "<$gnu_software_URL/m4/>"
      echo "<$perl_URL>"
      ;;
    autoconf|autom4te|autoheader)
      echo "The '$1' program is part of the GNU Autoconf package:"
      echo "<$gnu_software_URL/autoconf/>"
      echo "It also requires GNU m4 and Perl in order to run:"
      echo "<$gnu_software_URL/m4/>"
      echo "<$perl_URL>"
      ;;
  esac
}

give_advice ()
{
  # Normalize program name to check for.
  normalized_program=`echo "$1" | sed '
    s/^gnu-//; t
    s/^gnu//; t
    s/^g//; t'`

  printf '%s\n' "'$1' is $msg."

  configure_deps="'configure.ac' or m4 files included by 'configure.ac'"
  case $normalized_program in
    autoconf*)
      echo "You should only need it if you modified 'configure.ac',"
      echo "or m4 files included by it."
      program_details 'autoconf'
      ;;
    autoheader*)
      echo "You should only need it if you modified 'acconfig.h' or"
      echo "$configure_deps."
      program_details 'autoheader'
      ;;
    automake*)
      echo "You should only need it if you modified 'Makefile.am' or"
      echo "$configure_deps."
      program_details 'automake'
      ;;
    aclocal*)
      echo "You should only need it if you modified 'acinclude.m4' or"
      echo "$configure_deps."
      program_details 'aclocal'
      ;;
   autom4te*)
      echo "You might have modified some maintainer files that require"
      echo "the 'autom4te' program to be rebuilt."
      program_details 'autom4te'
      ;;
    bison*|yacc*)
      echo "You should only need it if you modified a '.y' file."
      echo "You may want to install the GNU Bison package:"
      echo "<$gnu_software_URL/bison/>"
      ;;
    lex*|flex*)
      echo "You should only need it if you modified a '.l' file."
      echo "You may want to install the Fast Lexical Analyzer package:"
      echo "<$flex_URL>"
      ;;
    help2man*)
      echo "You should only need it if you modified a dependency" \
           "of a man page."
      echo "You may want to install the GNU Help2man package:"
      echo "<$gnu_software_URL/help2man/>"
    ;;
    makeinfo*)
      echo "You should only need it if you modified a '.texi' file, or"
      echo "any other file indirectly affecting the aspect of the manual."
      echo "You might want to install the Texinfo package:"
      echo "<$gnu_software_URL/texinfo/>"
      echo "The spurious makeinfo call might also be the consequence of"
      echo "using a buggy 'make' (AIX, DU, IRIX), in which case you might"
      echo "want to install GNU make:"
      echo "<$gnu_software_URL/make/>"
      ;;
    *)
      echo "You might have modified some files without having the proper"
      echo "tools for further handling them.  Check the 'README' file, it"
      echo "often tells you about the needed prerequisites for installing"
      echo "this package.  You may also peek at any GNU archive site, in"
      echo "case some other package contains this missing '$1' program."
      ;;
  esac
}

give_advice "$1" | sed -e '1s/^/WARNING: /' \
                       -e '2,$s/^/         /' >&2

# Propagate the correct exit status (expected to be 127 for a program
# not found, 63 for a program that failed due to version mismatch).
exit $st

# Local variables:
# eval: (add-hook 'before-save-hook 'time-stamp)
# time-stamp-start: "scriptversion="
# time-stamp-format: "%:y-%02m-%02d.%02H"
# time-stamp-time-zone: "UTC0"
# time-stamp-end: "; # UTC"
# End:
Revision:	8746
Committed:	Thu Dec 27 19:54:45 2018 UTC (7 years, 6 months ago) by michael
File size:	6878 byte(s)
Log Message:	- Recreate autogenerated files
#	User	Rev	Content
1	michael	912	#! /bin/sh
2	michael	1720	# Common wrapper for a few potentially missing GNU programs.
3	michael	912
4	michael	8746	scriptversion=2018-03-07.03; # UTC
5	michael	912
6	michael	8746	# Copyright (C) 1996-2018 Free Software Foundation, Inc.
7	michael	1720	# Originally written by Fran,cois Pinard <pinard@iro.umontreal.ca>, 1996.
8	michael	912
9			# This program is free software; you can redistribute it and/or modify
10			# it under the terms of the GNU General Public License as published by
11			# the Free Software Foundation; either version 2, or (at your option)
12			# any later version.
13
14			# This program is distributed in the hope that it will be useful,
15			# but WITHOUT ANY WARRANTY; without even the implied warranty of
16			# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17			# GNU General Public License for more details.
18
19			# You should have received a copy of the GNU General Public License
20	michael	8746	# along with this program. If not, see <https://www.gnu.org/licenses/>.
21	michael	912
22			# As a special exception to the GNU General Public License, if you
23			# distribute this file as part of a program that contains a
24			# configuration script generated by Autoconf, you may include it under
25			# the same distribution terms that you use for the rest of that program.
26
27			if test $# -eq 0; then
28	michael	1375	echo 1>&2 "Try '$0 --help' for more information"
29	michael	912	exit 1
30			fi
31
32	michael	1720	case $1 in
33	michael	912
34	michael	1720	--is-lightweight)
35			# Used by our autoconf macros to check whether the available missing
36			# script is modern enough.
37			exit 0
38			;;
39	michael	912
40	michael	1720	--run)
41			# Back-compat with the calling convention used by older automake.
42			shift
43			;;
44	michael	912
45			-h\|--h\|--he\|--hel\|--help)
46			echo "\
47			$0 [OPTION]... PROGRAM [ARGUMENT]...
48
49	michael	1720	Run 'PROGRAM [ARGUMENT]...', returning a proper advice when this fails due
50			to PROGRAM being missing or too old.
51	michael	912
52			Options:
53			-h, --help display this help and exit
54			-v, --version output version information and exit
55
56			Supported PROGRAM values:
57	michael	1720	aclocal autoconf autoheader autom4te automake makeinfo
58			bison yacc flex lex help2man
59	michael	912
60	michael	1375	Version suffixes to PROGRAM as well as the prefixes 'gnu-', 'gnu', and
61			'g' are ignored when checking the name.
62	michael	945
63	michael	912	Send bug reports to <bug-automake@gnu.org>."
64			exit $?
65			;;
66
67			-v\|--v\|--ve\|--ver\|--vers\|--versi\|--versio\|--version)
68			echo "missing $scriptversion (GNU Automake)"
69			exit $?
70			;;
71
72			-*)
73	michael	1720	echo 1>&2 "$0: unknown '$1' option"
74	michael	1375	echo 1>&2 "Try '$0 --help' for more information"
75	michael	912	exit 1
76			;;
77
78			esac
79
80	michael	1720	# Run the given program, remember its exit status.
81			"$@"; st=$?
82	michael	945
83	michael	1720	# If it succeeded, we are done.
84			test $st -eq 0 && exit 0
85	michael	912
86	michael	1720	# Also exit now if we it failed (or wasn't found), and '--version' was
87			# passed; such an option is passed most likely to detect whether the
88			# program is present and works.
89			case $2 in --version\|--help) exit $st;; esac
90	michael	912
91	michael	1720	# Exit code 63 means version mismatch. This often happens when the user
92			# tries to use an ancient version of a tool on a file that requires a
93			# minimum version.
94			if test $st -eq 63; then
95			msg="probably too old"
96			elif test $st -eq 127; then
97			# Program was missing.
98			msg="missing on your system"
99			else
100			# Program was found and executed, but failed. Give up.
101			exit $st
102			fi
103	michael	912
104	michael	8746	perl_URL=https://www.perl.org/
105			flex_URL=https://github.com/westes/flex
106			gnu_software_URL=https://www.gnu.org/software
107	michael	912
108	michael	1720	program_details ()
109			{
110			case $1 in
111			aclocal\|automake)
112			echo "The '$1' program is part of the GNU Automake package:"
113			echo "<$gnu_software_URL/automake>"
114			echo "It also requires GNU Autoconf, GNU m4 and Perl in order to run:"
115			echo "<$gnu_software_URL/autoconf>"
116			echo "<$gnu_software_URL/m4/>"
117			echo "<$perl_URL>"
118			;;
119			autoconf\|autom4te\|autoheader)
120			echo "The '$1' program is part of the GNU Autoconf package:"
121			echo "<$gnu_software_URL/autoconf/>"
122			echo "It also requires GNU m4 and Perl in order to run:"
123			echo "<$gnu_software_URL/m4/>"
124			echo "<$perl_URL>"
125			;;
126			esac
127			}
128	michael	912
129	michael	1720	give_advice ()
130			{
131			# Normalize program name to check for.
132			normalized_program=`echo "$1" \| sed '
133			s/^gnu-//; t
134			s/^gnu//; t
135			s/^g//; t'`
136	michael	912
137	michael	1720	printf '%s\n' "'$1' is $msg."
138	michael	912
139	michael	1720	configure_deps="'configure.ac' or m4 files included by 'configure.ac'"
140			case $normalized_program in
141			autoconf*)
142			echo "You should only need it if you modified 'configure.ac',"
143			echo "or m4 files included by it."
144			program_details 'autoconf'
145			;;
146			autoheader*)
147			echo "You should only need it if you modified 'acconfig.h' or"
148			echo "$configure_deps."
149			program_details 'autoheader'
150			;;
151			automake*)
152			echo "You should only need it if you modified 'Makefile.am' or"
153			echo "$configure_deps."
154			program_details 'automake'
155			;;
156			aclocal*)
157			echo "You should only need it if you modified 'acinclude.m4' or"
158			echo "$configure_deps."
159			program_details 'aclocal'
160			;;
161			autom4te*)
162			echo "You might have modified some maintainer files that require"
163	michael	2722	echo "the 'autom4te' program to be rebuilt."
164	michael	1720	program_details 'autom4te'
165			;;
166			bison\|yacc)
167			echo "You should only need it if you modified a '.y' file."
168			echo "You may want to install the GNU Bison package:"
169			echo "<$gnu_software_URL/bison/>"
170			;;
171			lex\|flex)
172			echo "You should only need it if you modified a '.l' file."
173			echo "You may want to install the Fast Lexical Analyzer package:"
174			echo "<$flex_URL>"
175			;;
176			help2man*)
177			echo "You should only need it if you modified a dependency" \
178			"of a man page."
179			echo "You may want to install the GNU Help2man package:"
180			echo "<$gnu_software_URL/help2man/>"
181	michael	912	;;
182	michael	1720	makeinfo*)
183			echo "You should only need it if you modified a '.texi' file, or"
184			echo "any other file indirectly affecting the aspect of the manual."
185			echo "You might want to install the Texinfo package:"
186			echo "<$gnu_software_URL/texinfo/>"
187			echo "The spurious makeinfo call might also be the consequence of"
188			echo "using a buggy 'make' (AIX, DU, IRIX), in which case you might"
189			echo "want to install GNU make:"
190			echo "<$gnu_software_URL/make/>"
191			;;
192			*)
193			echo "You might have modified some files without having the proper"
194			echo "tools for further handling them. Check the 'README' file, it"
195			echo "often tells you about the needed prerequisites for installing"
196			echo "this package. You may also peek at any GNU archive site, in"
197			echo "case some other package contains this missing '$1' program."
198			;;
199			esac
200			}
201	michael	912
202	michael	1720	give_advice "$1" \| sed -e '1s/^/WARNING: /' \
203			-e '2,$s/^/ /' >&2
204	michael	912
205	michael	1720	# Propagate the correct exit status (expected to be 127 for a program
206			# not found, 63 for a program that failed due to version mismatch).
207			exit $st
208	michael	912
209			# Local variables:
210	michael	8746	# eval: (add-hook 'before-save-hook 'time-stamp)
211	michael	912	# time-stamp-start: "scriptversion="
212			# time-stamp-format: "%:y-%02m-%02d.%02H"
213	michael	8316	# time-stamp-time-zone: "UTC0"
214	michael	945	# time-stamp-end: "; # UTC"
215	michael	912	# End: