Bug#263832: ITP: libhtml-htmldoc-perl -- Perl interface to the htmldoc program for producing PDF-Files from HTML-Content
On Thu, Aug 05, 2004 at 08:35:15AM -0600, David Everly wrote:
> Description : Perl interface to the htmldoc program for producing PDF-Files from HTML-Content
This description needs to be trimmed a bit, I think. Perhaps:
"Perl interface for producing PDF files from HTML"
The long description needs a bit of a tune-up, too:
> This Module provides an OO-interface to the htmldoc program.
>
> You can use it to produce PDF or PS files from a HTML-document. Currently
> many but not all parameters of HTMLDoc are supported.
>
> You need to have HTMLDoc installed before installing this module.
Trim this sentence. Debian has dependencies for this sort of thing.
> All the pdf-Methods return true for success or false for failure. You can
> test if errors occurred by calling the error-method.
That's a little more info than I necessarily needed to know in a package
description. The API docs should have all this sort of information.
> Normaly this module uses IPC::Open3 for communacation with the HTMLDOC
> process. However, in mod_perl-environments there appear problems with this
> module because the standard-output can not be captured. For this problem
> this module provides a fix doing the communication in file-mode.
s/Normaly/Normally/, if this paragraph is needed at all. It doesn't really
help me, as a potential user of libhtml-htmldoc-perl, decide whether or not
this is the package for me. Again, it feels like it should be in the
package's API or README documentation.
- Matt
Reply to: