devspec.en_US/6.1.version-code.md

   1 \r
   2 \r
   3 # version code\r
   4 ==============\r
   5 \r
   6     every soft-pkg uses tree stage version code.\r
   7         the first id is main version id, it shows the main architecture of a soft\r
   8 pkg.\r
   9     the second id is function feature version id. it shows function feature\r
  10 appended.\r
  11     the third id is patch version id. when the function feature version is \r
  12 improved, increase patch version id for it.\r
  13     the fourth id is publish date string. it save date info for a version code.\r
  14 \r
  15     syntax:\r
  16 v1.1.1-20221122-LTS\r
  17 v<VER1>.<VER2>.<VER3>-<VDATE>[-<VSFX>]\r
  18 VER1: main version code, it means the architecture of the src-pkg.\r
  19 VER2: minor version code, function feature version code. increase it when the\r
  20       new feature is appended.\r
  21 VER3: patch version code, it means that some bug or little improve is patched\r
  22       into the src-pkg.\r
  23 VDATA:publish date version code, others can read the date info clearly.\r
  24 VSFX: suffix version code, it's the assistant version info for a src-pkg. the\r
  25       classical sfx 'LTS' means 'long time support', and it will be supported\r
  26           in several years. 'vX.0.X' must be a 'LTS' version, it's an actual\r
  27           meaning of publish version for src-pkg, and defined the external function\r
  28           or cmdline interface.\r
  29 \r
  30 # auto tools\r
  31 ============\r
  32 \r
  33     version id is managed by 'versionid' script program in devutils. it \r
  34 increase different stage of version id, and searching version info in src dir,\r
  35 modify them at the same time.\r
  36     this program will be integrated in build-pkg, it's a sub-cmd of build-pkg.\r
  37 \r
  38 \r