On Fri, Dec 03, 2010 at 03:43:30PM +0200, Shlomi Fish wrote: > On Friday 03 December 2010 15:25:14 demerphq wrote: > > On 3 December 2010 13:49, Shlomi Fish <shlo...@iglu.org.il> wrote: > > > Hi all, > > > > > > after I posted my series of patches to perlipc.pod , I saw that tchrist > > > posted his version, which got accepted immediately. As a downside to > > > that, I'll have to restart my work. However, I noticed that perlipc.pod > > > still has many > > > > > perceived issues. Here is a list of things I noticed: > > > > Shlomi, why didnt you send this to tchrist, and cc p5p? > > > > Don't know - didn't think about it. I assumed he would see my posting as he > saw my previous posts about the perlipc.pod revamp. I'm CCing him here. > > > Dont expect Tom to see your posting. > > OK, why shouldn't I? He saw the previious posts. > > > > > He is the one you need to speak to about any of the issues that you > > raise that are not outright bugs but rather style nits. > > > > They are still important, because the people who are trying to help the Perl > beginners, are often presented with badly written code, and having code like > that in the core Perl documentation only amplifies the problem, and makes us > look bad.
You would have a point if you there are code fragments that are generally considered "badly written". But using '||' where you would prefer 'or', or using FILE globs where you would use a lexical handle, doesn't make "badly written" code. That's just a style preference. And naming anything that isn't written according to your preferences "badly written" code doesn't really get people to side with you. Abigail