develooper Front page | perl.perl5.porters | Postings from August 2009

Re: [DOC] Modernization: perlsyn

Thread Previous | Thread Next
Ben Morrow
August 29, 2009 12:44
Re: [DOC] Modernization: perlsyn
Message ID:
Quoth (Flavio Poletti):
> I tried to tidy up perlsyn and there was luckly little to do IMHO. According
> to I
> decided to use GitHub, so it seems that I need to provide the following:
> branch modern
> Each change comes with a commit of its own, in order to better document it
> all:

First of all, thanks for doing this. Tidying up documentation is always
a thankless task, and since you're concentrating on stylistic changes
rather than actual bugs I'm sure you'll get more than your share of
indignant bikeshedding. Please don't let it discourage you.

That said, let me begin the bikeshedding by saying that I really hate
the {'BAR'} style of hash element (as opposed to simply {BAR}). A quick

    perl% perl -nE'/\{\s*(["\47]?)\w+\1\s*\}/ and say $1' pod/* |
        sort | uniq -c
      70 "
     178 '

suggests the core docs agree with me (some of those are false positives
on things like *FOO{IO}, of course).

> Things I hope to remember in the future:

If you're interested in review, then posting patches would be helpful.
It would probably be better to post something like that branch you have
their as a single diff for the sake of review, even though the commits
will hopefully be pulled separately.


Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About