Installing from Git repository failed and problems with documentation formats
Laurence Finston <[email protected]> Tue, 5 Apr 2022 07:26:18 +0200
| Newsgroups | gmane.comp.gnu.mdk.bugs |
|---|---|
| Message-ID | <trinity-14d75770-0561-4039-a199-3e9f354419aa-1649136378615@3c-app-gmx-bap25> |
Hello,
I was able to install mdk 1.3.0 from the tarball. I was not able to insta=
ll MDK from the current version in the Git repository. This is the protoc=
ol:
$ git clone git://git.sv.gnu.org/mdk.git
$ cd mdk/
$ aclocal
$ autoconf
$ autoheader
Successful up to here.
$ automake --add-missing --copy
configure.ac:52: warning: AC_COMPILE_IFELSE was called before AC_USE_SYSTE=
M_EXTENSIONS
configure.ac:52: warning: AC_RUN_IFELSE was called before AC_USE_SYSTEM_EX=
TENSIONS
configure.ac:52: error: required file './config.rpath' not found
configure.ac:159: error: required file 'intl/Makefile.in' not found
configure.ac:52: error: required file './ABOUT-NLS' not found
The only file in [...]/mdk/intl is `.gitignore' (i.e., no `Makefile.am').
I wanted to generate the manual in PDF format. Using the dist. from the t=
arball, I got this error:
$ make gendocs
(cd ../doc && \
./gendocs.sh --email [email protected] mdk 'GNU MDK Users Manual')
/bin/bash: line 1: ./gendocs.sh: No such file or directory
make: *** [Makefile:989: gendocs] Error 127
Using the installation from the Git repository, I was able to generate `ge=
ndocs' but then I got this error:
$ gendocs
./gendocs: cannot find .texinfo or .texi or .txi for in /home/laurence/md=
k_local/git_repos/mdk/doc.
I just used `texi2dvi mdk.tex' and `dvipdfmx mdk.dvi' to generate the PDF =
file. The following aren't bugs, but I then had to print to a file to get=
it into DIN A4 format and had to look for the page numbers to eliminate t=
he blank page at the end and the COPYING section. Obviously, the COPYING =
section is needed but I think it would be a convenience to indicate how to=
eliminate it for printing purposes. I don't do this yet for my manuals, =
but I plan to.
I do think it's important, however, to provide documentation in PDF format=
from the point of view of accessibility for people who, like me, have pro=
blems reading on computer screens. If you don't want to do that, it would=
be nice if you would consider at least providing rules for this in `[...]=
/doc/Makefile.am', because not everybody knows how to use Texinfo.
Thanks.
Laurence Finston