Annotation of win32/apache22/srclib/apr-util/include/apu_version.h, revision 1.1
1.1 ! moko 1: /* Licensed to the Apache Software Foundation (ASF) under one or more
! 2: * contributor license agreements. See the NOTICE file distributed with
! 3: * this work for additional information regarding copyright ownership.
! 4: * The ASF licenses this file to You under the Apache License, Version 2.0
! 5: * (the "License"); you may not use this file except in compliance with
! 6: * the License. You may obtain a copy of the License at
! 7: *
! 8: * http://www.apache.org/licenses/LICENSE-2.0
! 9: *
! 10: * Unless required by applicable law or agreed to in writing, software
! 11: * distributed under the License is distributed on an "AS IS" BASIS,
! 12: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
! 13: * See the License for the specific language governing permissions and
! 14: * limitations under the License.
! 15: */
! 16:
! 17: #ifndef APU_VERSION_H
! 18: #define APU_VERSION_H
! 19:
! 20: /**
! 21: * @file apu_version.h
! 22: * @brief APR-util Versioning Interface
! 23: *
! 24: * APR-util's Version
! 25: *
! 26: * There are several different mechanisms for accessing the version. There
! 27: * is a string form, and a set of numbers; in addition, there are constants
! 28: * which can be compiled into your application, and you can query the library
! 29: * being used for its actual version.
! 30: *
! 31: * Note that it is possible for an application to detect that it has been
! 32: * compiled against a different version of APU by use of the compile-time
! 33: * constants and the use of the run-time query function.
! 34: *
! 35: * APU version numbering follows the guidelines specified in:
! 36: *
! 37: * http://apr.apache.org/versioning.html
! 38: */
! 39:
! 40:
! 41: /* The numeric compile-time version constants. These constants are the
! 42: * authoritative version numbers for APU.
! 43: */
! 44:
! 45: /** major version
! 46: * Major API changes that could cause compatibility problems for older
! 47: * programs such as structure size changes. No binary compatibility is
! 48: * possible across a change in the major version.
! 49: */
! 50: #define APU_MAJOR_VERSION 1
! 51:
! 52: /** minor version
! 53: * Minor API changes that do not cause binary compatibility problems.
! 54: * Reset to 0 when upgrading APU_MAJOR_VERSION
! 55: */
! 56: #define APU_MINOR_VERSION 5
! 57:
! 58: /** patch level
! 59: * The Patch Level never includes API changes, simply bug fixes.
! 60: * Reset to 0 when upgrading APR_MINOR_VERSION
! 61: */
! 62: #define APU_PATCH_VERSION 2
! 63:
! 64: /**
! 65: * The symbol APU_IS_DEV_VERSION is only defined for internal,
! 66: * "development" copies of APU. It is undefined for released versions
! 67: * of APU.
! 68: */
! 69: /* #define APU_IS_DEV_VERSION */
! 70:
! 71:
! 72: #if defined(APU_IS_DEV_VERSION) || defined(DOXYGEN)
! 73: /** Internal: string form of the "is dev" flag */
! 74: #define APU_IS_DEV_STRING "-dev"
! 75: #else
! 76: #define APU_IS_DEV_STRING ""
! 77: #endif
! 78:
! 79:
! 80: #ifndef APU_STRINGIFY
! 81: /** Properly quote a value as a string in the C preprocessor */
! 82: #define APU_STRINGIFY(n) APU_STRINGIFY_HELPER(n)
! 83: /** Helper macro for APU_STRINGIFY */
! 84: #define APU_STRINGIFY_HELPER(n) #n
! 85: #endif
! 86:
! 87: /** The formatted string of APU's version */
! 88: #define APU_VERSION_STRING \
! 89: APU_STRINGIFY(APU_MAJOR_VERSION) "." \
! 90: APU_STRINGIFY(APU_MINOR_VERSION) "." \
! 91: APU_STRINGIFY(APU_PATCH_VERSION) \
! 92: APU_IS_DEV_STRING
! 93:
! 94: /** An alternative formatted string of APR's version */
! 95: /* macro for Win32 .rc files using numeric csv representation */
! 96: #define APU_VERSION_STRING_CSV APU_MAJOR_VERSION ##, \
! 97: ##APU_MINOR_VERSION ##, \
! 98: ##APU_PATCH_VERSION
! 99:
! 100:
! 101: #ifndef APU_VERSION_ONLY
! 102:
! 103: /* The C language API to access the version at run time,
! 104: * as opposed to compile time. APU_VERSION_ONLY may be defined
! 105: * externally when preprocessing apr_version.h to obtain strictly
! 106: * the C Preprocessor macro declarations.
! 107: */
! 108:
! 109: #include "apr_version.h"
! 110:
! 111: #include "apu.h"
! 112:
! 113: #ifdef __cplusplus
! 114: extern "C" {
! 115: #endif
! 116:
! 117: /**
! 118: * Return APR-util's version information information in a numeric form.
! 119: *
! 120: * @param pvsn Pointer to a version structure for returning the version
! 121: * information.
! 122: */
! 123: APU_DECLARE(void) apu_version(apr_version_t *pvsn);
! 124:
! 125: /** Return APU's version information as a string. */
! 126: APU_DECLARE(const char *) apu_version_string(void);
! 127:
! 128: #ifdef __cplusplus
! 129: }
! 130: #endif
! 131:
! 132: #endif /* ndef APU_VERSION_ONLY */
! 133:
! 134: #endif /* ndef APU_VERSION_H */
E-mail:
![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to apu_version.h CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [parser3project] / win32 / apache22 / srclib / apr-util / include