[28533] in Perl-Users-Digest
Perl-Users Digest, Issue: 9897 Volume: 10
daemon@ATHENA.MIT.EDU (Perl-Users Digest)
Fri Oct 27 09:05:52 2006
Date: Fri, 27 Oct 2006 06:05:04 -0700 (PDT)
From: Perl-Users Digest <Perl-Users-Request@ruby.OCE.ORST.EDU>
To: Perl-Users@ruby.OCE.ORST.EDU (Perl-Users Digest)
Perl-Users Digest Fri, 27 Oct 2006 Volume: 10 Number: 9897
Today's topics:
Re: ActiveState Perl crashs, why ? <someone@somewhere.none>
ANNOUNCE: new module: Mail::SendVarious ((null))
ANNOUNCE: new module: Qpsmtpd::Plugin::Quarantine ((null))
Posting Guidelines for comp.lang.perl.misc ($Revision: tadmc@augustmail.com
Digest Administrivia (Last modified: 6 Apr 01) (Perl-Users-Digest Admin)
----------------------------------------------------------------------
Date: Fri, 27 Oct 2006 13:35:18 +0200
From: "perl" <someone@somewhere.none>
Subject: Re: ActiveState Perl crashs, why ?
Message-Id: <ehsqrk$qat$1@online.de>
> >The error message i got is the typical
> >popup window (translated from german):
> >perl.exe caused an error an will be closed.
>
> Ouch. That sounds bad.
>
> I think LWP is pure perl, otherwise I'd first think of an incompatible
> DLL from a module somewhere.
>
> Can you reproduce it, or not reproduce it, with other modules?
I had the same kind of crash with XML:Twig. I first thought i was writing
really bad code, but i got suspicious when it also happend with LWP.
I cannot reproduce it anymore, since i solved the problem.
------------------------------
Date: Fri, 27 Oct 2006 03:08:31 GMT
From: muir@idiom.com ((null))
Subject: ANNOUNCE: new module: Mail::SendVarious
Message-Id: <J7sEtH.DoA@zorch.sf-bay.org>
Newly release on cpan...
NAME
Mail::SendVarious - send mail via STMP and sendmail
SYNOPSIS
use Mail::SendVarious;
sendmail(
from => 'user@host',
From => 'First Last',
to => 'user@host, user@host',
cc => 'user@host, user@host',
xheader => 'Some header stuff',
body => 'Some body stuff here'
);
sendmail(
envelope_to => 'user@host, user@host',
message => 'Complete header and body stuff',
);
sendmail(
envelope_to => 'user@host, user@host',
header => 'Complete header stuff',
body => 'Complete body stuff',
);
use Mail::SendVarious qw(make_message);
($from, $message, @envelope_to) = make_message(%args);
DESCRIPTION
Mail::SendVarious will try to send mail multiple ways. First it tries
via SMTP. If that doesn't work then it tries using "/usr/sbin/sendmail".
The "sendmail()" function can put together a message header or it you
can hand it one. Here are the options it can take:
envelope_from Sets the sender email address. If creating a header, also
sets the email address in the "From:" header if there is
no "from" option.
from Sets the envelope sender email address if "envelope_from"
isn't set. If creating a header, also sets the email
address in the "From:" header.
From Set the name over the sender in the "From:" header.
envelope_to Sets who the message is sent to.
to Sets the "To:" header. Also sets who the message is sent
to if "envelope_to" isn't set.
cc Sets the "Cc:" header. Also adds who the message is sent
to if "envelope_to" isn't set.
bcc Adds to who the message is sent to.
subject Specifies the "Subject:" header.
xheader Specifies extra header lines to be added if a header is
generated.
header Specifies the complete message header. "xheader" will be
ignored. No "To:", "From:", "Cc:" or "Subject:" header
will be generated.
body Specifies the complete message body.
message Specifies the complete message. "header" and "body"
arguments will be ignored. No "To:", "From:", "Cc:" or
"Subject:" header will be generated.
build_header Specifies if a header should be generated with "To:",
"From:", "Cc:" and "Subject:". This overrides what what
otherwise might happen.
debuglogger Specifies a function to call for debug output. If not
set, no debug output is generated.
errorlogger Specifies a function to call for error output. If not
set, errors are reported on "STDERR".
hostlist Specifies a list of hosts to try to send to via SMTP.
This should be an array refrence. If not set,
@Mail::SendVarious::mail_hostlist is used. The default
for @Mail::SendVarious::mail_hostlist is 127.0.0.1.
mail_command Specifies a command to use if sending via SMTP fails.
This should be an array refrence. If not set,
@Mail::SendVarious::mail_command is used. The default for
@Mail::SendVarious::mail_command is "/usr/sbin/sendmail
-oeml -i".
no_rejects Normally when sending via SMTP, Mail::SendVarious will
skip over any recipients that are rejected. Sent
"no_rejects" and the SMTP server will be skipped instead.
If "no_rejects" is not set, then any rejected recipients
will end up in @Mail::SendVarious::to_rejected.
The return value from "sendmail()" is true if the message was sent and
false otherwise. If the message was not sent, then the variable
"Mail::SendVarious::mail_error" will be set to a description of the
problem.
EXPORT_OK
In addition to the standard export item of the "sendmail()" function,
the following are available explicitly:
$mail_error The last error.
make_message() An additional function "make_message()" is provided. It
takes the same arguemtns as "sendmail()" but does not
send mail. It just generates the message.
The following two snippets do the same thing:
{
my ($from, $message, @envelope_to) = make_message(%args);
sendmail(
envelope_from => $from,
envelope_to => \@envelope_to,
message => $message,
);
}
and
sendmail(%args);
@to_rejected Any recipients that were rejected by the SMTP server.
(Only if "no_rejects" isn't set).
@mail_hostlist "(qw(127.0.0.1))"
@mail_command "(qw(/usr/sbin/sendmail -oeml -i))"
OTHER MODULES THAT DO SIMILAR THINGS
Send mail via SMTP: Mail::SMI, Mail::Transport::SMTP, Mail::SendEasy,
Mail::Sender, Mail::Send, Mail::Sendmail.
Send mail via /usr/sbin/sendmail: Mail::Transport::Sendmail.
Send via various methods (but only one at a time): Mail::Mailer.
Manage an outgoing mail spool: Mail::Spool.
AUTHOR
Copyright (C) 2002-2006, David Muir Sharnoff <muir@idiom.com> This
module may be used and copied on the same terms as Perl itself.
--
------------------------------
Date: Fri, 27 Oct 2006 03:05:52 GMT
From: muir@idiom.com ((null))
Subject: ANNOUNCE: new module: Qpsmtpd::Plugin::Quarantine
Message-Id: <J7sEt9.DnJ@zorch.sf-bay.org>
Newly released and available on CPAN...
NAME
Qpsmtpd::Plugin::Quarantine - filter outbound email to prevent blacklisting
SYNOPSIS
Qpsmtpd quarantine plugin:
use Qpsmtpd::Plugin::Quarantine;
The quarantine.cgi web page:
use Qpsmtpd::Plugin::Quarantine::CGI;
main();
In crontab or nightly:
perl -MQpsmtpd::Plugin::Quarantine::Batch -e 'cronjob()'
In crontab (every five minutes?):
perl -MQpsmtpd::Plugin::Quarantine::Batch -e 'sendqueued()'
From the command line:
perl -MQpsmtpd::Plugin::Quarantine::Batch -e 'mailq()'
DESCRIPTION
Qpsmtpd::Plugin::Quarantine implements and outbound mail filter. A
substantial number of internet sites will blacklist senders if they send
too much spam. Most will do this without providing enough feedback for
you (the sender) to figure out where the spam is coming from or why you
were blacklisted.
I run ISPs and I've been blacklisted by AOL. I've been blacklisted by
Comcast. Why? Sometimes its because someone is exploting an insecure
formmail CGI on my system and sometimes its simply because I allow users
to forward email and when they do, they end up forwarding spam.
Qpsmtpd::Plugin::Quarantine understands that sometimes the sender is the
victim and sometimes not. The normal situation is that
Qpsmtpd::Plugin::Quarantine will bounce things that it thinks are spammy
back to the sender with a URL to allow the sender to push the message
onwards. However if the particular recipient is on an override list or
is very popular (maybe because someone is forwarding their mail to the
recipient or maybe they're on a mailing list) then instead of bouncing
to the sender, it will send a note to the recipient letting them know
there is a message waiting for them.
Qpsmtpd::Plugin::Quarantine will only send bounces or notifications
every so often (configurable). Both senders and recipients have the
option (via the website) to have their mail silently discarded so that
they don't get bothered again.
Qpsmtpd::Plugin::Quarantine uses OOPS to store it's persistent data in
mysql or PostgreSQL.
INSTALATION
Qpsmtpd::Plugin::Quarantine is a Qpsmtpd plugin and a web page and a
shell command and cron jobs. Installation will require some work.
Start with the standard "perl Makefile.PL" and "make install".
Prerequisites
Install Qpsmtpd. I reccomend using it with postfix. Qpsmtpd should be
the main SMTP listener. It will become your smarthost for your other
mail servers. You can relegate postfix to just handling local mail by
adding "inet_interfaces = 127.0.0.1" to it's "main.cf".
Install mysql or PostgreSQL. Provide the DBI_DSN in either
/etc/default/qpsmtpd-quarantine.pl or the Qpsmtpd plugins file (below).
Qpsmtpd plugin
Installing the Qpsmtpd plugin is easy. Create a file,
"/usr/share/qpsmtpd/plugins/quarantine" (or wherever they are) with the
following contents:
use Qpsmtpd::Plugin::Quarantine;
That's it.
In "/etc/qpsmtpd/plugins", create an entry:
#
# quarantine
#
# All of these may be set in the /etc/default/qpsmtpd-quarantine.pl. The defaults
# for these may be found in the Qpsmtpd::Plugin::Quarantine::Common module. More
# things to set can be found there too.
#
# dbi_dsn database DSN (eg: DBI:mysql:database=quarantine;host=localhost)
# username database username
# password database password
# baseurl URL of quarantine.cgi
# templates templates directory for email & web
# send_from Email address notifications are sent from
# renotify_recipient_days How often should recipients be re-notified of mail waiting (days)
# renotify_sender_ip On a per-sending-IP basis, how often should senders be renotified (days)
# notify_other_senders Should non-local senders be notified at all?
# notify_recipients How many messages should a recipient get before we prefer to notify
# the recipeint instead of the sender. Disable most sender
# notifications if 0.
# notify_recipient_only DB hash file of recipients we notify in preference to senders
#
quarantine
This should come before the Queue/delivery plugins like
"queue/postfix-queue".
/etc/default/qpsmtpd-quarantine.pl
Create a perl file, "/etc/default/qpsmtpd-quarantine.pl" to override the
defaults that can be found in the first part of the
"Qpsmtpd::Plugin::Quarantine::Common" module.
For example:
package Foobar;
use Qpsmtpd::Plugin::Quarantine::Common qw(%base_defaults);
$base_defaults{send_from} = 'quarantine-sender@out-limit.internet-mail-service.net';
/etc/qpsmtpd/recipient.special.db (optional)
This file is a Berkeley DB HASH file that should contain the email
addresses of everywhere that mail is sent on a regualar basis due to
forwarding. When these addresses are used as recipients, the recipient
will be notified in preference to the sender. Collect up all addresses
from ".forward" files, ".procmailrc" and "/etc/aliases" files from your
sytems. Dump them into a file and turn them into a DB HASH. With
postfix, this is done with the "postmap
hash:/etc/qpsmtpd/recipient.special" command.
/etc/qpsmtpd/sender.special.db (optional)
This file is a Berkeley DB HASH file that should contain the email
addresses of senders that trigger spam checking. Unless the config
parameter "check_all_recipients" is set, we won't spam-check all
messsages. This database is the set of senders which trigger a forced
spam check.
/etc/qpsmtpd/filter_domains
This file lists the domains (one per line) that we want to avoid sending
spam to. This should include AOL (aol.com aim.com cs.com netscape.net)
and Comcast (comcast.com comcast.net) at a bare minimum. This file is
required. Do not include the entire Internet (.com .net .org) as
recipients need to provide a an address that isn't in the list in order
to get their mail forwarded.
/etc/qpsmtpd/our_domains
This file lists the domains that we receive mail as. Depending on other
configuration options, we'll only bounce back to senders that are in
this list.
/etc/qpsmtpd/our_networks
This file lists the IP addresses that make up our network. Most standard
notations are recognized (eg: "216.240.40.0/25"). Depending on other
configuration options, we'll only bounce back to senders that are in
this list.
/etc/qpsmtpd/ignore_networks
Qpsmtpd::Plugin::Quarantine has a notion of what's an internal IP
address (our_networks) and what is an external IP address. This file
lists IP addresses that are neither. The list starts out with the
non-routables.
quarantine.cgi
Create a CGI somewhere. It's a very simple program:
use Qpsmtpd::Plugin::Quarantine::CGI;
main();
The URL for the CGI needs to be configured as "baseurl" in your choice
of config files.
Alternatively, you can set this up using mod_perl. Apache::Registry
provides what is needed to hook it in. The CGI remains the same.
/etc/qpsmtpd/quarantine-templates
Copy the "example-templates" directory to
"/etc/qpsmtpd/quarantine-templates". Modify as you like. All should work
as-is.
/etc/qpsmtpd/quarantine.access
This is a htpasswd-style password file that controls access to the admin
web page. Create it with "htpasswd -c /etc/qpsmtpd/quarantine.access
adminuser".
Cron jobs
Install two cron jobs:
7 7 * * * perl -MQpsmtpd::Plugin::Quarantine::Batch -e cronjob
*/10 * * * * perl -MQpsmtpd::Plugin::Quarantine::Batch -e sendqueued
Starting it up.
To fire it up, send a spammy message to a user at one of the filtered
domains. The main database will auto-initialize.
ADMINISTRATION
There is a admin web page for looking at senders and recipients. The URL
is "baseurl"/admin. Cookies must be enabled.
Qpsmtpd::Plugin::Quarantine has an internal mail queue. The following
command will dispay what's in it. Messages in quarantine are not in the
mail queue.
perl -MQpsmtpd::Plugin::Quarantine::Batch -e mailq
DEVELOPMENT STATUS
This is green code, just put into production by its author.
THANK THE AUTHOR
You can thank the author of this code by giving the author a chance to
sell you services. Either perl programming or Internet-related services
like Transit T1s, T3s, OC3s, etc. Additionally, the author is
considering offering this outgoing spam filter as a service.
Perl programming rates vary from $50/hr (working at home on something
open source that the author wanted to build anyway) to $500/hr (working
on-site in a different time zone on something proprietary).
The author runs multiple ISPs and has acess to very good pricing for
T1s, T3s, OC3s, wholesale DSL, and wholesale dialup. Please send
requests for quotes to: quarantine-rfq@trust.idiom.com.
LICENSE
This software is available with and without the GPL: please write if you
need a non-GPL license. All submissions of patches must come with a
copyright grant so that David Sharnoff remains able to change the
license at will.
Copyright(C) 2006 David Muir Sharnoff <muir@idiom.com>
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
--
------------------------------
Date: 27 Oct 2006 07:10:23 GMT
From: tadmc@augustmail.com
Subject: Posting Guidelines for comp.lang.perl.misc ($Revision: 1.7 $)
Message-Id: <4541b0de$0$81349$ae4e5890@news.nationwide.net>
Outline
Before posting to comp.lang.perl.misc
Must
- Check the Perl Frequently Asked Questions (FAQ)
- Check the other standard Perl docs (*.pod)
Really Really Should
- Lurk for a while before posting
- Search a Usenet archive
If You Like
- Check Other Resources
Posting to comp.lang.perl.misc
Is there a better place to ask your question?
- Question should be about Perl, not about the application area
How to participate (post) in the clpmisc community
- Carefully choose the contents of your Subject header
- Use an effective followup style
- Speak Perl rather than English, when possible
- Ask perl to help you
- Do not re-type Perl code
- Provide enough information
- Do not provide too much information
- Do not post binaries, HTML, or MIME
Social faux pas to avoid
- Asking a Frequently Asked Question
- Asking a question easily answered by a cursory doc search
- Asking for emailed answers
- Beware of saying "doesn't work"
- Sending a "stealth" Cc copy
Be extra cautious when you get upset
- Count to ten before composing a followup when you are upset
- Count to ten after composing and before posting when you are upset
-----------------------------------------------------------------
Posting Guidelines for comp.lang.perl.misc ($Revision: 1.7 $)
This newsgroup, commonly called clpmisc, is a technical newsgroup
intended to be used for discussion of Perl related issues (except job
postings), whether it be comments or questions.
As you would expect, clpmisc discussions are usually very technical in
nature and there are conventions for conduct in technical newsgroups
going somewhat beyond those in non-technical newsgroups.
The article at:
http://www.catb.org/~esr/faqs/smart-questions.html
describes how to get answers from technical people in general.
This article describes things that you should, and should not, do to
increase your chances of getting an answer to your Perl question. It is
available in POD, HTML and plain text formats at:
http://www.augustmail.com/~tadmc/clpmisc.shtml
For more information about netiquette in general, see the "Netiquette
Guidelines" at:
http://andrew2.andrew.cmu.edu/rfc/rfc1855.html
A note to newsgroup "regulars":
Do not use these guidelines as a "license to flame" or other
meanness. It is possible that a poster is unaware of things
discussed here. Give them the benefit of the doubt, and just
help them learn how to post, rather than assume that they do
know and are being the "bad kind" of Lazy.
A note about technical terms used here:
In this document, we use words like "must" and "should" as
they're used in technical conversation (such as you will
encounter in this newsgroup). When we say that you *must* do
something, we mean that if you don't do that something, then
it's unlikely that you will benefit much from this group.
We're not bossing you around; we're making the point without
lots of words.
Do *NOT* send email to the maintainer of these guidelines. It will be
discarded unread. The guidelines belong to the newsgroup so all
discussion should appear in the newsgroup. I am just the secretary that
writes down the consensus of the group.
Before posting to comp.lang.perl.misc
Must
This section describes things that you *must* do before posting to
clpmisc, in order to maximize your chances of getting meaningful replies
to your inquiry and to avoid getting flamed for being lazy and trying to
have others do your work.
The perl distribution includes documentation that is copied to your hard
drive when you install perl. Also installed is a program for looking
things up in that (and other) documentation named 'perldoc'.
You should either find out where the docs got installed on your system,
or use perldoc to find them for you. Type "perldoc perldoc" to learn how
to use perldoc itself. Type "perldoc perl" to start reading Perl's
standard documentation.
Check the Perl Frequently Asked Questions (FAQ)
Checking the FAQ before posting is required in Big 8 newsgroups in
general, there is nothing clpmisc-specific about this requirement.
You are expected to do this in nearly all newsgroups.
You can use the "-q" switch with perldoc to do a word search of the
questions in the Perl FAQs.
Check the other standard Perl docs (*.pod)
The perl distribution comes with much more documentation than is
available for most other newsgroups, so in clpmisc you should also
see if you can find an answer in the other (non-FAQ) standard docs
before posting.
It is *not* required, or even expected, that you actually *read* all of
Perl's standard docs, only that you spend a few minutes searching them
before posting.
Try doing a word-search in the standard docs for some words/phrases
taken from your problem statement or from your very carefully worded
"Subject:" header.
Really Really Should
This section describes things that you *really should* do before posting
to clpmisc.
Lurk for a while before posting
This is very important and expected in all newsgroups. Lurking means
to monitor a newsgroup for a period to become familiar with local
customs. Each newsgroup has specific customs and rituals. Knowing
these before you participate will help avoid embarrassing social
situations. Consider yourself to be a foreigner at first!
Search a Usenet archive
There are tens of thousands of Perl programmers. It is very likely
that your question has already been asked (and answered). See if you
can find where it has already been answered.
One such searchable archive is:
http://groups.google.com/advanced_group_search
If You Like
This section describes things that you *can* do before posting to
clpmisc.
Check Other Resources
You may want to check in books or on web sites to see if you can
find the answer to your question.
But you need to consider the source of such information: there are a
lot of very poor Perl books and web sites, and several good ones
too, of course.
Posting to comp.lang.perl.misc
There can be 200 messages in clpmisc in a single day. Nobody is going to
read every article. They must decide somehow which articles they are
going to read, and which they will skip.
Your post is in competition with 199 other posts. You need to "win"
before a person who can help you will even read your question.
These sections describe how you can help keep your article from being
one of the "skipped" ones.
Is there a better place to ask your question?
Question should be about Perl, not about the application area
It can be difficult to separate out where your problem really is,
but you should make a conscious effort to post to the most
applicable newsgroup. That is, after all, where you are the most
likely to find the people who know how to answer your question.
Being able to "partition" a problem is an essential skill for
effectively troubleshooting programming problems. If you don't get
that right, you end up looking for answers in the wrong places.
It should be understood that you may not know that the root of your
problem is not Perl-related (the two most frequent ones are CGI and
Operating System related), so off-topic postings will happen from
time to time. Be gracious when someone helps you find a better place
to ask your question by pointing you to a more applicable newsgroup.
How to participate (post) in the clpmisc community
Carefully choose the contents of your Subject header
You have 40 precious characters of Subject to win out and be one of
the posts that gets read. Don't waste them. Take care while
composing them, they are the key that opens the door to getting an
answer.
Spend them indicating what aspect of Perl others will find if they
should decide to read your article.
Do not spend them indicating "experience level" (guru, newbie...).
Do not spend them pleading (please read, urgent, help!...).
Do not spend them on non-Subjects (Perl question, one-word
Subject...)
For more information on choosing a Subject see "Choosing Good
Subject Lines":
http://www.cpan.org/authors/id/D/DM/DMR/subjects.post
Part of the beauty of newsgroup dynamics, is that you can contribute
to the community with your very first post! If your choice of
Subject leads a fellow Perler to find the thread you are starting,
then even asking a question helps us all.
Use an effective followup style
When composing a followup, quote only enough text to establish the
context for the comments that you will add. Always indicate who
wrote the quoted material. Never quote an entire article. Never
quote a .signature (unless that is what you are commenting on).
Intersperse your comments *following* each section of quoted text to
which they relate. Unappreciated followup styles are referred to as
"top-posting", "Jeopardy" (because the answer comes before the
question), or "TOFU" (Text Over, Fullquote Under).
Reversing the chronology of the dialog makes it much harder to
understand (some folks won't even read it if written in that style).
For more information on quoting style, see:
http://web.presby.edu/~nnqadmin/nnq/nquote.html
Speak Perl rather than English, when possible
Perl is much more precise than natural language. Saying it in Perl
instead will avoid misunderstanding your question or problem.
Do not say: I have variable with "foo\tbar" in it.
Instead say: I have $var = "foo\tbar", or I have $var = 'foo\tbar',
or I have $var = <DATA> (and show the data line).
Ask perl to help you
You can ask perl itself to help you find common programming mistakes
by doing two things: enable warnings (perldoc warnings) and enable
"strict"ures (perldoc strict).
You should not bother the hundreds/thousands of readers of the
newsgroup without first seeing if a machine can help you find your
problem. It is demeaning to be asked to do the work of a machine. It
will annoy the readers of your article.
You can look up any of the messages that perl might issue to find
out what the message means and how to resolve the potential mistake
(perldoc perldiag). If you would like perl to look them up for you,
you can put "use diagnostics;" near the top of your program.
Do not re-type Perl code
Use copy/paste or your editor's "import" function rather than
attempting to type in your code. If you make a typo you will get
followups about your typos instead of about the question you are
trying to get answered.
Provide enough information
If you do the things in this item, you will have an Extremely Good
chance of getting people to try and help you with your problem!
These features are a really big bonus toward your question winning
out over all of the other posts that you are competing with.
First make a short (less than 20-30 lines) and *complete* program
that illustrates the problem you are having. People should be able
to run your program by copy/pasting the code from your article. (You
will find that doing this step very often reveals your problem
directly. Leading to an answer much more quickly and reliably than
posting to Usenet.)
Describe *precisely* the input to your program. Also provide example
input data for your program. If you need to show file input, use the
__DATA__ token (perldata.pod) to provide the file contents inside of
your Perl program.
Show the output (including the verbatim text of any messages) of
your program.
Describe how you want the output to be different from what you are
getting.
If you have no idea at all of how to code up your situation, be sure
to at least describe the 2 things that you *do* know: input and
desired output.
Do not provide too much information
Do not just post your entire program for debugging. Most especially
do not post someone *else's* entire program.
Do not post binaries, HTML, or MIME
clpmisc is a text only newsgroup. If you have images or binaries
that explain your question, put them in a publically accessible
place (like a Web server) and provide a pointer to that location. If
you include code, cut and paste it directly in the message body.
Don't attach anything to the message. Don't post vcards or HTML.
Many people (and even some Usenet servers) will automatically filter
out such messages. Many people will not be able to easily read your
post. Plain text is something everyone can read.
Social faux pas to avoid
The first two below are symptoms of lots of FAQ asking here in clpmisc.
It happens so often that folks will assume that it is happening yet
again. If you have looked but not found, or found but didn't understand
the docs, say so in your article.
Asking a Frequently Asked Question
It should be understood that you may have missed the applicable FAQ
when you checked, which is not a big deal. But if the Frequently
Asked Question is worded similar to your question, folks will assume
that you did not look at all. Don't become indignant at pointers to
the FAQ, particularly if it solves your problem.
Asking a question easily answered by a cursory doc search
If folks think you have not even tried the obvious step of reading
the docs applicable to your problem, they are likely to become
annoyed.
If you are flamed for not checking when you *did* check, then just
shrug it off (and take the answer that you got).
Asking for emailed answers
Emailed answers benefit one person. Posted answers benefit the
entire community. If folks can take the time to answer your
question, then you can take the time to go get the answer in the
same place where you asked the question.
It is OK to ask for a *copy* of the answer to be emailed, but many
will ignore such requests anyway. If you munge your address, you
should never expect (or ask) to get email in response to a Usenet
post.
Ask the question here, get the answer here (maybe).
Beware of saying "doesn't work"
This is a "red flag" phrase. If you find yourself writing that,
pause and see if you can't describe what is not working without
saying "doesn't work". That is, describe how it is not what you
want.
Sending a "stealth" Cc copy
A "stealth Cc" is when you both email and post a reply without
indicating *in the body* that you are doing so.
Be extra cautious when you get upset
Count to ten before composing a followup when you are upset
This is recommended in all Usenet newsgroups. Here in clpmisc, most
flaming sub-threads are not about any feature of Perl at all! They
are most often for what was seen as a breach of netiquette. If you
have lurked for a bit, then you will know what is expected and won't
make such posts in the first place.
But if you get upset, wait a while before writing your followup. I
recommend waiting at least 30 minutes.
Count to ten after composing and before posting when you are upset
After you have written your followup, wait *another* 30 minutes
before committing yourself by posting it. You cannot take it back
once it has been said.
AUTHOR
Tad McClellan <tadmc@augustmail.com> and many others on the
comp.lang.perl.misc newsgroup.
------------------------------
Date: 6 Apr 2001 21:33:47 GMT (Last modified)
From: Perl-Users-Request@ruby.oce.orst.edu (Perl-Users-Digest Admin)
Subject: Digest Administrivia (Last modified: 6 Apr 01)
Message-Id: <null>
Administrivia:
#The Perl-Users Digest is a retransmission of the USENET newsgroup
#comp.lang.perl.misc. For subscription or unsubscription requests, send
#the single line:
#
# subscribe perl-users
#or:
# unsubscribe perl-users
#
#to almanac@ruby.oce.orst.edu.
NOTE: due to the current flood of worm email banging on ruby, the smtp
server on ruby has been shut off until further notice.
To submit articles to comp.lang.perl.announce, send your article to
clpa@perl.com.
#To request back copies (available for a week or so), send your request
#to almanac@ruby.oce.orst.edu with the command "send perl-users x.y",
#where x is the volume number and y is the issue number.
#For other requests pertaining to the digest, send mail to
#perl-users-request@ruby.oce.orst.edu. Do not waste your time or mine
#sending perl questions to the -request address, I don't have time to
#answer them even if I did know the answer.
------------------------------
End of Perl-Users Digest V10 Issue 9897
***************************************
