This reverts commit 1a20a3f7ee.
It turns out that `texi2dvi` _does_ require `-I $(srcdir)` for
`@verbatiminclude default-ignore-list` to work after all. It's needed
not for a normal docs build, but when `make distcheck` is run,
presumably because `distcheck` runs from a different directory.
We no longer need to ensure that texi2any (a.k.a. makeinfo) is called
with -I $(srcdir) in order to make the
@verbatiminclude default-ignore-list
in the manual work, because texi2any includes the current working
directory by default anyway. Presumably this behaviour was introduced
after this AM_MAKEINFOFLAGS was previously added, because it was
needed at some point in the past.
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'.
