#709912 Error while merging foo-xx with foo-en: format html already defined

Package:
doc-base
Source:
doc-base
Submitter:
Daniel Leidert
Date:
2013-11-02 04:27:04 UTC
Severity:
normal
#709912#5
Date:
2013-05-26 16:44:10 UTC
From:
To:
Since a few releases doc-base began to complain about a few packages I maintained, e.g.

  Error while merging /usr/share/doc-base/gtypist-cs with /usr/share/doc-base/gtypist-en: format html already defined

The gtypist package ships the documentation in several langauges. For each
a .doc-base.xx file exists - all of them with the same document id to merge
the documentation for the package. However now doc-base complains as above.

So what to do? Give every file an own ID? But then they cannot be merged anymore.

Regards, Daniel


- -- System Information:
Debian Release: jessie/sid
  APT prefers unstable
  APT policy: (850, 'unstable'), (560, 'stable'), (500, 'oldstable'), (110, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 3.8-2-amd64 (SMP w/2 CPU cores)
Locale: LANG=de_DE.utf8, LC_CTYPE=de_DE.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages doc-base depends on:
ii  libuuid-perl       0.02-5
ii  libyaml-tiny-perl  1.51-2

doc-base recommends no packages.

Versions of packages doc-base suggests:
ii  rarian-compat  0.8.1-5
ii  yelp           3.4.2-1+b1

- -- no debconf information
iEYEARECAAYFAlGiO9QACgkQm0bx+wiPa4yaIwCffPoKv+4merrmq+j03KtvcGMn
mR0An1D0DZm8uCdVV5fYHEADDVuAvH6Y
=zEy0
-----END PGP SIGNATURE-----
#709912#12
Date:
2013-06-26 23:58:49 UTC
From:
To:
Hi Daniel,

Correct me if I'm wrong, but according to 'doc-base' documentation [0]
you *can* use the same Document ID for the same documentation in
multiple files, but it only makes sense if you use different formats:


2.5.1 Splitting control files over multiple binary packages

Since version 0.8.7 is it possible to provide documents with the same
document-id by more than one binary package. All such documents with be
merged together and the merged document will be generated in
/var/lib/doc-base/documents/document-id file. This feature can be useful
in cases when the same documentation, but in different formats, is
provided by two binary packages.


Here it mentions multiple binary packages, but it may as well be applied
to your example, where everything is in the same package. You get the
above error because your already specified HTML format for 'gtypist'.
You could merge it if you provided, i.e. PDF, PS or other formats.
Also, translations are not the same documentation any more, they're
distinct in 'doc-base' meaning.

This is how I understand it and it is what 'doc-base' documentation
suggests. It's hard to be 100% sure as the documentation I quoted
doesn't mention anything about translations. However, modifying Document
ID for each translation fixes the issue. Morover, this is what other
packages are doing exactyl - having different Document IDs for
translations.

[0] file:///usr/share/doc/doc-base/doc-base.html/ch-interface.html

I hope this helps.

Regards,

Raf
#709912#17
Date:
2013-11-02 04:24:13 UTC
From:
To:
Hi all,
I have been getting similar merger error issues on the CLI while upgrading :-

Error while merging /usr/share/doc-base/kino-en with
/usr/share/doc-base/kino-fr: format html already defined.

I am guessing it's the same issue, just with a different package. I
have also CC'ed the maintainer of the $PACKAGE that has the problem as
shared above.

Hopefully this is fixed/fixable soonish.