unexpected debhelper behavior renders postinst inoperative

Bug #28512 reported by Emmet Hikory
6
Affects Status Importance Assigned to Milestone
installation-guide (Ubuntu)
Fix Released
Medium
Tollef Fog Heen

Bug Description

    When upgrading to 20060102ubuntu2, the following error is reported by aptitude:

E: Sub-process /usr/bin/dpkg returned an error code (1)
A package failed to install. Trying to recover:
Setting up installation-guide-amd64 (20060102ubuntu2) ...
cannot create dhelp file '/usr/share/doc/installation-guide-%ARCH%/%LANG%/.dhelp': No such file or directory
dpkg: error processing installation-guide-amd64 (--configure):
 subprocess post-installation script returned error exit status 2
Errors were encountered while processing:
 installation-guide-amd64

    The error appears to be related to the first of the two automatically installed stanzas, where the sed logic in debian/rules seems not to have applied. Note that the package also includes the file /usr/share/doc-base/installation-guide-%ARCH%-%LANG%, which seems to contain the verbatim contents of debian/rules/doc-base.TEMPLATE.

Revision history for this message
Emmet Hikory (persia) wrote :

Further investigation leads me to believe that dh_installdocs is confused, and believes that installation-guide-amd64 is the MAINPACKAGE, and therefore installs both installation-guide-amd64.doc-base.* and doc-base.TEMPLATE. This bug does not appear in other architectures.

Revision history for this message
Emmet Hikory (persia) wrote : Workaround for MAINPACKAGE behavior

To avoid the debhelper MAINPACKAGE behaviour, doc-base.TEMPLATE was renamed to generic.doc-base.TEMPLATE, thereby no longer being bare, and not caught by the laazy maintainer filters in dh_installdocs.

Emmet Hikory (persia)
Changed in installation-guide:
assignee: nobody → ubuntu-doc
Revision history for this message
Matthew East (mdke) wrote :

The Documentation Project doesn't work on this package, so I'm unassigning it.

Changed in installation-guide:
assignee: ubuntu-doc → nobody
Revision history for this message
Matthew East (mdke) wrote :

Colin, any idea about this?

Revision history for this message
Emmet Hikory (persia) wrote :

My apologies: I guessed based on the history of #4637.

Matt Zimmerman (mdz)
Changed in installation-guide:
assignee: nobody → tfheen
Revision history for this message
Tollef Fog Heen (tfheen) wrote :

dh_installdocs is acting according to its design. Since installation-guide-amd64 is the first package in the control file, it is the main package.

Revision history for this message
Emmet Hikory (persia) wrote :

The dh_installdocs behaviour makes sense now (after investigation), but I still believe that installation-guide needs to rename the doc-base.TEMPLATE file to avoid the annoying postinstall behaviour for installation-guide-amd64.

Revision history for this message
Tollef Fog Heen (tfheen) wrote :

installation-guide (20060102ubuntu4) dapper; urgency=low

  * Rename doc-base.TEMPLATE to TEMPLATE.doc-base. Malone #28512

 -- Tollef Fog Heen <email address hidden> Tue, 25 Apr 2006 15:09:29 +0200

Changed in installation-guide:
status: Unconfirmed → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.