Re: version-0.77 and You

Front page | perl.perl5.porters | Postings from July 2009

Re: version-0.77 and You

Thread Previous | Thread Next

From:

Gisle Aas

Date:

July 15, 2009 13:44

Subject:

Re: version-0.77 and You

Message ID:

FBCB2632-A9B9-467C-A8A4-26AF1B4CD0A1@activestate.com

I would suggest that you bump the version number of version to 1.00 so  
that becomes the recommended minimal number instead of an arbitrary  
number like 0.77; making the recommended invocation:

    use version 1.00;  $our $VERSION = qw("v1.2.3");

This still confuses me as I think that:

     use version 1.00;

ought to be handy way to declare your own $VERSION, not about  
requesting a specific version of version.

--Gisle


On Jul 15, 2009, at 20:08 , David Golden wrote:

> On Wed, Jul 15, 2009 at 10:13 AM, David Golden <xdaveg@gmail.com>  
> wrote:
>
> Easiest is just to park it on the QA wiki, I think.  Maybe hang it  
> off the toolchain roadmap page?
>
> A copy of my edits is attached and I've put a copy on the QA Wiki:
>
> http://perl-qa.hexten.net/wiki/index.php/Version_POD
>
> My goal with this structural revision was assuming the people don't  
> read docs (much) so trying to have a very logical top-down structure  
> from the table of contents (as created by search.cpan.org).  I  
> tested the pod on search here: http://search.cpan.org/pod2html
>
> I expanded on the synopses a bit and I also tried to make sure that  
> good practices were reflected consistently and I removed some text  
> about bad practices for brevity. For example, I removed the new()  
> method description since we want to discourage its use anyway.
>
> Most of the text is still John's -- I mostly re-arranged and  
> streamlined.  In a couple areas (parsing & comparison) I wrote new  
> text.  In some other areas (eg. alphas) I copied text from the  
> Internals POD and then edited to fit.
>
> John -- I hope you see this as a step forward.  I think it will be  
> much more prescriptive in describing how people should use  
> version.pm -- and then the more detailed Internals POD is there for  
> those who really need to see it.
>
> -- David
>
> <version.pod>

Thread Previous | Thread Next