[prev in list] [next in list] [prev in thread] [next in thread] 

List:       perl5-porters
Subject:    Re: [perl #27661] perlxs man pages out of sync with reality
From:       Marcus Holland-Moritz <mhx-perl () gmx ! net>
Date:       2004-03-30 17:43:36
Message-ID: 20040330194336.644f7e96 () r2d2
[Download RAW message or body]

On 2004-03-29, at 20:40:23 -0700, Joseph Bruni wrote:

> On Mar 23, 2004, at 5:41 PM, Dave Mitchell via RT wrote:
> 
> >> Reading through the man pages of perlxs, perlxstut, etc. I've found
> >> that the described environment does not match the behavior of the
> >> tools supplied with Perl5.8.1.
> >
> > Can you provide any examples of these mismatches?
> 
> The various discrepancies are easy to find: Just work through the 
> tutorial as any newbie would. The most obvious are in the area of 
> writing the "test.pl" script. One gets the feeling that the 
> documentation was written for a much earlier version of Perl and has 
> not been maintained.

Actually, it was written for a much earlier version, and
since then hasn't been maintainted a lot.

The 'test.pl' stuff is still valid (in the sense that it
will work), but it's not what you should use in the days
of Test, Test::Simple and Test::More.

The perlxstut manpage is already on my todo list. What's
wrong with the perlxs? And which other manpages do you
think are wrong/outdated?

Marcus

-- 
Progress means replacing a theory that is wrong with one more subtly wrong.
[prev in list] [next in list] [prev in thread] [next in thread]