PerlDoc used in CPAN?--MULTIPOSTED

**********************************************************************
********** PLEASE DO NOT RESPOND TO THIS THREAD ***********
**********************************************************************

This message has been multiposted as indicated by these message IDs:
<1155479132.4...@p79g2000cwp.googlegroups.com>
<1155479132.4...@p79g2000cwp.googlegroups.com>

This is the 1st auto-detected multiposted message by this author.

######################################################################
# TO THE USENET COMMUNITY: This message has been multiposted, which #
# is universally considered rude. Therefore, it is requested that #
# you DO NOT reply to this thread. Doing so only encourages rudeness.#
# #
# NOTE: This "Multipost Detector" has been recently-deployed as a #
# service to the Perl community. Questions or comments are welcome #
# (just reply to this message). See the NAQ at the end of this post. #
######################################################################

######################################################################
# TO THE ORIGINAL POSTER (OP): You have posted a multiposted message.#
# (see below for an explanation of what that is and why it is bad). #
# Many regular participants in technical newsgroups will not respond #
# to a multiposted message if they realize it is multiposted. #
# #
# This thread is therefore (probably) burned (meaning you won't get #
# any helpful replies). If you wish, you may open a new thread which #
# conforms to ordinary standards of usenet etiquette (see below). #
# #
# This is NOT a flame. This is a COURTESY notice to usenet & the OP. #
# Other participants are respectfully requested to NOT flame, ignore #
# or killfile the OP unless s/he persists in multiposting. #
######################################################################

######################################################################
# WHAT IS MULTIPOSTING ? If you post the same question to two (or #
# more) different newsgroups as separate messages (without #
# indicating that you have done so) then you have multiposted. This #
# is NEVER an acceptable practice in usenet. There are two things #
# which will get you killfiled in a hurry--you can flame a respected #
# group participant (like flaming Randal in a Perl group) or you can #
# multipost. These are usenet mortal sins which you should avoid if #
# you wish to have a productive usenet experience. #
# #
# WHY IS MULTIPOSTING RUDE? A question posted in one newsgroup might #
# receive a prompt and expert reply, because some nice person is #
# kind enough to provide this assistance (free of charge). However, #
# if the question is multiposted to another newsgroup, ANOTHER nice #
# person might spend his/her time providing the SAME assistance, #
# unaware that the question has ALREADY been answered elsewhere. #
# This WASTES THE TIME of the second person, who was only trying to #
# be helpful but was actually 'tricked' into wasting his/her time. #
# The second person has NO WAY to know the question was multiposted #
# (and already answered) elsewhere unless s/he happens to visit the #
# other group and notice the multipost (before replying). #
# #
# Most new posters are given the benefit of doubt and are assumed #
# to have violated these conventions due to a lack of understanding. #
# Posters who persist in such behavior, however, will likely be #
# flamed, ignored, and/or killfiled by regular group participants. #
######################################################################

######################################################################
# ABOUT THIS REPLY: This reply was posted by an automated process #
# which scans selected newsgroups for evidence of multiposting. #
# #
# This is a service to the usenet community to let folks know when #
# a message has been multiposted. Many folks prefer not to reply #
# to such messages, but they might do so 'accidentally' because #
# they don't realize the message is multiposted. #
# #
# This reply is also a service to the OP (it is not an attempt to #
# be "mean" to the OP). Hopefully the OP will become more aware of #
# usenet etiquette. Someone who takes offense at helpful correction #
# will probably not have a very satisfying usenet experience. #
######################################################################

######################################################################
# WHEN/HOW IS MULTIPOSTING OK? If you post in one newsgroup #
# but later realize (for whatever reason) that you would prefer to #
# post the message elsewhere, it is OK to do so provided your new #
# message references your original post (preferably with a link). #
# You should also respond to your original post indicating it has #
# been re-posted elsewhere (preferably with a link). This gives both #
# newsgroup communities visibility to the others' work. If you post #
# in this manner, this process will NOT flag it as multiposted. #
######################################################################

######################################################################
# REFERENCES: The following information may be helpful: #
# http://www.faqs.org/faqs/usenet/primer/part1/ #
# http://www.catb.org/~esr/faqs/smart-questions.html #
# http://web.presby.edu/~nnqadmin/nnq/nquote.html #
# http://www.augustmail.com/~tadmc/clpmisc/clpmisc_guidelines.html #
######################################################################

