doc/VersionNotes

   1 Barry is primarily intended to be a library, for any application to
   2 access Blackberry devices.  There will be an OpenSync module built
   3 on top of this, plus some command line utilities, and possibly a GUI,
   4 but initially Barry is a library, and must be versioned accordingly.
   5
   6 Additional applications built on top of Barry may be versioned separately.
   7
   8 Most operating systems can handle two library version numbers: major.minor.
   9 They use these numbers to determine which library is compatible
  10 and most recent.
  11
  12 Therefore Barry will be versioned the same way, the major version
  13 number indicating a backward incompatible change to the library.
  14
  15
  16 Version Numbering Plan:
  17 -----------------------
  18
  19         Alpha development will occur on major version 0, incrementing the
  20         minor version only until stability is reached.
  21
  22         When the 0.x series is stable, as a special case, the highest
  23         stable 0.x version will be released as version 1.00.  User-
  24         readable version strings in the library and applications will
  25         be changed to 1.00, 1.01, 1.02, 1.05, etc, but the library
  26         version in src/Makefile.am will stay on the 0.x series.
  27
  28         Bugfix releases for this stable series will continue from there,
  29         using 1.01 in user strings, and 0.x in the src/Makefile.am.
  30
  31         A new development branch will be started with the version 1.50,
  32         and both src/Makefile.am and the user strings will match again.
  33
  34         From then on, development will continue on odd numbered major
  35         versions with incompatible changes allowed.  When stable, version
  36         1.x will become 2.0, and the 3.x branch will be opened.
  37
  38 Due to limitations in remaining portable across as many operating systems
  39 as possible, Barry will discontinue its 3-number version scheme as of
  40 version 0.4.
  41
  42