nms-cgi-devel — Developers discussion for NMS CGI programs

Re: [Nms-cgi-devel] Explore cvs with WinCVS

[Barbie <ba...@qi...>]

From: "Nick Cleaton" <ni...@cl...>

> On Wed, Oct 23, 2002 at 09:33:00PM +0200, Teun wrote:
> > Hmmm... looking at this whole cvs thing for the first time...
> > I read a bunch of ttorials from both sf.net and wincvs but one thing
puzzles
> > me:
> >
> > how do i just 'browse around' in nms's cvs?
>
> I don't know about wincvs in particular, but there should be some sort
> of option to copy the latest version of all the nms files to a tree on
> your hard disk, and browse them there.

Click on the Create option in the toolbar and then Checkout Module to bring
up the dialog box. In order to connect to the NMS CVS repository you'll need
to have an ssh client available.After attempting several, the one available
from www.ssh.com proved simple and painless to install and get working with
CVS. Note that you need to setup the configuration to ensure CVS knows where
the SSH app is. There is documentation on this at
http://minimal.cx/wincvsssh.php under "wincvs setup".

One thing to bear in mind though is that you'll need to checkout each module
(script bundle) individually, and enter your shh password each time. Unless
anyone knows of a better way of storing your password locally?

Barbie.

Re: [Nms-cgi-devel] nms-FormMail-OO

[Nick C. <ni...@cl...>]

On Wed, Oct 23, 2002 at 11:50:20PM +0200, Thomas Lochmatter wrote:
> I've rewritten FormMail in Perl-OO-style. The features are quite the same
> and so are the requirements. Instead of one huge script, it contains a dozen
> of perl classes, well structured and ready to extend. The "handler" classes
> can be overwritten or new "handlers" may be added.
> It is thus much more extensible and lets more possibilities than just a few
> configuration lines.
> 
> Of course, it does not replace the current nms-formmail, which is easier to
> handle (one large file) if one is happy with the functionality.
> 
> Are you interested in adding this as a subproject (eg. "formmail-oo") to
> your project, I would provide my code as open source.

I'd certainly be interested in taking a look at that - can you upload it
somewhere ?

--
Nick

Re: [Nms-cgi-devel] Explore cvs with WinCVS

[Nick C. <ni...@cl...>]

On Wed, Oct 23, 2002 at 09:33:00PM +0200, Teun wrote:
> Hmmm... looking at this whole cvs thing for the first time...
> I read a bunch of ttorials from both sf.net and wincvs but one thing puzzles
> me:
> 
> how do i just 'browse around' in nms's cvs?

I don't know about wincvs in particular, but there should be some sort
of option to copy the latest version of all the nms files to a tree on
your hard disk, and browse them there.

--
Nick

[Nms-cgi-devel] nms-FormMail-OO

[Thomas L. <sou...@lo...>]

I've rewritten FormMail in Perl-OO-style. The features are quite the same
and so are the requirements. Instead of one huge script, it contains a dozen
of perl classes, well structured and ready to extend. The "handler" classes
can be overwritten or new "handlers" may be added.
It is thus much more extensible and lets more possibilities than just a few
configuration lines.

Of course, it does not replace the current nms-formmail, which is easier to
handle (one large file) if one is happy with the functionality.

Are you interested in adding this as a subproject (eg. "formmail-oo") to
your project, I would provide my code as open source.

Thomas
(sourceforge id: lochmatter)

Re: [Nms-cgi-devel] Explore cvs with WinCVS

[Dan M. <oma...@br...>]

> how do i just 'browse around' in nms's cvs?

http://sourceforge.net/cvs/?group_id=39625

has instructions on how you need to configure your CVS client for
anonymous access.

	--pretty simple once you have the two step recipe.

http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/nms-cgi/

	--gives look at the source through a web browser.

Generally there seems to be more developer oriented stuff at the
sourceforge.net/nms-cgi link than the nms-cgi.sourceforge.net link

[Nms-cgi-devel] Explore cvs with WinCVS

[Teun <te...@ch...>]

Hmmm... looking at this whole cvs thing for the first time...
I read a bunch of ttorials from both sf.net and wincvs but one thing puzzles
me:

