.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Email::LocalDelivery 3pm"
.TH Email::LocalDelivery 3pm 2024-03-05 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Email::LocalDelivery \- Deliver a piece of email \- simply
.SH VERSION
.IX Header "VERSION"
version 1.201
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 2
\&  use Email::LocalDelivery;
\&  my @delivered_to = Email::LocalDelivery\->deliver($mail, @boxes);
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This module delivers an email to a list of mailboxes.
.PP
\&\fBAchtung!\fR  You might be better off looking at Email::Sender, and at
Email::Sender::Transport::Maildir and Email::Sender::Transport::Mbox.
They are heavily used and more carefully monitored.
.SH "PERL VERSION"
.IX Header "PERL VERSION"
This code is effectively abandonware.  Although releases will sometimes be made
to update contact info or to fix packaging flaws, bug reports will mostly be
ignored.  Feature requests are even more likely to be ignored.  (If someone
takes up maintenance of this code, they will presumably remove this notice.)
This means that whatever version of perl is currently required is unlikely to
change \-\- but also that it might change at any new maintainer's whim.
.SH METHODS
.IX Header "METHODS"
.SS deliver
.IX Subsection "deliver"
This takes an email, as a plain string, and a list of mailboxes to
deliver that mail to. It returns the list of boxes actually written to.
If no boxes are given, it assumes the standard Unix mailbox. (Either
\&\f(CW$ENV{MAIL}\fR, \fI/var/spool/mail/you\fR, \fI/var/mail/you\fR, or
\&\fI~you/Maildir/\fR)
.SH AUTHORS
.IX Header "AUTHORS"
.IP \(bu 4
Simon Cozens
.IP \(bu 4
Casey West <casey@geeknest.com>
.IP \(bu 4
Ricardo Signes <rjbs@semiotic.systems>
.SH CONTRIBUTOR
.IX Header "CONTRIBUTOR"
William Yardley <pep@veggiechinese.net>
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
This software is copyright (c) 2003 by Simon Cozens.
.PP
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.