Why is it _still_ so freaking hard to get info with images?

[David Kastrup]

make prefix=/usr/local/lilypond install-info-WWW 
make --no-builtin-rules -C Documentation/user install-info
make[1]: Entering directory `/lisa/lilypond/Documentation/user'
export LILYPOND_DATADIR=
export 
PYTHONPATH=/lisa/lilypond/python/out:../../python/auxiliar:/lisa/lilypond/python/out:./python/auxiliar:
/usr/bin/python /lisa/lilypond/stepmake/bin/install.py -c -d 
/usr/local/lilypond/share/info

***************************************************************
Please add or update the LilyPond direntries, do

    install-info --info-dir=/usr/local/lilypond/share/info out/lilypond.info

For images in the INFO docs to work, do

    make out=www install-info 

and read the extra instructions.

/usr/bin/python /lisa/lilypond/stepmake/bin/install.py -c -d 
/usr/local/lilypond/share/info ; make 
INSTALLATION_OUT_DIR=/usr/local/lilypond/share/info depth=../.. 
INSTALLATION_OUT_FILES="./out/lilypond.info ./out/lilypond.info-1 
./out/lilypond.info-2 ./out/lilypond.info-3 ./out/lilypond.info-4 
./out/lilypond.info-5 ./out/lilypond-internals.info 
./out/lilypond-internals.info-1 ./out/lilypond-internals.info-2 
./out/lilypond-internals.info-3 ./out/lilypond-internals.info-4 
./out/music-glossary.info ./out/lilypond-program.info 
./out/lilypond-learning.info ./out/lilypond-learning.info-1 
./out/lilypond-learning.info-2" -f 
/lisa/lilypond/stepmake/stepmake/install-out.sub.make local-install
make[2]: Entering directory `/lisa/lilypond/Documentation/user'
(/usr/bin/python /lisa/lilypond/stepmake/bin/install.py -c -d 
/usr/local/lilypond/share/info || true) && /usr/bin/python 
/lisa/lilypond/stepmake/bin/install.py -c -c -m 644 ./out/lilypond.info 
./out/lilypond.info-1 ./out/lilypond.info-2 ./out/lilypond.info-3 
./out/lilypond.info-4 ./out/lilypond.info-5 ./out/lilypond-internals.info 
./out/lilypond-internals.info-1 ./out/lilypond-internals.info-2 
./out/lilypond-internals.info-3 ./out/lilypond-internals.info-4 
./out/music-glossary.info ./out/lilypond-program.info 
./out/lilypond-learning.info ./out/lilypond-learning.info-1 
./out/lilypond-learning.info-2 /usr/local/lilypond/share/info/
true
make[2]: Leaving directory `/lisa/lilypond/Documentation/user'
make[1]: Leaving directory `/lisa/lilypond/Documentation/user'
make --no-builtin-rules -C input/lsr install-info
make[1]: Entering directory `/lisa/lilypond/input/lsr'
true local-install
make[1]: Leaving directory `/lisa/lilypond/input/lsr'
(cd /usr/local/lilypond/share/info && rm -f lilypond && ln -sf 
$(/usr/bin/python /lisa/lilypond/scripts/build/out/relative 
/usr/local/lilypond/share/doc/lilypond/html/Documentation/user) lilypond)
(cd /usr/local/lilypond/share/info && rm -f lilypond-snippets && ln -sf 
$(/usr/bin/python /lisa/lilypond/scripts/build/out/relative 
/usr/local/lilypond/share/doc/lilypond/html/input/lsr) lilypond-snippets)

address@hidden:/lisa/lilypond$

Now the obvious interpretation of

    For images in the INFO docs to work, do

        make out=www install-info 

    and read the extra instructions.

would be

address@hidden:/lisa/lilypond$ make out=www prefix=/usr/local/lilypond 
install-info
make: *** No rule to make target `install-info'.  Stop.
address@hidden:/lisa/lilypond$ 

And sure enough: the installed tree contains no info files with images.

What point is there in complaining that Linux distributions tend to omit
the images when there is no working Makefile target that would get them
there, and when the instructions that the Makefile gives out don't even
work?

-- 
David Kastrup