README
1News::Article - Object for handling Usenet articles in mail or news form.
2
3 Copyright 1997 by Andrew Gierth <andrew@erlenstar.demon.co.uk>.
4 All rights reserved.
5 This program is free software; you may redistribute it and/or
6 modify it under the same terms as Perl itself.
7
8MODULES
9
10 News::Article
11 News::AutoReply
12 News::FormArticle
13 News::FormReply
14
15STATUS
16
17 This release is considered reasonably stable, both in functionality
18 and interface.
19
20INTRODUCTION
21
22 This module originated with the development of the software intended
23 to handle newsgroup creation for the (new) mod.* Usenet hierarchy.
24 The requirement to centralise, and fully automate, the process of
25 group creation and the detection of defunct groups led to a large
26 number of cases where the software would be required to read, parse,
27 forward, reply to, mail and post articles of various forms.
28
29 Therefore, this module allows for creating articles from scratch, or
30 reading them from various data sources; various header
31 manipulations, and posting via NNTP or mailing via a
32 sendmail-workalike.
33
34 Support is included for PGPMoose v1.1-compatible signatures, and
35 also for control-message signatures believed to be compatible with
36 current distributions of signcontrol and pgpverify.
37
38 FormArticle is a derivative, intended for the construction of news
39 articles (or mail messages) by substitutions into boilerplate text.
40 AutoReply and FormReply are additional (very simple) derivatives.
41
42REQUIREMENTS
43
44 This probably won't work except on Unix or a very good imitation.
45
46 Net::Domain
47 Net::NNTP
48 PGP::Sign
49
50 (It would be nice to weaken these dependencies somewhat.)
51
52 Mailing articles requires a sendmail-workalike (normally
53 /usr/lib/sendmail or /usr/sbin/sendmail).
54
55INSTALLATION
56
57 Review the "System Dependent Configuration" section near the
58 beginning of Article.pm. If it would fail to find a working sendmail
59 on your system, and you care, then fix it as necessary.
60
61 Then follow the standard installation procedure for Perl modules,
62 which is to type the following commands:
63
64 perl Makefile.PL
65 make
66 make install
67
68 You'll probably need to do the last as root. A testsuite (though not
69 an extensive one yet) is supplied.
70
71THANKS
72
73 Thanks to Russ Allbery <rra@stanford.edu> for comment and
74 significant contributions.
75
76AUTHOR
77
78 Andrew Gierth <andrew@erlenstar.demon.co.uk>
79
80AVAILABILITY
81
82 CPAN, or see http://www.erlenstar.demon.co.uk/perl
83
84END
85