######################################################################
# WHY DOES THIS AUTOMATED PROCESS EXIST? Mainly because of Google #
# Groups. GG has made it very easy for anybody to post anything in #
# usenet (and many GG users don't know much about usenet, and may #
# not even realize they're posting to a worldwide network which has #
# nothing to do with Google). Many folks (especially GG users) are #
# not familiar with usenet etiquette conventions and thus annoy #
# other participants (the very people whom they are asking for help).#
# This is counterproductive to both the OP and the usenet community #
# at large. Posters are encouraged to consult the references above #
# to learn how to ask a good question in a polite manner; doing so #
# is beneficial to everyone (especially the OP). #
######################################################################

######################################################################
# NAQ (the Never Asked Questions - TEMPORARY SECTION) #
# Q-What ruleset defines a multipost? A--Two MD5 digests are #
# calculated (one forwards, one backwards) on the message body #
# and stored in a small database. If a new post (new message ID) #
# matches these digests, it's a multipost. Author and subject #
# lines are not taken into account. Reply messages are ignored. #
# Q-Are crossposts flagged? A--No. A message must have an identical #
# body but a unique message ID to be flagged. A crosspost which is #
# ALSO multiposted, however, will be flagged. I may one-day add #
# the ability to post a much milder message for crossposts between #
# Perl groups (it is rarely, if ever, appropriate to crosspost #
# between similar groups, and such crossposting is discouraged). #
# Q-What groups are scanned? A-The main Perl Groups in Google Groups,#
# namely: comp.lang.perl.misc, perl.beginners, perl.dbi.users, #
# comp.lang.perl.modules , perl.beginners.cgi, and alt.perl #
# Q-You dummy, it's EASY to defeat this scanner! A--Of course it is. #
# But it's rare to see multiposts which differ in the message body.#
# An author who deliberately tweaked the content to defeat a scan #
# reveals his/her deliberately rude intent (& should be killfiled) #
# Q-Why am I doing this? A--For a better usenet. Some folks try to #
# discourage job postings; some discourage off-topic posts. I try #
# to discourage multiposts - that's my little pet peeve (and, #
# unlike OT posts and the like, it's not obvious when it happens) #
# If you don't wish to be bothered with these auto-generated #
# responses, please killfile the scanner. #
# Q-Who wrote this program? A-- I am not trying to keep my identity #
# a big secret (it's easy enough to find out who I am, and group #
# regulars probably recognize my rants). But I choose to run this #
# scanner anonymously because some posters will be determined to #
# take offense at this. If they get mad at me, their anger may #
# spill over into future postings that I participate in. I just #
# get tired of newbies pitching tantrums any time someone offers #
# friendly and helpful correction, so I deny them an easy target. #
# #
# I will reply (under my own handle) to questions or comments #
########
msg_hash: 22 - 734d3325737f0e962b9a66865f90c4d0

> I found there is a PerlDoc comment structure used in CPAN Perl Module.
> And HTML document can be generated automatically from Perl file (like
> NAME, SYNOPSIS, DESCRIPTION...).
>
> Is there any document talk about how to write the comment structure?

Yes - see 'perldoc perlpod'.

> And use what tool to generate the HTML? Thanks!

See 'perldoc pod2html'.

sherm--

--
Web Hosting by West Virginians, for West Virginians: http://wv-www.net
Cocoa programming in Perl: http://camelbones.sourceforge.net

Get bent. I'll reply to whomever I please, and I'll do so in a manner that's
far more constructive and helpful than your self-riteous whine-bot will
*EVER* be.

Yup, I agree, the bot post is more annoying and unreadable then a flame
from a regular.

--
John Bokma Freelance software developer
&
Experienced Perl programmer: http://castleamber.com/

I second that. I won't flame over one signaling multi-posts. But the
bot is annoying. Much more than the multi-post itself. If it doesn't
go away I'll plonk it straight on...

PS: I do understand the good intent, though.

