Debug your wizardry

Please re-compose your documentation pages. I have been looking at information on perlguts.

Unfortunately, it is full of passages like (from http://www.perlmonks.org/index.pl?node=perlman%3Aperlguts&lastnode_id=424#Reference_Counts_and_Mortality):

However, there is one other function which manipulates the reference count of its argument. The perlman:perlguts function, you will recall, creates a reference to the specified argument. As a side effect, it increments the argument's reference count. If this is not what you want, use perlman:perlguts instead.

Either you meant to have something other than "perlman:perlguts", or else you are serving the wrong master.

2001-10-24 Edit by Corion : Added formatting and italics

Comment on Debug your wizardry

Replies are listed 'Best First'.
Re (tilly) 1: Debug your wizardry by tilly (Archbishop) on Oct 24, 2001 at 17:47 UTC
The documentation on this site is for an old version of Perl. But no version of Perl would be able to match whatever people here have. If you want to get accurate documentation for what you have, you need to consult local documentation on your machine. Nothing else has a hope of being in sync with you. Which is why I prefer to tell people to do as I do and use your perldoc command to consult documentation, rather than going to websites that don't match what you have installed. So start with the following three: `perldoc perldoc perldoc perl perldoc perlguts` [download] and start reading.	[reply] [d/l]
Re: Debug your wizardry by blackmateria (Chaplain) on Oct 24, 2001 at 16:56 UTC
I doubt those nodes you're reading have ever been maintained. Look at the date on them -- Aug 24, 1999 or thereabouts. That's even before the legendary Oct 4, 1999 when the site upgraded to Everything 0.9 (or whatever the gods did that day, see The True Catacombs of Perlmonks for more info). The docs on those nodes are seriously out of date, for example, the copy of perlre you'll find there is 200 lines shorter than this copy, on perldoc.com. If you want to read perlguts, here's a link to an unbroken copy on perldoc.com. HTH.	[reply]