On Wed, Jul 15, 2009 at 5:35 PM, Gisle Aas<gi...@activestate.com> 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
