Re: Announcing the Perl 5 Documentation Team

2010-07-01 Thread Chas. Owens
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 statements to examples that need features in 5.10 or later. -- Chas. Owens wonkden.net The most

Re: Announcing the Perl 5 Documentation Team

2010-07-01 Thread Chas. Owens
or improved? snip These are the sort of things that cause this to be a long term goal. One of my first thoughts was that we should just machine translate the whole of the documentation into a bunch of languages and then let people apply patches to correct the hilariously bad machine translations. -- Chas

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

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: up to date archive?

2010-07-02 Thread Chas. Owens
to be working, but it isn't showing all of the emails I sent yesterday (including the I want to sign up email). I am going to try resending now. -- Chas. Owens wonkden.net The most important skill a programmer can have is the ability to read.

Proposed logo and/or mascot

2010-07-02 Thread Chas. Owens
of artwork. -- Chas. Owens wonkden.net The most important skill a programmer can have is the ability to read.

Proposed activities of the Perl 5 Doc Team

2010-07-02 Thread Chas. Owens
-- Chas. Owens wonkden.net The most important skill a programmer can have is the ability to read.

Proposed FAQ

2010-07-02 Thread Chas. Owens
Pumppawn 1.8 - Who/What is a Pumppawn The Pumppawn is a minion of the Pumpking, and is responsible for the Documentation Team. The current Pumppawn is Chas. Owens (chas.ow...@gmail.com). The Pumppawn can be replaced at the desire of the Pumpking (currently Jesse Vincent) or a majority

Proposed documenting of documentation changes

2010-07-02 Thread Chas. Owens
perlfuncref This is a Perl 5 function quick reference =head2 Changed Documentation =over =item perlop Note the existence of perlopref =item perlfunc Note the existence of perlfuncref =back -- Chas. Owens wonkden.net The most important skill a programmer can have is the ability to read.

Current assignments list as of 2010-07-02 17:00 UTC

2010-07-02 Thread Chas. Owens
that will go into perlopref -- Chas. Owens wonkden.net The most important skill a programmer can have is the ability to read.

Re: Proposed documentation guidelines

2010-07-02 Thread Chas. Owens
On Jul 2, 2010, at 12:46, Leon Timmermans faw...@gmail.com wrote: On Fri, Jul 2, 2010 at 5:17 PM, Chas. Owens chas.ow...@gmail.com wrote: I need to look through what is done today before I put up my version of the guidelines, but if you are already familiar with the way Pod is used

Re: I want to sign up

2010-07-02 Thread Chas. Owens
it is in now. I figure it is going to take that long or longer for each of the other documents that need massive overhauling as well. I am going for a slow and steady approach. So long as we see some forward progress I will be happy. -- Chas. Owens wonkden.net The most important skill a programmer can

Re: I want to sign up

2010-07-02 Thread Chas. Owens
On Fri, Jul 2, 2010 at 14:35, Caleb Cushing xenoterrac...@gmail.com wrote: On Fri, Jul 2, 2010 at 10:03 AM, Chas. Owens chas.ow...@gmail.com wrote: If you want to sign up for the Perl 5 Documentation Team, leave an email here or email me directly.  If you know what you want to work on mention

Re: Short term goals

2010-07-02 Thread Chas. Owens
On Fri, Jul 2, 2010 at 15:32, Ronald J Kimball r...@tamias.net wrote: On Fri, Jul 02, 2010 at 11:19:02AM -0400, Chas. Owens wrote:  * Create perlfuncref (deadline 2010-10-31) I note that perlfuncref.pod would not be unique within the 8.3 naming convention, so it may not be a suitable name

Re: I want to sign up

2010-07-02 Thread Chas. Owens
On Fri, Jul 2, 2010 at 16:16, Nuno 'smash' Carvalho mestre.sm...@gmail.com wrote: Greetings, On Fri, Jul 2, 2010 at 7:54 PM, Chas. Owens chas.ow...@gmail.com wrote: On Fri, Jul 2, 2010 at 14:35, Caleb Cushing xenoterrac...@gmail.com wrote: On Fri, Jul 2, 2010 at 10:03 AM, Chas. Owens chas.ow

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

Re: Current state of Perl 5 Documentation Team

2010-08-08 Thread Chas. Owens
On Sat, Aug 7, 2010 at 11:03, Maik Hentsche m...@mm-double.de wrote: Chas. Owens chas.ow...@gmail.com wrote: If you want a task, just speak up, there is still lots to do. I do. I'm not a native speaker so a little help with phrasing certain things would be welcome. Do we already have an IRC

Re: Current state of Perl 5 Documentation Team

2010-08-08 Thread Chas. Owens
On Sun, Aug 8, 2010 at 01:40, Ali Nabavi a...@alijnabavi.info wrote: On Sat, Aug 7, 2010 at 10:42, Chas. Owens chas.ow...@gmail.com wrote: Currently a bunch of people are working on getting perlopquick into shape to replace perlop and I am slowly applying them.  You can follow the progress

Re: Documentation for ${^GLOBAL_PHASE}

2010-11-12 Thread Chas. Owens
On Fri, Nov 12, 2010 at 16:52, Florian Ragwitz r...@debian.org wrote: Chas. Owens chas.ow...@gmail.com writes: I have attached my first draft of the documentation (they include brian d foy's changes from last night). So i've tried to prepare a new branch with the original patch set rebased

Re: new package syntax, where do I return true?

2011-07-02 Thread Chas. Owens
would argue that package Foo { } 1; is more correct. -- Chas. Owens wonkden.net The most important skill a programmer can have is the ability to read.

Re: new package syntax, where do I return true?

2011-07-02 Thread Chas. Owens
On Sat, Jul 2, 2011 at 08:53, Chas. Owens chas.ow...@gmail.com wrote: On Sat, Jul 2, 2011 at 00:00, Caleb Cushing xenoterrac...@gmail.com wrote: Having a little debate over this on a Perl::Critic ticket. I'm not sure anyone is sure and the docs don't say. https://rt.cpan.org/Ticket