Note that there are some explanatory texts on larger screens.

plurals
  1. PO
    primarykey
    data
    text
    <p>My position is <em>keep it simple</em>. <strong>Declare your version as a string containing a floating point number.</strong> Leave the multiple-decimal stuff for Perl's version numbers and Perl 6.</p> <p>If your module requires Perl 5.6.0 or later:</p> <pre><code>our $VERSION = '1.02'; </code></pre> <p>Or, if you need to remain compatible with Perl 5.005 or older:</p> <pre><code>use vars '$VERSION'; $VERSION = '1.02'; </code></pre> <p>Some additional points:</p> <ol> <li><p><strong>Always use the same number of digits after the decimal point.</strong> Some (non-Perl) packaging tools think version 1.11 comes after 1.9 but before 1.90. If you need to change the number of digits you use, increment the major version number at the same time.</p></li> <li><p><strong>Always declare the version as a string.</strong> This keeps trailing zeros from disappearing. (See point 1.)</p></li> <li><p>If you want to make an unstable (e.g. alpha or beta) release, append the string <code>-TRIAL</code> to the <em>distribution's</em> version number (e.g. upload <code>Foo-Bar-1.90-TRIAL.tar.gz</code> containing Foo::Bar 1.90). This tells CPAN to list it as a development release, just as if it contained an underscore. <a href="http://search.cpan.org/perldoc?Dist::Zilla" rel="noreferrer">Dist::Zilla</a> makes it easy to make trial releases.</p></li> </ol> <p>A string containing a floating point number will work with all versions of Perl, all versions of MakeMaker &amp; Module::Build, and all Linux distributions I'm aware of.</p>
    singulars
    1. This table or related slice is empty.
    plurals
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. VO
      singulars
      1. This table or related slice is empty.
    2. VO
      singulars
      1. This table or related slice is empty.
    3. VO
      singulars
      1. This table or related slice is empty.
 

Querying!

 
Guidance

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload