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 Alpha development will occur on major version 0, incrementing the
  16 minor version only until stability is reached.  This version will be
  17 declared stable, a new development branch will be started with major
  18 version 1, and patches to stable will increment its minor number.
  19
  20 Development will then continue on odd numbered major versions with incompatible
  21 changes allowed.  When stable, version 1.x will become 2.0, and the
  22 3.x branch will be opened.
  23
  24 Due to limitations in remaining portable across as many operating systems
  25 as possible, Barry will discontinue its 3-number version scheme as of
  26 version 0.4.
  27
  28