Bug#1001218: svnclientadapter: non-reproducible build: two different doc-base files

[Simon McVittie]

Source: svnclientadapter
Version: 1.10.12-1
Severity: normal
X-Debbugs-Cc: reproducible-bugs at lists.alioth.debian.org

According to
https://tests.reproducible-builds.org/debian/rb-pkg/bookworm/i386/diffoscope-results/svnclientadapter.html
and similar test results, the libsvnclientadapter-java-doc package is
non-deterministic. In some builds,
./usr/share/doc-base/libsvnclientadapter-java-doc.libsvnclientadapter-java-doc
has this content:

Document: libsvnclientadapter-java-doc
Title: SVNClientAdapter API
Author: svnClientAdapter project and others.
Abstract: This is the API documentation for SVNClientAdapter.
Section: Programming/Java
Format: HTML
Index: /usr/share/doc/libsvnclientadapter-java-doc/api/index.html
Files: /usr/share/doc/libsvnclientadapter-java-doc/api/*.html

and in other builds, it's this:

Document: libsvnclientadapter-java-doc
Title: API JavaDoc for libsvnclientadapter-java-doc
Author: The authors of libsvnclientadapter-java-doc
Abstract: This is the API JavaDoc for libsvnclientadapter-java-doc
Section: Programming/Java
Format: HTML
Index: /usr/share/doc/libsvnclientadapter-java-doc/api
Files: /usr/share/doc/libsvnclientadapter-java-doc/api/*.html

I think one of these is debian/libsvnclientadapter-java-doc.doc-base
and the other might be automatically-generated by Debian Java tools from
the Javadoc documentation? (See also #889650.)

If Debian's Java tools can automatically generate doc-base files from
Javadoc, then one solution would be to remove
debian/libsvnclientadapter-java-doc.doc-base.

Another possible solution would be to ask Debian's Java tools to *not*
generate a doc-base file from this particular set of Javadoc documentation,
or to suppress it automatically if it would be redundant with a
manually-provided debian/*.doc-base.

    smcv