Bug#1084464: libdebian-source-perl: Debian::Control::read does not accept an open filehandle, contrary to manpage

[gregor herrmann]

On Mon, 07 Oct 2024 19:04:26 +0800, Sean Whitton wrote:

> Debian::Control(3pm) says that Debian::Control::read accepts a filename,
> scalar reference or open filehandle.
> But it does not seem to actually accept an open filehandle:

Thanks for your bug report.

Debian::Control uses Parse::DebControl (libparse-debcontrol-perl),
and its documentation says:

•   "parse_file($control_filename,$options)"
Takes  a  filename  as  a scalar
•   "parse_mem($control_data, $options)"
Similar to "parse_file", except takes data as a scalar.

and parse_file/parse_mem are used in Debian::Control.

Apparently accepting filehandles doesn't work in Parse::DebControl;
it looks like the documentation for Debian::Control::read is just
incorrect, and I think all we can do is to fix the docs.


Cheers,
gregor

-- 
 .''`.  https://info.comodo.priv.at -- Debian Developer https://www.debian.org
 : :' : OpenPGP fingerprint D1E1 316E 93A7 60A8 104D  85FA BB3A 6801 8649 AA06
 `. `'  Member VIBE!AT & SPI Inc. -- Supporter Free Software Foundation Europe
   `-   
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 963 bytes
Desc: Digital Signature
URL: <http://alioth-lists.debian.net/pipermail/pkg-perl-maintainers/attachments/20241013/d2474949/attachment.sig>