News::Article::NoCeM (3pm)

  use News::Article::NoCeM;
  my $nocem = new News::Article::NoCeM();

  $nocem->hide($type, $spam);
  $nocem->make_notice($type, $name, $issuer, $group, $prefix);
  $nocem->sign($keyid, $passphrase);
  $nocem->issue($conn, $ihave);

Creates a nocem notice on the Usenet articles, which may be posted normally to hide the messages.

use News::Article::NoCeM;

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().

Article Methods

hide ( \s-1TYPE\s0, \s-1ARTICLE\s0, [\s-1ARTICLE\s0, ...] )

Hide one or more articles in the given \*(C`TYPE\*(C'. \*(C`ARTICLE\*(C' is an News::Article object that going to be hid. hide() will skip the articles without Newsgroup or Message-ID and skip the ones already hid. hide() returns the number of the articles hid.

post

ihave

post() and ihave() is disabled in News::Article::NoCeM. Please use issue() instead.

make_notice ( \s-1TYPE\s0, \s-1NAME\s0, \s-1GROUP\s0, \s-1ISSUER\s0, [ \s-1PREFIX\s0 ] )

Retrive articles marked by hide with \*(C`TYPE\*(C', and make a notice fot them. If there's only one type within a container, then the container itself can be a notice. \*(C`NAME\*(C' is the identifier of the issuer. \*(C`GROUP\*(C' is the newsgroup the you will post nocem notice to. \*(C`ISSUER\*(C' is the email address of the issuer. \*(C`PREFIX\*(C' is the announcement before the nocem notice, which may explain the criteria of this notice, or where to find your public key for \s-1PGP\s0 verification. make_notice() returns a News::Article::NoCeM object if success, and return undef if no article is hid.

sign ( \s-1KEYID\s0, \s-1PASSPHRASE\s0 )

Sign the content of the nocem notice with \*(C`KEYID\*(C' and \*(C`PASSPHRASE\*(C'. Please make sure that the issuer's 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 ( [ \s-1CONN\s0, \s-1IHAVE\s0 ] )

Take optional \*(C`CONN\*(C' as a Net::NNTP object and issue the nocem notice. \*(C`IHAVE\*(C' 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 manpages.

NoCeM \s-1FAQ\s0 is available on the web at <URL:http://www.cm.org/faq.html>.

Written by Yen-Ming Lee <[email protected]>, based on a module by Tim Skirvin <[email protected]>.

Copyright 2004-2005 by Yen-Ming Lee <[email protected]>. This code may be redistributed under the same terms as Perl itself.