Front page | perl.perl5.porters |
Postings from April 2011
"Konovalov, Vadim (Vadim)** CTR **" <vadim.konovalov@alcatel-lucent.com> wrote on Sat, 09 Apr 2011 22:04:12 +0200: > It seems to me that perl documentation is overloaded with these > "starting from 5.x.y you can do this" > These statements, while true, overload documentation needlessly. We > already have perldeltas etc. > A person reading recent documentation presumably running recent > version of perl also. > I imagine freshly appeared features should be marked so, and it is > convenient to perl gurus, who have number of perl v ersions installed, > but all these versions be frustrating to a new person to perl. > maybe mark such places specially in POD? in "=for" tag? > ok, this is not really important, just my impression that I have. No, really, it is. I'm struggling with it right now. I've expurgated the really old perl version number mentions from the next Camel, but there are all these more recent things in stuff. For example, look at perlvar. I kinda feel like I should mention anything from 5.8 or later, because some production systems still will have 5.8 for a while. I'm thinking that in the book, a table might be the best way to do that instead of mentioning it next to each variable. In perlvar, I'm not sure. --tomThread Previous | Thread Next