how do i just 'browse around' in nms's cvs?

Teun

Re: [Nms-cgi-devel] Become an nms developer

[Nick C. <ni...@cl...>]

On Tue, Oct 22, 2002 at 01:24:54PM +0200, Teun wrote:
> Hi Guys/Girls,
> 
> Is Dave from da...@da... still in this project? I mailed him a couple
> of times that i want to help on the nms project but he does not reply to my
> mail. How do i become an nms developer?

Mailing Dave will normally do it, but he's on holiday at the moment.

If you mail me your sourceforge username I'll add you.

--
Nick

[Nms-cgi-devel] Become an nms developer

[Teun <te...@ch...>]

Hi Guys/Girls,

Is Dave from da...@da... still in this project? I mailed him a couple
of times that i want to help on the nms project but he does not reply to my
mail. How do i become an nms developer?

Teun van Eijsden

[Nms-cgi-devel] FormMail-OO (was: Better Referer Check)

[Thomas L. <th...@lo...>]

I posted a feature request about a better referer check a few weeks ago. 
Since noone answered it, I implemented this by myself.

My implementation (not yet completely finished) has a few other 
features, eg. IP range for referer, ...
In order to code all this, I split the formmail code up into several 
Perl Classes. The resulting script is now completely OO-Perl. It is thus 
easier to make changes and to add new features. The configuration is 
much more scalable for different purposes. A module that reads the 
config from a file rather than from the form input fields (like TFMail) 
could quickly be added.

It does not use more external modules than nms-FormMail and runs under 
-wT as well. It runs as CGI and mod_perl. The biggest drawback is it 
consists of approximately 10 class files instead of one large file. But 
this should not be a big problem.

If you are interested, I make it freely available as a nms-script (eg. 
formmail-oo).

Thomas
(sourceforge user id: lochmatter)

Re: [Nms-cgi-devel] Version Numbers

[Dave C. <da...@da...>]

On Fri, Oct 04, 2002 at 02:35:28PM +0200, Christoph Martin (ma...@ve...) wrote:
> Dave Cross <da...@da...> writes:
> 
> > Many people have asked for the programs' version numbers to be available
> > on the download page, so I've now implemented that. See
> > <http://nms-cgi.sourceforge.net/scripts.shtml>.
> 
> I am somewhat confused. The version numbers on the website seam to be
> different (all newer) than the version numbers in the script. For
> instance textcounter says on the website to have version 1.18. But if
> you download the file behind the link you get an archive with text a
> counter.pl version 1.16. rand-text includes version 1.10 in the
> archive but announces version 1.12 on the website.
> 
> Why is this so?

Honest answer? No idea. It does seem to be completely broken. I'll
check over the weekend and ensure that they are all correct.

Thanks for pointing it out.

> PS: Someone can update the statement about Debian on the
> website. Debian woody was released in July with most of the nms
> scripts included. Newer versions are in the unstable distribution. 

I'll update that at the same time.

Thanks for all of your work on this.

Dave...

-- 
  Drugs are just bad m'kay

Re: [Nms-cgi-devel] Version Numbers

[Christoph M. <ma...@ve...>]

Dave Cross <da...@da...> writes:

> Many people have asked for the programs' version numbers to be available
> on the download page, so I've now implemented that. See
> <http://nms-cgi.sourceforge.net/scripts.shtml>.

I am somewhat confused. The version numbers on the website seam to be
different (all newer) than the version numbers in the script. For
instance textcounter says on the website to have version 1.18. But if
you download the file behind the link you get an archive with text a
counter.pl version 1.16. rand-text includes version 1.10 in the
archive but announces version 1.12 on the website.

Why is this so?

Christoph

PS: Someone can update the statement about Debian on the
website. Debian woody was released in July with most of the nms
scripts included. Newer versions are in the unstable distribution. 

-- 
============================================================================
Christoph Martin, EDV der Verwaltung, Uni-Mainz, Germany
 Internet-Mail:  Chr...@Un...
  Telefon: +49-6131-3926337

Re: [Nms-cgi-devel] [ShermanB@clh.com: Security List]

