ginac/version.h

   1 /** @file version.h
   2  *
   3  *  GiNaC library version information. */
   4
   5 /*
   6  *  GiNaC Copyright (C) 1999-2020 Johannes Gutenberg University Mainz, Germany
   7  *
   8  *  This program is free software; you can redistribute it and/or modify
   9  *  it under the terms of the GNU General Public License as published by
  10  *  the Free Software Foundation; either version 2 of the License, or
  11  *  (at your option) any later version.
  12  *
  13  *  This program is distributed in the hope that it will be useful,
  14  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  *  GNU General Public License for more details.
  17  *
  18  *  You should have received a copy of the GNU General Public License
  19  *  along with this program; if not, write to the Free Software
  20  *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
  21  */
  22
  23 #ifndef GINAC_VERSION_H
  24 #define GINAC_VERSION_H
  25
  26 /* Major version of GiNaC */
  27 #define GINACLIB_MAJOR_VERSION 1
  28
  29 /* Minor version of GiNaC */
  30 #define GINACLIB_MINOR_VERSION 7
  31
  32 /* Micro version of GiNaC */
  33 #define GINACLIB_MICRO_VERSION 8
  34
  35 // GiNaC library version information. It has very little to do with GiNaC
  36 // version number. In particular, library version is OS dependent.
  37 //
  38 // When making releases, do
  39 // 1. Increment GINAC_LT_REVISION
  40 // 2. If any interfaces have been added, removed, or changed since the last
  41 //    release, increment GINAC_LT_CURRENT and set GINAC_LT_REVISION to 0.
  42 // 3. If any interfaces have been added since the last release, increment
  43 //    GINAC_LT_AGE.
  44 // 4. If any interfaces have been removed since the last release, set
  45 //    GINAC_LT_AGE to 0.
  46 //
  47 // Please note: the libtool naming scheme cannot guarantee that on all
  48 // systems, the numbering is consecutive. It only guarantees that it is
  49 // increasing. This doesn't matter, though: there is not incurred cost
  50 // for numbers that are omitted, except for shrinking the available space
  51 // of leftover numbers. Not something we need to worry about yet. ;-)
  52 // TODO, when setting GINAC_LT_REVISION to 0:
  53 //  * change matrix inverse to use default argument (twice)
  54 //  * remove interfaces marked as deprecated
  55 #define GINAC_LT_CURRENT  10
  56 #define GINAC_LT_REVISION 2
  57 #define GINAC_LT_AGE      4
  58
  59 /*
  60  * GiNaC archive file version information.
  61  *
  62  * The current archive version is GINACLIB_ARCHIVE_VERSION. This is
  63  * the version of archives created by the current version of GiNaC.
  64  * Archives version (GINACLIB_ARCHIVE_VERSION - GINACLIB_ARCHIVE_AGE)
  65  * thru * GINACLIB_ARCHIVE_VERSION can be read by current version
  66  * of GiNaC.
  67  *
  68  * Backward compatibility notes:
  69  * If new properties have been added:
  70  *      GINACLIB_ARCHIVE_VERSION += 1
  71  *      GINACLIB_ARCHIVE_AGE += 1
  72  * If backwards compatibility has been broken, i.e. some properties
  73  * has been removed, or their type and/or meaning changed:
  74  *      GINACLIB_ARCHIVE_VERSION += 1
  75  *      GINACLIB_ARCHIVE_AGE = 0
  76  */
  77 #define GINACLIB_ARCHIVE_VERSION 3
  78 #define GINACLIB_ARCHIVE_AGE 3
  79
  80 #define GINACLIB_STR_HELPER(x) #x
  81 #define GINACLIB_STR(x) GINACLIB_STR_HELPER(x)
  82 #define GINACLIB_VERSION \
  83         GINACLIB_STR(GINACLIB_MAJOR_VERSION) "." \
  84         GINACLIB_STR(GINACLIB_MINOR_VERSION) "." \
  85         GINACLIB_STR(GINACLIB_MICRO_VERSION)
  86
  87 namespace GiNaC {
  88
  89 extern const int version_major;
  90 extern const int version_minor;
  91 extern const int version_micro;
  92
  93 } // namespace GiNaC
  94
  95 #endif // ndef GINAC_VERSION_H