Re: Announcing the Perl 5 Documentation Team

2010-07-02 Thread Chas. Owens
On Fri, Jul 2, 2010 at 07:18, David Golden xda...@gmail.com wrote: On Thu, Jul 1, 2010 at 7:11 PM, Chas. Owens chas.ow...@gmail.com wrote: Failure to add a use 5.010; or use 5.012; limits the features that can be used in examples.  For instance, this example won't work even under 5.12 as it is

Re: Announcing the Perl 5 Documentation Team

2010-07-02 Thread Chas. Owens
On Fri, Jul 2, 2010 at 08:57, David Golden xda...@gmail.com wrote: On Fri, Jul 2, 2010 at 8:22 AM, Chas. Owens chas.ow...@gmail.com wrote: It isn't just that say wasn't added until 5.10, it is that say doesn't even work without a use 5.010; or similar statement.  This means that the person

Re: Announcing the Perl 5 Documentation Team

2010-07-02 Thread Ævar Arnfjörð Bjarmason
On Fri, Jul 2, 2010 at 13:56, Horsley, Tom tom.hors...@ccur.com wrote: Good luck with this. I'll just mention one thing that has bothered me since the documentation got all improved when moving from perl4 to perl5: The perl4 doc was all one giant man page, which made it really simple to

Re: Announcing the Perl 5 Documentation Team

2010-07-02 Thread Caleb Cushing
On Thu, Jul 1, 2010 at 7:11 PM, Chas. Owens chas.ow...@gmail.com wrote: Failure to add a use 5.010; or use 5.012; limits the features that can be used in examples.  For instance, this example won't work even under 5.12 as it is written:    say foo; It is possible that we should only add use

Re: Announcing the Perl 5 Documentation Team

2010-07-02 Thread Gabor Szabo
On Fri, Jul 2, 2010 at 5:55 PM, Caleb Cushing xenoterrac...@gmail.com wrote: On Fri, Jul 2, 2010 at 10:33 AM, Gabor Szabo szab...@gmail.com wrote: Interestingly I would have said that the documentation is mostly needed by novices or by people who rarely use Perl. The difference might be

Re: Announcing the Perl 5 Documentation Team

2010-07-02 Thread Shawn H Corey
On 10-07-02 10:33 AM, Gabor Szabo wrote: I don't know much about experts but I think we should make it easy for people with no, or little background in Perl to get simple answers to their questions with pointers to further details. I think the vast majority of people using Perl are in this

Re: Announcing the Perl 5 Documentation Team

2010-07-02 Thread Chas. Owens
On Fri, Jul 2, 2010 at 17:33, brian d foy brian.d@gmail.com wrote: In article aanlktimm-hiuf86ev9ykytsvpucpj1le7hatxbxnq...@mail.gmail.com, Chas. Owens chas.ow...@gmail.com wrote: No, you understood me, it is just that the FAQ doesn't do a good job for those two questions.  That is

Re: Announcing the Perl 5 Documentation Team

2010-07-01 Thread Ævar Arnfjörð Bjarmason
On Thu, Jul 1, 2010 at 17:18, Chas. Owens chas.ow...@gmail.com wrote: I am excited to announce the formation of the Perl 5 Documentation Team.  Our goal is to have the best, most current, and easiest to use and understand documentation of any programming language.  Why settle for small goals?

Re: Announcing the Perl 5 Documentation Team

2010-07-01 Thread Chas. Owens
On Thu, Jul 1, 2010 at 16:40, Paul Johnson p...@pjcj.net wrote: snip   * Updating the documentation so that all examples longer than one       line contain a `use` statement indicating the minimum version of       Perl 5 required to run the example I'm afraid that I don't think this is a

Re: Announcing the Perl 5 Documentation Team

2010-07-01 Thread Chas. Owens
On Thu, Jul 1, 2010 at 17:29, Ævar Arnfjörð Bjarmason ava...@gmail.com wrote: snip  * Extensive review and Modernization of all examples One thing I'd like to suggest. I think it'd improve our code examples a lot if we used a consistent style for them. By that I mostly mean not coding style