Re: version-0.77 and You

On Wed, Jul 15, 2009 at 5:35 PM, Gisle Aas<[email protected]> wrote:
> I think the term "dotted-decimal" is pretty confusing, especially when what
> you contrast that with is "decimal version numbers" (which includes a dot).
>  I suggest you call it "integers separated by dots" or "dotted-integers" for
> short.

+1 for "dotted-integers"

>I also think it would be a good idea to define early what this means instead of just assuming that's understood.

I normally would agree, but the definitions are a bit complicated. I
intentionally left stuff for later because I didn't want people to
stop reading before they got to the big "DONT SCREW THIS UP" parts.

> In the section about declaring versions in the traditional way (using
> decimal $VERSION) I suggest it's presented in the string form:
>    our $VERSION = "1.02";
> This is the recommended form as you don't get surprises when the version
> number turns into "1.10".

Good catch!  That's a great suggestion.  I debated getting into the
alphas/eval stuff, but decided to leave it out of version.pm
documentation.  It'll be in my blog article I'm working on, though.

David