Michele
--
{$_=pack'B8'x25,unpack'A8'x32,$a^=sub{pop^pop}->(map substr
(($a||=join'',map--$|x$_,(unpack'w',unpack'u','G^<R<Y]*YB='
.'KYU;*EVH[.FHF2W+#"\Z*5TI/ER<Z`S(G.DZZ9OX0Z')=~/./g)x2,$_,
256),7,249);s/[^\w,]/ /g;$ \=/^J/?$/:"\r";print,redo}#JAPH,

Is this suppose to be irony? The message IDs are identical. The OP DID
cross post, but this idiotic bot MULTIPOSTED. And why the hell didn't
it detect its own multiposting?

And by that you mean that everyone who's replied to your various
tirades about Multiposting has disagreed with you? Everything from
"multiposting to p.b and c.l.p.m should be okay" to "instruct the OP,
yes, but burn the thread, no."?

And how does not posting your address here prevent that, since, as you
said, all the "regulars" already know who you are?

Paul Lalli

There is much that is annoying about the bot (in particular David's
intimation that he knows best where the thread should be answered). If
he were to remove all the junk and simply indicate where the other
posts have gone so that responses can be set accordingly it might not
be so bad, though.

Matt

Yeah, I tested the ever living heck out of this thing (see
alt.test.test, alt.test.test2, and alt.test.testing). But, during
testing, I commented out this line (as a test case):

next MSGNUM if @threads == 1; #ignore plain crossposts

And I forgot to un-comment it. I feel totally stupid.

Because it ignores any message with a "References" header.

DF> > If they get mad at me, their anger may
DF> > # spill over into future postings that I participate in.

An OP who gets flagged in a future post can do a historical search on
the message (or search in the testing newsgroups) and determine my
identity (and that's fine). But I doubt many OPs would think to do
that.

If you wish to reply regarding this topic, I respectfully ask that you
do so in the new thread (and quote context so folks can follow along).

--
David Filmer (http://DavidFilmer.com)

I am who do the multipost, sorry for the inconvenience!

I have read the bot information thoroughly, and have three solutions.

[1] Idea from email's "CC". Partition target forum to "primary forum"
and "not primary forum". When we multipost, we must choose only one
"primary forum" and several "not primary forum". When someone reply on
"not primary forum", the post will be post to the "primary forum" but
can be show on all the "not primary forum". Is it possible in
techniques?

[2] When the person who reply the multipost, he can choose to reply to
all the multipost forums (all follower can view his post, and I prefer
that) or only reply to the forum he choose.

[3] When multipost, the system add a tag to the source post and show
where post is multiposted.

Any discussions are welcome!
Davy

You did not mulitpost, and you have nothing to apologize for. David's
bot has a bug, in that it detected your crosspost as a multipost.

Paul Lalli

You didn't actually multipost - you crossposted. My bot mis-identified
your post as a multipost because of a mistake on my part which happened
when I did some testing (I'm very sorry about that, and I've fixed the
problem).

However, you should also be aware that crossposting to similar
newsgroups is also frowned upon (see
http://www.cs.tut.fi/~jkorpela/usenet/xpost.html). It's not as bad as
multiposting, but its usually a good idea to pick a "primary group"
only (if you are not sure which one to post to, it's good to browse
around and lurk a bit to see the types of topics and the level of
participation and expertise).

You got caught up in quite a storm here that really has nothing to do
with your post - that was not what I expected. I was quite surprised at
the level of interest in this (and another) thread.

I have established another thread for ongoing discussions about this
whole multipost-bot thing which is OT to your post but which has been
the subject of most of the replies (which is also poor nettiquite on
our part - sorry). Hopefully folks will leave your thread alone now.

You are speaking of making changes to "the interface" to "the system", but
usenet is not a single system, nor does it have a single interface. It's a
distributed network of servers, accessed by way of many client applications,
one of which happens to be the web-based interface provided by Google.

^^^^^^
^^^^^^
>where post is multiposted.

Note: this is USENET. It is not a "forum", which is a term rather
applied to web-based comminities. There are standars, precisely in the
nntp protocol. Clients do, of course, comply. But much is still in
their control. Of course you can trim the list of ng's you're replying
(or better: following up) to. One can set up Followup-To, too. I
*think* it's possible to set up additional headers, but then clients
should coordinate on their semantic meaning, which is not something
feasible. Etc. (More knowledgeable people will... know better!)

All in all there's not a "system". *The* system is compound of servers
and clients, and standars for them to communicate.