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