doc: update Vala documentation
[automake.git] / t / install-info-dir.sh
blob0852bcb8cab0aaf78b451e608c9ea4f80aa484d6
1 #! /bin/sh
2 # Copyright (C) 2011-2024 Free Software Foundation, Inc.
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 2, or (at your option)
7 # any later version.
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.
14 # You should have received a copy of the GNU General Public License
15 # along with this program. If not, see <https://www.gnu.org/licenses/>.
17 # Checks on the 'install-info' target.
18 # Details about the individual checks' purposes and motivations are
19 # inlined, below.
21 # FIXME: this test is a good candidate for a conversion to TAP,
22 # FIXME: and could be merged with 'txinfo27.sh'.
24 required=makeinfo
25 . test-init.sh
27 cwd=$(pwd) || fatal_ "cannot get current working directory"
29 mkdir bin
30 saved_PATH=$PATH; export saved_PATH
31 PATH=$cwd/bin$PATH_SEPARATOR$PATH; export PATH
33 cat >> configure.ac <<'END'
34 AC_OUTPUT
35 END
37 cat > Makefile.am << 'END'
38 info_TEXINFOS = foo.texi
39 END
41 cat > foo.texi << 'END'
42 \input texinfo
43 @setfilename foo.info
44 @c All the following directives might be required to allow older
45 @c versions of the 'install-info' program (e.g., version 4.8) to
46 @c create the 'dir' index file in ${infodir}. Don't remove them.
47 @settitle foo
48 @dircategory Dummy utilities
49 @direntry
50 * Foo: (foo). Does nothing at all, but has a nice name.
51 @end direntry
52 @node Top
53 Hello world!
54 @bye
55 END
57 $ACLOCAL
58 $AUTOMAKE -a
59 $AUTOCONF
61 instdir=_inst
62 destdir=_dest
64 ./configure --prefix="$cwd/$instdir" --infodir="$cwd/$instdir/info"
66 $MAKE info
67 test -f foo.info
69 if install-info --version; then
70 # Skip some checks even if 'install-info' is the one from dpkg, not
71 # the one from GNU info, as the former might try to create files in
72 # '/var/backups/', causing spurious failures like this for non-root
73 # users.
74 if install-info --version | $EGREP -i '(dpkg|debian) install-info'; then
75 have_installinfo=no
76 else
77 have_installinfo=yes
79 else
80 have_installinfo=no
83 # The 'install-info' target updates the '${infodir}/dir' file
84 # by default (if the 'install-info' program is available).
85 # This should happen in a normal as well as in a DESTDIR installation.
86 if test $have_installinfo = yes; then
88 $MAKE install-info
89 test -f $instdir/info/foo.info
90 cat $instdir/info/dir
91 $FGREP 'Does nothing at all, but has a nice name' $instdir/info/dir
93 $MAKE uninstall
94 test ! -e $instdir/info/foo.info
95 cat $instdir/info/dir
96 $FGREP 'but has a nice name' $instdir/info/dir && exit 1
98 dir="$destdir/$cwd/$instdir/info"
100 $MAKE DESTDIR="$cwd/$destdir" install-info
101 test -f "$dir"/foo.info
102 cat "$dir"/dir
103 $FGREP 'Does nothing at all, but has a nice name' "$dir"/dir
104 $MAKE DESTDIR="$cwd/$destdir" uninstall
105 test ! -e "$dir"/foo.info
106 $FGREP 'but has a nice name' "$dir"/dir && exit 1
108 unset dir
112 rm -rf $instdir $destdir
114 # The 'install-info' target doesn't fail if the 'install-info'
115 # program is not available.
116 cat > bin/install-info <<'END'
117 #!/bin/sh
118 echo error from install-info >&2
119 exit 127
121 chmod a+x bin/install-info
122 run_make -M install-info
123 test -f $instdir/info/foo.info
124 test ! -e $instdir/info/dir
125 grep 'error from install-info' output && exit 1
127 rm -rf $instdir output
129 if test $have_installinfo = yes; then
130 # The 'install-info' target doesn't try to guess whether the 'install-info'
131 # is the GNU or debian version.
132 unindent > bin/install-info <<'END'
133 #!/bin/sh
134 set -e; set -u;
135 for fd in 1 2; do
136 for str in dpkg debian Debian; do
137 eval "echo This is $str install-info >&$fd"
138 done
139 done
140 PATH=$saved_PATH; export PATH
141 exec install-info ${1+"$@"}
143 $MAKE install-info
144 test -f $instdir/info/foo.info
145 cat $instdir/info/dir
146 $MAKE uninstall
147 test ! -e $instdir/info/foo.info
148 cat $instdir/info/dir
149 $FGREP 'but has a nice name' $instdir/info/dir && exit 1
150 : For shells with busted 'set -e'.
153 rm -rf $instdir bin/install-info
155 # The 'AM_UPDATE_INFO_DIR' environment variable can be used to
156 # prevent the creation or update of the '${infodir}/dir' file,
157 # if set to a "no" value.
158 for val in no NO n; do
159 rm -rf $instdir
160 env AM_UPDATE_INFO_DIR="$val" $MAKE install-info
161 test -f $instdir/info/foo.info
162 test ! -e $instdir/info/dir
163 done
165 $MAKE install-info
166 if test $have_installinfo != yes; then
167 echo 'Does nothing at all, but has a nice name' > $instdir/info/dir
170 chmod a-w $instdir/info/dir
171 for val in no NO n; do
172 env AM_UPDATE_INFO_DIR="$val" $MAKE uninstall
173 cat $instdir/info/dir
174 $FGREP 'Does nothing at all, but has a nice name' $instdir/info/dir
175 done
177 if test $have_installinfo = yes; then
178 for val in 'yes' 'who cares!'; do
179 rm -rf $instdir
180 env AM_UPDATE_INFO_DIR="$val" $MAKE install-info
181 test -f $instdir/info/foo.info
182 cat $instdir/info/dir
183 env AM_UPDATE_INFO_DIR="$val" $MAKE uninstall
184 test ! -e $instdir/info/foo.info
185 $FGREP 'but has a nice name' $instdir/info/dir && exit 1
186 : For shells with busted 'set -e'.
187 done