[Dave C. <da...@da...>]

On Thu, Oct 03, 2002 at 02:40:58PM +0100, Dave Cross (da...@da...) wrote:
> On Thu, Oct 03, 2002 at 09:03:21AM +0100, Nick Cleaton (ni...@cl...) wrote:
> > 
> > I agree with this user, we should have a security announce list
> > for the fixing of security problems.
> 
> Me too. 
> 
> > Does sourceforge allow us to create a list that only we can post
> > to ?
> 
> Yes it does. I've just created an nms-cgi-security list. It'll take a
> few hours before we can use it.

<https://lists.sourceforge.net/lists/listinfo/nms-cgi-security>

Only Nick and I can post to the list without approval.

Dave...

-- 
  And crawling on the planet's face, some insects called the human race
  Lost in time, and lost in space. And meaning.

Re: [Nms-cgi-devel] [ShermanB@clh.com: Security List]

[Dave C. <da...@da...>]

On Thu, Oct 03, 2002 at 09:03:21AM +0100, Nick Cleaton (ni...@cl...) wrote:
> 
> I agree with this user, we should have a security announce list
> for the fixing of security problems.

Me too. 

> Does sourceforge allow us to create a list that only we can post
> to ?

Yes it does. I've just created an nms-cgi-security list. It'll take a
few hours before we can use it.

Dave...    

> ----- Forwarded message from Sherman Boyd <She...@cl...> -----
> 
> X-SpamAssassin-Hits: -0.4
> X-Envelope-To: <nic...@cl...>
> Subject: Security List
> X-MimeOLE: Produced By Microsoft Exchange V6.0.6249.0
> Date: Wed, 2 Oct 2002 12:10:48 -0700
> Thread-Topic: Security List
> Thread-Index: AcJqR2rbO7XmVdyyQ8K14IGOS4KVWg==
> From: "Sherman Boyd" <She...@cl...>
> To: <da...@us...>, <gel...@us...>,
>         <ni...@us...>
> 
> Hi,
> 
> I'd like to receive any security announcement related email without having to recieve developer or user traffic.  As I see it a security announce list is an integral part of ah uhmm good security.  Even if it never has to be used, it's nice.  
> 
> Anyway I'm switching from Matt's formail script to yours.  
> 
> Thanks a lot for your hard work,
> 
> Sherman Boyd
> 
> 
> ----- End forwarded message -----
> 
> 
> -------------------------------------------------------
> This sf.net email is sponsored by:ThinkGeek
> Welcome to geek heaven.
> http://thinkgeek.com/sf
> _______________________________________________
> Nms-cgi-devel mailing list
> Nms...@li...
> https://lists.sourceforge.net/lists/listinfo/nms-cgi-devel

-- 
  Love is a fire of flaming brandy
  Upon a crepe suzette

[Nms-cgi-devel] [ShermanB@clh.com: Security List]

[Nick C. <ni...@cl...>]

I agree with this user, we should have a security announce list
for the fixing of security problems.

Does sourceforge allow us to create a list that only we can post
to ?

--
Nick
   
----- Forwarded message from Sherman Boyd <She...@cl...> -----

X-SpamAssassin-Hits: -0.4
X-Envelope-To: <nic...@cl...>
Subject: Security List
X-MimeOLE: Produced By Microsoft Exchange V6.0.6249.0
Date: Wed, 2 Oct 2002 12:10:48 -0700
Thread-Topic: Security List
Thread-Index: AcJqR2rbO7XmVdyyQ8K14IGOS4KVWg==
From: "Sherman Boyd" <She...@cl...>
To: <da...@us...>, <gel...@us...>,
        <ni...@us...>

Hi,

I'd like to receive any security announcement related email without having to recieve developer or user traffic.  As I see it a security announce list is an integral part of ah uhmm good security.  Even if it never has to be used, it's nice.  

Anyway I'm switching from Matt's formail script to yours.  

Thanks a lot for your hard work,

Sherman Boyd


----- End forwarded message -----

Re: [Nms-cgi-devel] Fwd: [rsturm@comcast.net: Miss-directed Error Message (Program Bug)]

[Sam S. <S...@mS...>]

