Remove the dependency on the ancient and unmaintained texi2html, which
was difficult to get running on most distros other than openSUSE.
There are two more modern alternative approaches which can replace
this:
- Use texi2any
- Use makeinfo --html --no-split
The latter seems to be the standard way these days, so we switch to
that; however we keep Makefile rules for all three, and a phony
meta-rule 'manual-single-html-all' to allow quick comparison between
them. Make tweaks accordingly to minimise the differences and improve
the output.
The rules for the older two approaches do not get triggered by
default.
Fixes#21: https://github.com/aspiers/stow/issues/21
The title of the generated man page was ending up as something like
IO::FILE=IO(0XA719C0)(1)
Also, with newer perls (e.g. v5.22.1), pod2man requires --name if
used within a pipeline.
Closes#18.
https://github.com/aspiers/stow/issues/18
This is now necessary in order to prevent pause.perl.org from
complaining:
Status: Decreasing version number
=================================
module : Stow::Util
version: undef
in file: lib/Stow/Util.pm
status : Not indexed because lib/Stow/Util.pm in
A/AS/ASPIERS/Stow-v2.2.0.tar.gz has a higher version number
(0)
The dependency of the distributed file stow.8 on the non-distributed
file Makefile was causing this error:
ERROR: files left in build directory after distclean:
./doc/stow.8
The automake FAQ explains why this happens:
https://www.gnu.org/software/automake/manual/html_node/Errors-with-distclean.html
so change stow.8 to depend on Makefile.am which is distributed.
http://article.gmane.org/gmane.comp.sysutils.automake.general/13192
This means that it is still included in the distribution and
installed, but is only automatically (re)built when making a
new distribution - if stow.texi changes during development, it
has to be rebuilt manually via 'make pdf'.
