A restructured perlvar
I've been working on a restructured perlvar and I think I've mostly got it right, but at the moment I'm almost wishing that I never have to see it again. Have a look for yourself. It's in the perl git repo in the briandfoy/perlvar branch (if you're looking at the github mirror, realize it's several hours behind).
The new version notes when each variable appeared in the Perl 5 series of releases if it wasn't there at the start.
I still have to ensure that nothing breaks the perldoc -v
stuff. I've tried it on several variables without problems but I don't know if some of the restructuring affected the odd variable.
I expect to merge this for the next development release, so I have a couple works to sort out whatever is left.
Improving perl's documentation is a rather under-appreciated task to do, but often at least as necessary as updating its code.
Lots of kudos to you!
Why does it look suspicious? I'm not seeing the point you're trying to make.
Thank you! This is a wonderful improvement. There has been a lot about marketing Perl in the blogosphere in the last year, and this is one of the best things I've seen. A great example of making easy things easy (knowing if a feature is available) and hard things possible (knowing from the start what versions will not be supported so it can be accurately documented and listed in the prerequisites). Great idea!
It's just different from other header lines... but I guess it is valid (I didn't and don't know what X<...> means).
You have (or had) an error around line 1522: the information about $\ got inserted into middle of description of $| variable.
I think you're looking at an old version.
Yes, it is fixed now.
Yet another suspect thing, at beginning of "Variables related to formats" section, line 1571: The special variables for formats are a subset of those for filehandles so they have... and here it ends. So they have what?
line 1701:
Either perl sets C<$!>, or C<$!> is set to, not both :-)
Wells Fargo has agreed to restructure my mortgage but with a prepayment penalty and does not state the terms of the prepayment penalty.
[spam link removed]
Wells Fargo makes you use $& if you prepay your mortgage. This slows down the time it takes to process the transaction and makes everyone around you complain loudly that you're doing it wrong.
Thanks for all of the proofreading. I've read my version of perlvar so many times in the past week that I'm thinking I never want to see another Perl variable. :)