On Sun, 29 Sep 2002, Dave Cross wrote:
> Got this in my inbox on Friday from a less than completely happy
> customer. It got me thinking. He _does_ have a bit of a point. If
> people have misconfigured scripts, do we really want them to be
> presenting their users with _our_ contact details.
>
> This seems to me to have two major downsides:
>
> 1/ They might never find out that their script is misconfigured.
>
> 2/ Visitors will see _our_ name when things go wrong - and that's not
>    great publicity for us :-/
>
> Comments? Opinions?


Thoughts on something like the below?



Sam

Index: FormMail.pl
===================================================================
RCS file: /cvsroot/nms-cgi/formmail/FormMail.pl,v
retrieving revision 2.15
diff -u -r2.15 FormMail.pl
--- FormMail.pl	26 Sep 2002 22:10:09 -0000	2.15
+++ FormMail.pl	29 Sep 2002 23:07:50 -0000
@@ -40,6 +40,7 @@
 #
 BEGIN
 {
+  $cgi_administrator = 'som...@ex...';
   $DEBUGGING         = 1;
   $emulate_matts_code= 0;
   $secure            = 1;
@@ -905,8 +906,8 @@
           $error_body
           <hr size="1" />
           <p class="c3">
-            <a href="http://nms-cgi.sourceforge.net/">FormMail</a>
-            &copy; 2001 London Perl Mongers
+            NMS FormMail -- &copy; 2001-2002 London Perl Mongers
+	    Contact the <a href="mailto:$cgi_administrator">Administrator of this CGI Program</a> with any problems.
           </p>
         </td>
       </tr>

[Nms-cgi-devel] Fwd: [rsturm@comcast.net: Miss-directed Error Message (Program Bug)]

[Dave C. <da...@da...>]

Got this in my inbox on Friday from a less than completely happy
customer. It got me thinking. He _does_ have a bit of a point. If
people have misconfigured scripts, do we really want them to be
presenting their users with _our_ contact details.

This seems to me to have two major downsides:

1/ They might never find out that their script is misconfigured.

2/ Visitors will see _our_ name when things go wrong - and that's not
   great publicity for us :-/

Comments? Opinions?

Dave...

----- Forwarded message from Rick Sturm <rs...@co...> -----

Date: Fri, 27 Sep 2002 23:08:33 -0500
From: Rick Sturm <rs...@co...>
Subject: Miss-directed Error Message (Program Bug)
To: da...@us...

Murfreesboro Medical Clinic appears to be using software that your
company wrote, in order to accept Email from people wanting to contact
them. Their Web Page is www.mmclinic.com, and it is apparently not
written correctly, but then neither is your software. Instead of sending
the error message to the web designer, you send it to the people who are
trying to get hold of the designer. In this case no one got the message
that they needed. What follows is the URL for the error message, and
also the error message itself.

I can see were you might have intended for this to have come up in
testing, but it obviously did not. It has left me unable to communicate
with them.

http://filemonster.isdn.net/cgi-bin/formmail.pl

      Bad Referrer - Access Denied
      The form attempting to use FormMail resides at
http://www.mmclinic.com/contact.htm, which is not allowed to access
this program.

      If you are attempting to configure FormMail to run with this form,
you need to add the following to @referers, explained in detail in the
README file.

      Add 'www.mmclinic.com' to your @referers array.


---------------------------------------------------------------------

      FormMail =A9 2001 London Perl Mongers



Sincerely,

     Rick Sturm
      RICK STURM & ASSOCIATES
      Reply to:
     rs...@co...

----- End forwarded message -----

-- 
  Drugs are just bad m'kay

Re: [Nms-cgi-devel] Hi!

[Dave C. <da...@da...>]

On Thu, Sep 26, 2002 at 01:49:19PM +0100, ma...@di... (ma...@di...) wrote:
> Just a quick note to sday "Hi" - a friend of mine recommended that I join the
> project. I'm fairly new to perl, fairly old to programming, not sure what's
> currently needed, but here I am anyway & if anyone wants to bung a bit of work
> my way I'll be happy to help in whatever way I can. I'm here to learn, develop
> my skills & put whatever skills I have to best use. 

Matt,

Welcome aboard. Please take a look at the (minimal!) project docs at
<http://sourceforge.net/docman/?group_id=39625>. Then set yourself up
a SourceForge account and let me know your username.

Then you can make yourself a CVS working copy of the code and start to
familiarise yourself with the programs.

A good idea to start with, might be to hang out on the support mailing
list for a while and see the kinds of requests that we get from users.

Give me a shout if you need anything.

Dave...

-- 
  Drugs are just bad m'kay

[Nms-cgi-devel] Hi!

[<ma...@di...>]

Just a quick note to sday "Hi" - a friend of mine recommended that I join the
project. I'm fairly new to perl, fairly old to programming, not sure what's
currently needed, but here I am anyway & if anyone wants to bung a bit of work
my way I'll be happy to help in whatever way I can. I'm here to learn, develop
my skills & put whatever skills I have to best use. 

regards,

Matt Moran (aka Sciamachy in IRC)

-- 
Those who make peaceful revolution impossible
will make violent revolution inevitable.
  - John F. Kennedy -

[Nms-cgi-devel] Re: [Nms-cgi-support] Two questions about Formmail

[Nick C. <ni...@cl...>]

On Thu, Sep 26, 2002 at 09:11:55AM +0100, Dave Cross wrote:
> > 
> > On lines 553 and 556 of the script, replace \n\n with \n.
> 
> Is it worth making this a configuration option?
> 
> $double_spacing = 1;

Yes.

I've resisted that in past since TFmail does customisable
output, but now more people have asked for it and with the
Text::Wrap stuff users now need to change \n\n to \n in
two places rather than one.

--
Nick

[Nms-cgi-devel] [ nms-cgi-Feature Requests-614000 ] Better referer check in formmail

[<no...@so...>]

Feature Requests item #614000, was opened at 2002-09-24 19:24
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=425772&aid=614000&group_id=39625

Category: None
Group: None
Status: Open
Priority: 5
Submitted By: Lochmatter Thomas (lochmatter)
Assigned to: Nobody/Anonymous (nobody)
Summary: Better referer check in formmail

Initial Comment:
For a "secure" referer check, the formmail script should 
download the original html file with the form and 
compare some of the submitted information, namely the 
receiver email address.
As it is widely known, the referer can be easily changed 
by a hacker and a simple referer check only makes it a 
bit more difficult to misuse the formmail script, but still 
possible.

Could you implement this check in your script?

- Thomas Lochmatter

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=425772&aid=614000&group_id=39625

Re: [Nms-cgi-devel] FAQ updates

[Dave C. <da...@da...>]

On Sun, Sep 22, 2002 at 03:46:23PM +0100, Sam Smith (S...@mS...) wrote:
> On Sun, 22 Sep 2002, Nicholas Clark wrote:
> > On Sat, Sep 21, 2002 at 11:57:05AM +0100, Sam Smith wrote:
> > > Comments on the rest of it also requested :-)
> >
> > > +Please don't mail developer's individually, because not only may they
> >
> > Grammar nit - should be "developers".
> > (You probably knew that, and although I know it, it doesn't stop me finding
> > myself doing it by accident occasionally)
> 
> Doesn't mean I spotted it :-)
> 
> 
> > > +are commonly caused by typos during editing. These typos result
> > > +in the program not being valid Perl.
> > > +
> > > +You should check every line you edited, to ensure that you have not
> > > +left a set of quotes or brackets (of any variety) open. Having an
> > > +opening ' with a corresponding " is a very common problem, and not
> > > +easy to spot (especially when you have one of each and don't notice
> > > +they are different).
> >
> > Do we want to make any suggestion about running the program with perl -c
> > locally? (better still run it on a web server locally)
> 
> That question is getting huge. I'm starting to think it's worth
> pulling it out of the FAQ, and into its own page where we can go in to
> more detail. Thoughts?

