This is an old revision of the document!


PirateBox version-numbering

Version-Numbering after 1.0

With the release of PirateBox 1.0.0, we have instituted a new version-numbering scheme:

  • z.y.x
    • x = Bug-Fix release, that breaks no compatibility
    • y = Feature release, that is backward compatible (like deliver only configuration files for FTP-Server)
    • z = major release, that breaks backward compatibility (like adding FTP as default during bootup)
  • OpenWRT packages z.y.x-n
    • n is the release level of OpenWRT packages.
      • If there is a core issue within the OpenWRT runtime scripts, that number will be raized.

In short: If we release a 1.0.0 to 1.0.1 release, you don't need to reinstall the complete OpenWRT box.

In the future we are following these rules upon the versioning schema:

  • z.y. Version are compatible to each other, that means that
    • If we release a new x Bugfix release ( 1.0.0 → 1.0.1 ), then you can update a running PirateBox on OpenWRT with the updatePB command.
    • You don't need to reinstall the OpenWRT package
    • We won't publish a new x release on OpenWRT without an issue within the scripts
    • On other plattforms you have to exchange the complete scripts or adjust manually
  • Try to avoid unecessary reinstallation on OpenWRT-Systems
    • Raize Package-Version as less as possible
    • Do not align OpenWRT package versions against PirateBox-Core-package versions (see above)
  • z Releases deliver new core features, that changes backward capabilities significantly.

History

Before PirateBox release 0.6.3 on OpenWRT systems, the version-numbers were confusing. That is an result of supporting the following plattforms having its own special dependencies:

  • OpenWRT - Special installation scripts
  • Laptop - different init.d processes and do more network initialization
  • RaspberryPI - StartUp managemend sligtly different

With 0.6 release, we tried to tidy up the version numbers and align the first two digits, to a major release and only the last digit/letter may differ depending on system individual issues.

  • 0.6 ⇒ Release Step
  • 0.6 N ⇒ n = a letter core script fix-level
  • 0.6.1 ⇒ OpenWRT(System) package Fix-Level

One release-step is compatible to the decent fixes which follow up.