3 # Copyright (C) 2001-2017 Free Software Foundation, Inc.
5 # This program is free software: you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; either version 3 of the License, or
8 # (at your option) any later version.
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with this program. If not, see <http://www.gnu.org/licenses/>.
19 # This program creates a program's manual from the .x skeleton and its --help
21 # The .x skeleton is a file containing manual page text that is not part of the
22 # --help output. It is passed to help2man via its --include option. Its format
23 # is described in the help2man documentation.
28 --update) update
=yes; shift;;
34 echo "Usage: x-to-1 [OPTIONS] PERL HELP2MAN executable program.x program.1" 1>&2
43 progname
=`basename $aux .x`
44 case "$PERL" in *"/missing perl") perlok
=no
;; *) perlok
=yes;; esac
45 if test @CROSS_COMPILING@
= no
&& test -f $executable && test $perlok = yes; then
46 echo "Updating man page $output"
47 echo "$PERL $HELP2MAN --include=$aux $executable > $output"
49 $PERL $HELP2MAN --include=$aux $executable > t-
$progname.1 ||
exit 1
50 if test -n "$update"; then
51 # In --update mode, don't overwrite the output if nothing would change.
52 if cmp t-
$progname.1 $output >/dev
/null
2>&1; then
55 mv t-
$progname.1 $output
58 mv t-
$progname.1 $output
61 echo "WARNING: The man page $output cannot be updated yet."