Bug#898905: libemail-mime-perl: [doc] manpage refers to, but doesn't contain header_raw method (along with plenty of others from Email::Simple)

[Peter Gervai]

Package: libemail-mime-perl
Version: 1.946-1
Severity: minor

I am a bit confused reading the man of both Email::Simple and Email::MIME, since they're
similar (looks like they were planned to be implemented as exchangeable) but not
matching.

Particularly some references seem to refer from one to the other:
   header
       Achtung!  Beware this method!  In Email::MIME, it means the same as "header_str", but on an Email::Simple object, it means
       "header_raw".  Unless you always know what kind of object you have, you could get one of two significantly different behaviors.

       Try to use either "header_str" or "header_raw" as appropriate.

   header_str_pairs
         my @pairs = $email->header_str_pairs;

       This method behaves like "header_raw_pairs", returning a list of field name/value pairs, but the values have been decoded to
       character strings, when possible.


But neither header_raw nor header_raw_pairs is described on the manpage.


-- System Information:
Debian Release: buster/sid
  APT prefers oldstable-updates
  APT policy: (500, 'oldstable-updates'), (500, 'unstable'), (500, 'oldstable')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.15.0-1-amd64 (SMP w/8 CPU cores)
Locale: LANG=en_US.UTF8, LC_CTYPE=en_US.UTF8 (charmap=UTF-8), LANGUAGE=en_US.UTF8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash
Init: sysvinit (via /sbin/init)
LSM: AppArmor: enabled

Versions of packages libemail-mime-perl depends on:
ii  libemail-address-xs-perl        1.01-1
ii  libemail-messageid-perl         1.406-1
ii  libemail-mime-contenttype-perl  1.022-1
ii  libemail-mime-encodings-perl    1.315-1
ii  libemail-simple-perl            2.214-1
ii  libmime-types-perl              2.14-1
ii  libmodule-runtime-perl          0.015-1
ii  perl                            5.26.2-3

libemail-mime-perl recommends no packages.

libemail-mime-perl suggests no packages.

-- no debconf information