home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / cware100.zip / RELEASE.DOC < prev   
Text File  |  1994-06-12  |  5KB  |  92 lines
  1. Release Information For Blue Bay Software
  2. ─────────────────────────────────────────
  3. The following information applies to all Blue Bay Software releases,
  4. documentation files and, if not distributed separately, data files.
  5.  
  6. Version Number Conventions
  7. ──────────────────────────
  8.    EXE and COM files will follow these 4 conventions in regards to version
  9.    numbers:
  10.    1) The major number (left of the decimal point) will denote an addition to
  11.       an existing piece of software that is easily visible to the user.
  12.       For example, the addition of a new menu item in a program will warrant a
  13.       release with a new major number.
  14.    2) The minor number (first number to the right of the decimal point) will
  15.       denote a change to the existing piece of software, either to fix
  16.       programming errors (bugs) or to enhance performance. Either way, the
  17.       changes to the software will generally not be visible to the user.
  18.       For example, if a program crashes under certain conditions, a new minor
  19.       number will be added and the program re-released. After 10 minor number
  20.       changes (0-9), software will be released with a new major number since
  21.       it obviously needed a major overhaul!
  22.    3) The micro number (second number to the right or a decimal point) will
  23.       denote a change in the software that will not be visible to the user and
  24.       will not change the execution of the program. This will usually be a
  25.       cosmetic change such as a change in colours, fonts, etc.
  26.    4) The preceeding three numbers will be released sequentially; that is, 2
  27.       after 1, 3 after 2, and so on. A 'ß' (beta) will follow releases that
  28.       have been tested very little before they were compiled.
  29.  
  30.  
  31.  
  32.       2.34
  33.       ^ ^^
  34.       | ||
  35.       | | \
  36.       | |  4 is the micro number
  37.       |  \
  38.       |   3 is the minor number
  39.        \
  40.         2 is the major number
  41.  
  42. Why should you care?
  43.  
  44.    To anyone who's had to put up with tonnes of releases by software authors on
  45.    BBSs, you will know that sometimes it's just not worth your time downloading
  46.    every new release. I have therefore taken the time to set up some system for
  47.    Blue Bay Software whereby you will know which software releases are of
  48.    interest to you. For example, if you want only software with new options, you
  49.    will wait for releases with a new major version. If you are having trouble
  50.    running the software due to run-time errors, you may wish to download
  51.    versions with with a new minor version. If you like purely cosmetic changes
  52.    in your software, a new micro version release may be for you. And finally,
  53.    if you enjoy running 'risky' software and seeing where it takes you, beta
  54.    versions are the thing for you.
  55.    Essentially, it's to make your life a little easier.
  56.  
  57. Version Numbers For Data Files
  58. ──────────────────────────────
  59.    If I take the time to release data files separately, it is usually because
  60.    they have to be updated every so often. It is this fact that makes the
  61.    version number on a datafile somewhat different.
  62.    A version number on a datafile will read like this : 12/25/94 : 1.02
  63.    The 12/25/94 is, as you may have guessed, the date of the release of the
  64.    datafile (December 25, 1994 in this case). It is followed by a semi-colon and
  65.    a release number. This release number tells you that this data file will work
  66.    properly on version 1.02 and up of the associated program. The reason that
  67.    this portion is added is because sometimes, as a result of additions to a
  68.    piece of software, the data structure of the data files will change as well,
  69.    and may cause problems if used with earlier versions of the software.
  70.  
  71. BBS Users
  72. ─────────
  73.    For those of you who obtained this software/data file from a BBS, you will
  74.    find this helpful next time you're searching through files on your local
  75.    BBS.
  76.    In every FILE_ID.DIZ and DESC.SDI file included with software/data files,
  77.    a line may be found that reads something like:
  78.  
  79.    .:BLUE BAY - DATA
  80.  
  81.    or
  82.  
  83.    .:BLUE BAY - SOFTWARE
  84.  
  85.    When conducting a file description search on the BBS, use one of the
  86.    preceeding as a search string. The DATA can be found on all Blue Bay Data
  87.    file descriptions, and the SOFTWARE can be found on all releases of Blue Bay
  88.    Software (as long as the FILE_ID.DIZ and DESC.SDI files were not tampered
  89.    with!). This being a distinctive 'calling card', so to speak, you should
  90.    find only Blue Bay products. This will speed up your online sessions quite a
  91.    bit by filtering out all files except those you seek.
  92.