Manual Reference Pages - NEWS::ARTICLE::NOCEM (3)
News::Article::NoCeM - a module to generate accurate nocem notices
my $nocem = new News::Article::NoCeM();
$nocem->make_notice($type, $name, $issuer, $group, $prefix);
Creates a nocem notice on the Usenet articles, which may be posted
normally to hide the messages.
News::Article::NoCeM is class that inherits News::Article and adds four
new functions: hide(), make_notice(), sign() and issue(),
redefine to disable two functions: post() and ihave().
hide ( TYPE, ARTICLE, [ARTICLE, ...] )
Hide one or more articles in the given TYPE. ARTICLE is an
News::Article object that going to be hid. hide() will skip
the articles without Newsgroup or Message-ID and skip the ones
hide() returns the number of the articles hid.
post() and ihave() is disabled in News::Article::NoCeM.
Please use issue() instead.
make_notice ( TYPE, NAME, GROUP, ISSUER, [ PREFIX ] )
Retrive articles marked by hide with TYPE, and make a notice
fot them. If theres only one type within a container, then the container
itself can be a notice. NAME is the identifier of the issuer. GROUP is
the newsgroup the you will post nocem notice to. ISSUER is the email address
of the issuer. PREFIX is the announcement before the nocem notice, which may
explain the criteria of this notice, or where to find your public key for
make_notice() returns a News::Article::NoCeM object if success, and return undef
if no article is hid.
sign ( KEYID, PASSPHRASE )
Sign the content of the nocem notice with KEYID and PASSPHRASE.
Please make sure that the issuers public/secret keyring is ready.
sign() returns a News::Article::NoCeM object if success, and return undef
if no article is hid, or pgp_sign failed.
issue ( [ CONN, IHAVE ] )
Take optional CONN as a Net::NNTP object and issue the nocem notice.
IHAVE indicates that call Net::NNTP::ihave() for submitting the notice,
otherwise issue() will call News::Article::post() by default.
issue() return the result of News::Article::post() or issue().
Standard article manipulation information can be read in the News::Article
NoCeM FAQ is available on the web at <URL:http://www.cm.org/faq.html>.
Written by Yen-Ming Lee <firstname.lastname@example.org>, based on a module by
Tim Skirvin <email@example.com>.
Copyright 2004-2005 by Yen-Ming Lee <firstname.lastname@example.org>.
This code may be redistributed under the same terms as Perl itself.
|perl v5.20.3 ||NOCEM (3) ||2006-06-23 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.