Bug#1003075: gnutls28: HTML API reference documentation is not generated

[Andreas Metzler]

Control: tags -1 confirmed

On 2022-01-03 Dennis Filder <d.filder at web.de> wrote:
> Source: gnutls28
> Version: 3.7.2-4
> Tags: patch

> Building the HTML api-reference docs seems to have been broken for
> quite a while due to XML shenanigans.  The first of the attached
> patches makes it work again, but fixing makeinfo to emit DocBook that
> is actually valid XML would be better.

Hello Dennis,

Thanks. The thing probably broke as part of a global http--->https
switch in Feb 2019. The proper fix would probably be to move to the
"modern" gtk-layout without template files.

> The second patch polishes d/rules a bit.

> The patches apply cleanly to 3.7.2-4, but I only ran the build with
> 3.7.1-5.

> Regards.


> --- a/debian/rules
> +++ b/debian/rules
> @@ -46,7 +46,7 @@
>  		$(AMCONFBUILDINDEP)

>  override_dh_autoreconf:
> -	rm -v `grep -rl gettext-0.20 m4/`
> +	-rm -v `grep -rl gettext-0.20 m4/`
>  	if ! dh_listpackages | grep -q gnutls-doc ; \
>  		then env GTKDOCIZE="echo DISABLED running gtkdocize" \
>  			dh_autoreconf --verbose $(BDIR) ; \
> @@ -78,7 +78,7 @@
>  	# restore gnutls.pdf
>  	if [ -e doc/gnutls.pdf.debbackup ] && [ ! -e doc/gnutls.pdf ] ; \
>  		then mv -v doc/gnutls.pdf.debbackup doc/gnutls.pdf ; fi
> -	rm -fv \
> +	-rm -fv \
>  		`grep -El 'has been AutoGen-ed |has been AutoGen-ed *$$' doc/manpages/*.?`

I will probably not take these two changes and ignore errors since I
would like to see when these hotfixes are superfluous and can be removed.

Thanks again!

cu Andreas

-- 
`What a good friend you are to him, Dr. Maturin. His other friends are
so grateful to you.'
`I sew his ears on from time to time, sure'