Or, maybe splitting it out into a number of smaller questions?

Dave...

-- 
  .sig missing...

Re: [Nms-cgi-devel] FAQ updates

[Sam S. <S...@mS...>]

On Sun, 22 Sep 2002, Nicholas Clark wrote:
> On Sat, Sep 21, 2002 at 11:57:05AM +0100, Sam Smith wrote:
> > Comments on the rest of it also requested :-)
>
> > +Please don't mail developer's individually, because not only may they
>
> Grammar nit - should be "developers".
> (You probably knew that, and although I know it, it doesn't stop me finding
> myself doing it by accident occasionally)

Doesn't mean I spotted it :-)


> > +are commonly caused by typos during editing. These typos result
> > +in the program not being valid Perl.
> > +
> > +You should check every line you edited, to ensure that you have not
> > +left a set of quotes or brackets (of any variety) open. Having an
> > +opening ' with a corresponding " is a very common problem, and not
> > +easy to spot (especially when you have one of each and don't notice
> > +they are different).
>
> Do we want to make any suggestion about running the program with perl -c
> locally? (better still run it on a web server locally)

That question is getting huge. I'm starting to think it's worth
pulling it out of the FAQ, and into its own page where we can go in to
more detail. Thoughts?




Sam

-- 
  Disloyalty: There Comes a Time When Every Team Must Learn
    to Make Individual Sacrifices

