NAME

TeX::AutoTeX::Mail - email handling for TeX::AutoTeX process messages

DESCRIPTION

Mail routines for TeX::AutoTeX. TeX::AutoTeX can be instructed to mail notification of various failure conditions to specific email addresses.

HISTORY

 AutoTeX automatic TeX processing system
 Copyright (c) 1994-2006 arXiv.org and contributors

 AutoTeX is supplied under the GNU Public License and comes
 with ABSOLUTELY NO WARRANTY; see COPYING for more details.

 AutoTeX is an automatic TeX processing system designed to
 process TeX/LaTeX/AMSTeX/etc source code of papers submitted
 to the arXiv.org (nee xxx.lanl.gov) e-print archive. The
 portable part of this code has been extracted and is made
 available in the hope that it will be useful to other projects
 and that the input of others will benefit arXiv.org.

 Code developed and contributed to by Tanmoy Bhattacharya, Rob
 Hartill, Mark Doyle, Thorsten Schwander, and Simeon Warner.
 Refactored to separate generic code from arXiv.org specific code
 by Stephen Marsh, Michael Fromerth, and Simeon Warner 2005/2006.

 Major cleanups and algorithmic improvements/corrections by
 Thorsten Schwander 2006 - 2011

METHODS

new($identifier)

Instantiates a TeX::AutoTeX::Mail object. The optional $identifier will be used in mail subject lines, which is useful when AutoTeX is deployed for automated processing in a repository context.

send_notification($to, $subject, $message, $reply_to)

Send mail message to the address specified. The parameter names should be self explanatory.

Returns undef on success, error message otherwise.

send_failure($subject, ...)

Convenience method calling send_notification with the configured address for failure messages as recipient.

send_tex_admin($subject, ...)

Convenience method calling send_notification with the configured TeX installation maintainer as delivery address.

DIAGNOSTICS

send_notification() returns undef on success and an informative message on various errors

CONFIGURATION AND ENVIRONMENT

The following configuration variables from TeX::AutoTeX::Config are used

$TEX_ADMIN_ADDRESS

Recipient for specific TeX issues.

$MAIL_FAILURES_ADDRESS

Recipient for processing failures or other error conditions.

$SENDMAIL

Full PATH to the sendmail executable.

DEPENDENCIES

The mail commands opens a pipe into sendmail, and the command syntax used here is tailored with sendmail in mind. Other MTAs may require a different setup.

BUGS AND LIMITATIONS

Please report bugs to www-admin

AUTHOR

See history above. Current maintainer: Thorsten Schwander for arXiv.org

LICENSE AND COPYRIGHT

Copyright (c) 2007 - 2011 arxiv.org http://arxiv.org/help/contact

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.