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
...
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
I successfully checked that I could load the module:
$ perl -e 'use Courriel'
I then tried perldoc Courriel:
NAME
Courriel - High level email parsing and manipulation
VERSION
version 0.49
SYNOPSIS
...
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"}'
|