Re: [Nms-cgi-devel] FAQ updates

[Nicholas C. <ni...@un...>]

On Sat, Sep 21, 2002 at 11:57:05AM +0100, Sam Smith wrote:

> Comments on the rest of it also requested :-)

> +Please don't mail developer's individually, because not only may they

Grammar nit - should be "developers".
(You probably knew that, and although I know it, it doesn't stop me finding
myself doing it by accident occasionally)

> +are commonly caused by typos during editing. These typos result
> +in the program not being valid Perl.
> +
> +You should check every line you edited, to ensure that you have not
> +left a set of quotes or brackets (of any variety) open. Having an
> +opening ' with a corresponding " is a very common problem, and not
> +easy to spot (especially when you have one of each and don't notice
> +they are different).

Do we want to make any suggestion about running the program with perl -c
locally?
(better still run it on a web server locally)

[apart from that looks good, and nothing to add]

Nicholas Clark
-- 
Even better than the real thing:	http://nms-cgi.sourceforge.net/

[Nms-cgi-devel] Re: [Nms-cgi-support] FormMail.pl

[Nick C. <ni...@cl...>]

On Sat, Sep 21, 2002 at 04:30:24PM +0100, Nick Cleaton wrote:
> > 
> > <INPUT TYPE="hidden" NAME="sort" VALUE="order:lastname, 
> > firstname,email,address, etc....
> > 
> > All the values are returned but not the email address!....is it not
> > supposed to?
> 
> If you want to include email in the sort order, you need to add
> it to the list in the @config_include configuration variable:
> 
>   @config_include = qw(email);

This is happening a lot, and it occurs to me that the
@config_include array is redundant.

We could treat all config inputs as if they were in
@config_include, since that only has any effect if those
variables are mentioned in sort=order:..., which will only
happen if the user wants to include the config input. 

Maybe only if $emulate_matts_code is 0 though.

--
Nick

[Nms-cgi-devel] FAQ updates

[Sam S. <S...@mS...>]

Some cleanup to bits of the FAQ.

Can someone know knows something about running scripts on windows tell
me how wrong the following new FAQ is:
  I get an "Premature End of Script Headers" error. How do i fix it?


Comments on the rest of it also requested :-)

Diff against what's in CVS below.

Regards
Sam


Index: faq_nms.pod
===================================================================
RCS file: /cvsroot/nms-cgi/docs/faq_nms.pod,v
retrieving revision 1.1
diff -u -r1.1 faq_nms.pod
--- faq_nms.pod	14 Sep 2002 16:06:29 -0000	1.1
+++ faq_nms.pod	21 Sep 2002 10:48:40 -0000
@@ -175,6 +175,15 @@
 HTML let you get away with. All tags must be explicitly closed and all
 presentation information is stored in a stylesheet.

+=head2 Can I email my problem report to a developer rather than the list?
+
+There are a number of people who can answer support enquiries, and
+those people are on the mailing list.
+
+Please don't mail developer's individually, because not only may they
+not be the best person to answer your query, but they may be away, and
+so you don't get an answer for a while. It also leaves developers
+less time to actually work on improving the programs.


 =cut
