On Jul 15, 2009, at 20:08 , David Golden wrote:
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
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. I also think it would be a good idea
to define early what this means instead of just assuming that's
understood.
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".
Instead of saying that you can keep doing this if you "do not intend
to _ever_ change that", just say that there is no reason to use
version unless you prefer the "dotted-integers" form.
--Gisle
