You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@xalan.apache.org by db...@apache.org on 2002/08/07 06:58:18 UTC

cvs commit: xml-xalan/c/src/Include XalanVersion.hpp

dbertoni    2002/08/06 21:58:18

  Added:       c/src/Include XalanVersion.hpp
  Log:
  Initial revision.
  
  Revision  Changes    Path
  1.1                  xml-xalan/c/src/Include/XalanVersion.hpp
  
  Index: XalanVersion.hpp
  ===================================================================
  /*
   * The Apache Software License, Version 1.1
   *
   * Copyright (c) 2002 The Apache Software Foundation.  All rights
   * reserved.
   *
   * Redistribution and use in source and binary forms, with or without
   * modification, are permitted provided that the following conditions
   * are met:
   *
   * 1. Redistributions of source code must retain the above copyright
   *    notice, this list of conditions and the following disclaimer.
   *
   * 2. Redistributions in binary form must reproduce the above copyright
   *    notice, this list of conditions and the following disclaimer in
   *    the documentation and/or other materials provided with the
   *    distribution.
   *
   * 3. The end-user documentation included with the redistribution,
   *    if any, must include the following acknowledgment:
   *       "This product includes software developed by the
   *        Apache Software Foundation (http://www.apache.org/)."
   *    Alternately, this acknowledgment may appear in the software itself,
   *    if and wherever such third-party acknowledgments normally appear.
   *
   * 4. The names "Xalan" and "Apache Software Foundation" must
   *    not be used to endorse or promote products derived from this
   *    software without prior written permission. For written
   *    permission, please contact apache\@apache.org.
   *
   * 5. Products derived from this software may not be called "Apache",
   *    nor may "Apache" appear in their name, without prior written
   *    permission of the Apache Software Foundation.
   *
   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   * SUCH DAMAGE.
   * ====================================================================
   *
   * This software consists of voluntary contributions made by many
   * individuals on behalf of the Apache Software Foundation, and was
   * originally based on software copyright (c) 1999, International
   * Business Machines, Inc., http://www.ibm.com .  For more information
   * on the Apache Software Foundation, please see
   * <http://www.apache.org/>.
   */
  
  #if !defined(XALANVERSION_HEADER_GUARD_1357924680)
  #define XALANVERSION_HEADER_GUARD_1357924680
  
  // ---------------------------------------------------------------------------
  // X A L A N   V E R S I O N   H E A D E R   D O C U M E N T A T I O N
  
  /**
   * User Documentation for Xalan Version Values:
   *
   *  
   *
   * Xalan  Notes:
   *
   * Xalan Committers Documentation:
   *
   *    Xalan committers normally only need to modify one or two of the 
   *    following macros:
   *
   *      XALAN_VERSION_MAJOR
   *      XALAN_VERSION_MINOR
   *      XALAN_VERSION_REVISION
   *
   *    The integer values of these macros define the Xalan version number. All
   *    other constants and preprocessor macros are automatically generated from
   *    these three definitions.
   *
   * Xalan User Documentation:
   *
   *  The following sections in the user documentation have examples based upon
   *  the following three version input values:
   *
   *    #define XALAN_VERSION_MAJOR 19
   *    #define XALAN_VERSION_MINOR 3
   *    #define XALAN_VERSION_REVISION 74
   *
   *  The minor and revision (patch level) numbers have two digits of resolution
   *  which means that '3' becomes '03' in this example. This policy guarantees
   *  that when using preprocessor macros, version 19.3.74 will be greater than
   *  version 1.94.74 since the first will expand to 190374 and the second to
   *  19474.
   *
   *  Preprocessor Macros:
   *
   *    _XALAN_VERSION defines the primary preprocessor macro that users will
   *    introduce into their code to perform conditional compilation where the
   *    version of Xalan is detected in order to enable or disable version 
   *    specific capabilities. The value of _XALAN_VERSION for the above example
   *    will be 190374. To use it a user would perform an operation such as the
   *    following:
   *
   *      #if _XALAN_VERSION >= 190374
   *        // code specific to new version of Xalan...
   *      #else
   *        // old code here...
   *      #endif
   *
   *    XALAN_FULLVERSIONSTR is a preprocessor macro that expands to a string
   *    constant whose value, for the above example, will be "19_3_74".
   *
   *    XALAN_FULLVERSIONDOT is a preprocessor macro that expands to a string
   *    constant whose value, for the above example, will be "19.3.74".
   *
   *    XALAN_VERSIONSTR is a preprocessor macro that expands to a string
   *    constant whose value, for the above example, will be "19374". This 
   *    particular macro is very dangerous if it were to be used for comparing
   *    version numbers since ordering will not be guaranteed.
   *
   *    Xalan_DLLVersionStr is a preprocessor macro that expands to a string
   *    constant whose value, for the above example, will be "19_3_74". This
   *    macro is provided for backwards compatibility to pre-1.7 versions of
   *    Xalan.
   *
   *  String Constants:
   *
   *    gXalanVersionStr is a global string constant whose value corresponds to
   *    the value "19_3" for the above example.
   *
   *    gXalanFullVersionStr is a global string constant whose value corresponds
   *    to the value "19_3_74" for the above example. 
   *
   *  Numeric Constants:
   *
   *    gXalanMajVersion is a global integer constant whose value corresponds to
   *    the major version number. For the above example its value will be 19.
   *
   *    gXalanMinVersion is a global integer constant whose value corresponds to
   *    the minor version number. For the above example its value will be 3.
   *
   *    gXalanRevision is a global integer constant whose value corresponds to
   *    the revision (patch) version number. For the above example its value will
   *    be 74.
   *
   */
  
  // ---------------------------------------------------------------------------
  // X E R C E S   V E R S I O N   S P E C I F I C A T I O N
  
  /**
   * MODIFY THESE NUMERIC VALUES TO COINCIDE WITH XALAN VERSION
   * AND DO NOT MODIFY ANYTHING ELSE IN THIS VERSION HEADER FILE
   */
  
  #define XALAN_VERSION_MAJOR 1
  #define XALAN_VERSION_MINOR 4
  #define XALAN_VERSION_REVISION 0
  
  
  /** DO NOT MODIFY BELOW THIS LINE */
  
  /**
   * MAGIC THAT AUTOMATICALLY GENERATES THE FOLLOWING:
   *
   *	Xalan_DLLVersionStr, gXalanVersionStr, gXalanFullVersionStr,
   *	gXalanMajVersion, gXalanMinVersion, gXalanRevision
   */
  
  // ---------------------------------------------------------------------------
  // T W O   A R G U M E N T   C O N C A T E N A T I O N   M A C R O S
  
  // two argument concatenation routines
  #define CAT2_SEP_UNDERSCORE(a, b) #a "_" #b
  #define CAT2_SEP_PERIOD(a, b) #a "." #b
  #define CAT2_SEP_NIL(a, b) #a #b
  #define CAT2_RAW_NUMERIC(a, b) a ## b
  
  // two argument macro invokers
  #define INVK_CAT2_SEP_UNDERSCORE(a,b) CAT2_SEP_UNDERSCORE(a,b)
  #define INVK_CAT2_SEP_PERIOD(a,b)     CAT2_SEP_PERIOD(a,b)
  #define INVK_CAT2_STR_SEP_NIL(a,b)    CAT2_SEP_NIL(a,b)
  #define INVK_CAT2_RAW_NUMERIC(a,b)    CAT2_RAW_NUMERIC(a,b)
  
  // ---------------------------------------------------------------------------
  // T H R E E   A R G U M E N T   C O N C A T E N A T I O N   M A C R O S
  
  // three argument concatenation routines
  #define CAT3_SEP_UNDERSCORE(a, b, c) #a "_" #b "_" #c
  #define CAT3_SEP_PERIOD(a, b, c) #a "." #b "." #c
  #define CAT3_SEP_NIL(a, b, c) #a #b #c
  #define CAT3_RAW_NUMERIC(a, b, c) a ## b ## c
  
  // three argument macro invokers
  #define INVK_CAT3_SEP_UNDERSCORE(a,b,c) CAT3_SEP_UNDERSCORE(a,b,c)
  #define INVK_CAT3_SEP_PERIOD(a,b,c)     CAT3_SEP_PERIOD(a,b,c)
  #define INVK_CAT3_SEP_NIL(a,b,c)        CAT3_SEP_NIL(a,b,c)
  #define INVK_CAT3_RAW_NUMERIC(a,b,c)    CAT3_RAW_NUMERIC(a,b,c)
  
  // ---------------------------------------------------------------------------
  // C A L C U L A T E   V E R S I O N   -   E X P A N D E D   F O R M
  
  #define MULTIPLY(factor,value) factor * value
  #define CALC_EXPANDED_FORM(a,b,c) ( MULTIPLY(10000,a) + MULTIPLY(100,b) + MULTIPLY(1,c) )
  
  // ---------------------------------------------------------------------------
  // X E R C E S   V E R S I O N   I N F O R M A T I O N
  
  // Xalan version strings; these particular macros cannot be used for
  // conditional compilation as they are not numeric constants
  
  #define XALAN_FULLVERSIONSTR INVK_CAT3_SEP_UNDERSCORE(XALAN_VERSION_MAJOR,XALAN_VERSION_MINOR,XALAN_VERSION_REVISION)
  #define XALAN_FULLVERSIONDOT INVK_CAT3_SEP_PERIOD(XALAN_VERSION_MAJOR,XALAN_VERSION_MINOR,XALAN_VERSION_REVISION)
  #define XALAN_FULLVERSIONNUM INVK_CAT3_SEP_NIL(XALAN_VERSION_MAJOR,XALAN_VERSION_MINOR,XALAN_VERSION_REVISION)
  #define XALAN_VERSIONSTR     INVK_CAT2_SEP_UNDERSCORE(XALAN_VERSION_MAJOR,XALAN_VERSION_MINOR)
  
  // original from Xalan header
  #define Xalan_DLLVersionStr XALAN_FULLVERSIONSTR
  
  const char* const    gXalanVersionStr = XALAN_VERSIONSTR;
  const char* const    gXalanFullVersionStr = XALAN_FULLVERSIONSTR;
  const unsigned int   gXalanMajVersion = XALAN_VERSION_MAJOR;
  const unsigned int   gXalanMinVersion = XALAN_VERSION_MINOR;
  const unsigned int   gXalanRevision   = XALAN_VERSION_REVISION;
  
  // Xalan version numeric constants that can be used for conditional
  // compilation purposes.
  
  #define _XALAN_VERSION CALC_EXPANDED_FORM (XALAN_VERSION_MAJOR,XALAN_VERSION_MINOR,XALAN_VERSION_REVISION)
  
  #endif // XALANVERSION_HEADER_GUARD_1357924680
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: xalan-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: xalan-cvs-help@xml.apache.org