Index: faq_prob.pod
===================================================================
RCS file: /cvsroot/nms-cgi/docs/faq_prob.pod,v
retrieving revision 1.1
diff -u -r1.1 faq_prob.pod
--- faq_prob.pod	14 Sep 2002 16:06:29 -0000	1.1
+++ faq_prob.pod	21 Sep 2002 10:48:40 -0000
@@ -1,14 +1,18 @@
 =head1 NAME

 Frequently Asked Questions about running the I<nms> CGI programs.
-If a question is not specific to
+If a question is not specific to running a script, please see
+the other FAQ sections referenced above.

 E<lt>-- $Date: 2002/09/14 16:06:29 $ --E<gt>

 =head1 DESCRIPTION

 These are hopefully answers to question you will have when installing
-or running our programs.
+or running our programs. If there is something that should be added
+please contact our support list through
+E<lt>http://nms-cgi.sourceforge.net/support.htmlE<gt>
+.


 =head2 How do I report a problem?
@@ -44,7 +48,6 @@
 to ignore what we know we don't need, than to ask for information we
 might.

-this on their own time.


 =head2 There is a conflict between NMS documentation and Matt's.  Which is right?
@@ -278,11 +281,18 @@
 This will stop the error message.


+=head2 I get an "Premature End of Script Headers" error. How do i fix it?
+
+This can be caused by the #! line at the top of the program
+having the wrong path to perl. Our programs expect perl to
+be in /usr/bin on a UNIX system. If your perl is elsewhere,
+or you are running on Windows, you will need to change this.
+
+
 =head2 When I try to run your program, I get an "Internal Server Error". What does that mean?

 This (rather useless) error message generally means that your webserver
-tried to execute the program, but execution failed. This is most
-likely to be caused by the Perl program not being valid Perl.
+tried to execute the program, but execution failed.

 Perl tries to run your program, finds an error, and throws up
 warnings. The webserver interprets these warnings as output from the
@@ -290,25 +300,26 @@
 Error.

 If you have access to your web server's error logs, you can probably
-get more information as to precisely what caused the problem. If not,
-try the next question.
+get more information as to precisely what caused the problem.  The
+next question tells you how to fix it.


 =head2 How do I fix this "Internal Server Error" ?

-Firstly, if the program, as you downloaded it from our website, does
-not work
+Firstly check that the scipt has the right extension for your
+server (.pl or .cgi), and has execute permissions as detailed in the
+INSTALL file. If these are right, then it is most likely to be caused
+by the Perl program not being valid Perl.

 Internal Server Errors, where you have edited the program yourself,
-are most commonly caused by typos during editing. These typos result
-in the program not being valid Perl, and errors confusing the
-webserver.
-
-What you should initially do, is check every line you edited, to check
-that you have not left a set of quotes or brackets (of any variety)
-open. Having an opening ' without a corresponding " is a very common
-problem, and not easy to spot (especially when you have one of each
-and don't notice they are different).
+are commonly caused by typos during editing. These typos result
+in the program not being valid Perl.
+
+You should check every line you edited, to ensure that you have not
+left a set of quotes or brackets (of any variety) open. Having an
+opening ' with a corresponding " is a very common problem, and not
+easy to spot (especially when you have one of each and don't notice
+they are different).

 If you really can not see what the problem is, try redownloading
 the program from our website, and uploading it to your webserver
@@ -316,8 +327,9 @@
 to the program one at a time, testing each time you make a change.
 This makes debugging much easier.

-If everything works, compare the version that works, with your
-original that didn't, and see where the original was broken.
+When everything works, compare the version that works, with your
+original that didn't, and see where the original was broken.  That
+way, you may be able to find the problem faster if it happens again

 If it still doesn't work, then contact our support list, and
 include all the information you possibly can.
@@ -375,7 +387,7 @@

 =head2 I use FormMail but want it to do something more. Will you do it?

-That depends.
+Maybe.

 You probably first want to look at TFmail which is a more advanced
 version of FormMail which includes enhanced features such as