Package: asciidoc Version: 9.0.0~rc2-1 Severity: important Dear maintainer,
while I'm pleased to learn asciidoc is back in the game (contrary to
#895462), I was fairly surprised about the things I saw when trying to
convert a package back to asciidoc like originally provided by upstream:
Nothing usual, upstream uses the asciidoc program is to render the
manpage from adoc to *roff, so the invocation basically is
a2x -f manpage --no-xmllint <manpage>.adoc
That failed in a clean chroot and after some strace I learned a2x calls
xsltproc, which happily connects to the net to gather some more
information. While questionable in general - and if memory serves me
right, connects are done in plain text http - this would render each
Debian package that uses a2x during build rc-buggy for attempting
network access.
Now xsltproc has a "--nonet" option, but its usage is disabled in
a2x (line 517).
Please provide a way out of this, which means: Create a solution within
asciidoc - so packagers need to do as litte effort as possible.
As an idea, first enable the "--nonet" usage as indicated above. If you
think this is too intrusive, provide two flavours of the a2x program
where the "nonet" variant should be provided by a separate package which
is especially designed to be used as a build dependency, possible name
"asciidoc-offline". That package would also depend on the packages
xsltproc needs in "nonet", at least docbook-xsl and xml-core. There
might be more, I'm still seeing an access to http://www.oasis-open.org/
despite the requested docbookx.dtd is provided by docbook-xsl. But
that's something xsltproc has to deal with.
For a finishing touch:
* Provide a lintian warning for each package that build-depends on
asciidoc, asciidoc-offline should be recommended instead.
* In that asciidoc-offline flavour, enable verbose invocation of all
sub-processes by default to make the build "as verbose as reasonably
possible", as (again) by policy 4.9.
Regards,
Christoph
-- System Information:
Debian Release: bullseye/sid
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)
Kernel: Linux 5.10.8 (SMP w/4 CPU threads)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
Versions of packages asciidoc depends on:
ii asciidoc-base 9.0.0~rc2-1
Versions of packages asciidoc recommends:
pn asciidoc-dblatex <none>
pn asciidoc-doc <none>
pn vim-asciidoc <none>
asciidoc suggests no packages.
-- no debconf information
signature.asc
Description: PGP signature
