As I indicated earlier, "I haven't used it myself". I installed it using the built-in cpan utility; but very slightly differently to you: 

$ cpan

cpan shell -- CPAN exploration and modules installation (v2.29)
Enter 'h' for help.

cpan[1]> install Courriel
...

[download]

I don't believe that should make any difference. The output included: 

Installing /home/ken/perl5/perlbrew/perls/perl-5.34.0/man/man3/Courrie
+l.3pm
Installing /home/ken/perl5/perlbrew/perls/perl-5.34.0/man/man3/Courrie
+l.Builder.3pm
Installing /home/ken/perl5/perlbrew/perls/perl-5.34.0/man/man3/Courrie
+l.Header.3pm
Installing /home/ken/perl5/perlbrew/perls/perl-5.34.0/man/man3/Courrie
+l.Header.ContentType.3pm
Installing /home/ken/perl5/perlbrew/perls/perl-5.34.0/man/man3/Courrie
+l.Header.Disposition.3pm
Installing /home/ken/perl5/perlbrew/perls/perl-5.34.0/man/man3/Courrie
+l.HeaderAttribute.3pm
Installing /home/ken/perl5/perlbrew/perls/perl-5.34.0/man/man3/Courrie
+l.Headers.3pm
Installing /home/ken/perl5/perlbrew/perls/perl-5.34.0/man/man3/Courrie
+l.Part.Multipart.3pm
Installing /home/ken/perl5/perlbrew/perls/perl-5.34.0/man/man3/Courrie
+l.Part.Single.3pm
Installing /home/ken/perl5/perlbrew/perls/perl-5.34.0/man/man3/Email.A
+bstract.Courriel.3pm

[download]

I successfully checked that I could load the module: 

$ perl -e 'use Courriel'

[download]

I then tried perldoc Courriel: 

NAME
    Courriel - High level email parsing and manipulation

VERSION
    version 0.49

SYNOPSIS
...

[download]

I also tried man Courriel. This was similarly successful.

I've no idea why perldoc reported 'No documentation found for "Courriel".' for you. Does perldoc display documentation for other modules you've installed with cpan? Do you have any better success with man Courriel?

"I've downloaded the tar.gz for it and I've pawed through it and I can't see anything that looks like a .pod or .1 file in it.. so I dunno what to do next."

The POD is included with the .pm file. If you view the source, you'll see near the end: "316 lines of Pod".

As a workaround, you could try: 

$ perl -e 'use Courriel; system perldoc => $INC{"Courriel.pm"}'

[download]

— Ken

In reply to Re^4: Parsing an email by kcott
in thread Parsing an email by BernieC

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.