[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: doc-base and gzipped PDF files



Hello Again,

On 08/07/13 17:34, Torquil Macdonald Sørensen wrote:
> On 08/07/13 17:10, Jerome BENOIT wrote:
>> Hello,
>>
>> On 08/07/13 17:01, Torquil Macdonald Sørensen wrote:
>>> Hi!
>>>
>>> While working on the new mpich package, I am experiencing some problems related to doc-base and gzipped PDF files. There are three such files, but I'll focus on one of them to explain the problem.
>>>
>>> The mpich-doc package contains /usr/share/doc/install.pdf.gz, which is an installation guide. In the package source, I have a file debian/mpich-doc.doc-base.install, which contains the text:
>>>
>>> ******************************************
>>> Document: mpich-install-guide
>>> Title: MPICH Installer's Guide
>>> Author: Pavan Balaji et. al.
>>> Abstract: Describes how to obtain and install MPICH.
>>> Section: Programming/C
>>>
>>> Format: PDF
>>> Files: /usr/share/doc/mpich-doc/install.pdf.gz
>>> *************************************
>>>
>>> This seems to work well during installation of the package, with no error messages. When mpich-doc is installed, I can access the file by running dhelp, going to the appropriate section, and clicking on the correct link. Firefox will then ask me what do do with the *.pdf.gz file, and I ask it to open it with evince, which works fine.
>>>
>>> But here comes the problem: When I uninstall mpich-doc, I get the following error message:
>>>
>>> ************************
>>> Invalid format PDF for mpich-install-guide (MPICH Installer's Guide)
>>> **************************
>>>
>>> Does the doc-base system not support gzipped PDF files? In the doc-base documentation, I see several other examples of gzipped files, e.g. *.ps.gz, *.dvi.gz, *.info.gz, *.txt.gz and *.sgml.gz.
>>>
>> Are you working with dh tools suite?
>>
>> If yes, have you tried to let them to manage the compression part ?
> 
> Yes, I'm using the dh tools. I'm not manually doing anything to those files debian/rules, so I guess those files are compressed automatically by dh_compress, which I can see is being run near the end of the package build procedure:
> 
> .
> .
> .
> make[1]: Leaving directory `/home/tmac/src/debian/mpich/mpich'
>    dh_installexamples -O--parallel
>    dh_installman -O--parallel
>    dh_perl -O--parallel
>    dh_link -O--parallel
>    dh_compress -O--parallel
>    dh_fixperms -O--parallel
>    dh_strip -O--parallel
>    dh_makeshlibs -O--parallel
>    dh_shlibdeps -O--parallel
> .
> .
> .
> 
> - Torquil
> 

I would give a try  with debian/mpich-doc.doc-base.install renamed  debian/mpich-doc.doc-base
(namaley without the .install extension).

Otherwise I would give a try with the following entry in debian/mpich-doc.doc-base

Files: /usr/share/doc/mpich-doc/install.pdf

Note that one can force dh_compress not to compress through the exclude option:

override_dh_compress:
  dh_compress --exclude=install.pdf


You may try this approach in last resort.


Finally, I suggest to give a less generic name to the `install.pdf' file,
something as `mpich-install.pdf'.

Jerome


> 


Reply to: