Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
docs:version_numbers [2013/12/03 20:24] matthias created |
docs:version_numbers [2014/05/06 18:57] (current) darts |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== PirateBox version-numbering ====== | ====== PirateBox version-numbering ====== | ||
===== Version-Numbering after 1.0 ===== | ===== Version-Numbering after 1.0 ===== | ||
- | With the release of PirateBox 1.0.0 step over a version schema, which is quite common across open-source software | + | With the release of PirateBox 1.0.0, we have instituted a new version-numbering scheme: |
* z.y.x | * z.y.x | ||
Line 9: | Line 9: | ||
* OpenWRT packages z.y.x-n | * OpenWRT packages z.y.x-n | ||
* n is the release level of OpenWRT packages. | * n is the release level of OpenWRT packages. | ||
- | * If there is a core issue within the OpenWRT runtime scripts, that number will be raized. | + | * If there is a core issue within the OpenWRT runtime scripts, that version number will be increased. |
- | In the future we are following these rules upon the versioning schema: | + | In short, a change from 1.0.0 to 1.0.1 will not require a complete re-install. |
- | * z.y. Version are compatible to each other, that means that | + | Moving forward, we will apply the following rules to the PirateBox version numbering: |
- | * If we release a new x Bugfix release ( 1.0.0 -> 1.0.1 ), then you can update a running PirateBox on [[openwrt:update_image_only]]OpenWRT with the updatePB command]]. | + | |
+ | * z.y. Version are compatible with each other, which means: | ||
+ | * If we release a new x Bugfix release ( 1.0.0 -> 1.0.1 ), then you can update a running PirateBox with a simple update command. | ||
* You don't need to reinstall the OpenWRT package | * 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 | * 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 | + | * On other platforms you have to exchange the complete scripts or adjust manually |
- | * Try to avoid unecessary reinstallation on OpenWRT-Systems | + | * Try to avoid unnecessary re-installation on OpenWRT-Systems |
- | * Raize Package-Version as less as possible | + | * Raise Package-Version as little as possible |
* Do not align OpenWRT package versions against PirateBox-Core-package versions (see above) | * Do not align OpenWRT package versions against PirateBox-Core-package versions (see above) | ||
* z Releases deliver new core features, that changes backward capabilities significantly. | * z Releases deliver new core features, that changes backward capabilities significantly. | ||
- | |||
===== History ===== | ===== 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: | + | Before PirateBox release 0.6.3 on OpenWRT systems, the version-numbering system was confusing. That is a result of supporting the following platforms having its own special dependencies: |
* OpenWRT - Special installation scripts | * OpenWRT - Special installation scripts | ||
Line 32: | Line 33: | ||
* RaspberryPI - StartUp managemend sligtly different | * 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. | + | With the 0.6 release, we cleaned up the version numbers and aligned 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 => Release Step | ||
* 0.6 N => n = a letter core script fix-level | * 0.6 N => n = a letter core script fix-level | ||
* 0.6.1 => OpenWRT(System) package Fix-Level | * 0.6.1 => OpenWRT(System) package Fix-Level | ||
- | |||
- | One release-step is compatible to the decent fixes which follow up. | ||