diff options
Diffstat (limited to 'include/ruby/version.h')
| -rw-r--r-- | include/ruby/version.h | 159 |
1 files changed, 37 insertions, 122 deletions
diff --git a/include/ruby/version.h b/include/ruby/version.h index e9113177de..10b1b05436 100644 --- a/include/ruby/version.h +++ b/include/ruby/version.h @@ -1,17 +1,17 @@ -#ifndef RUBY_VERSION_H /*-*-C++-*-vi:se ft=cpp:*/ -#define RUBY_VERSION_H 1 -/** - * @file - * @author $Author$ - * @date Wed May 13 12:56:56 JST 2009 - * @copyright Copyright (C) 1993-2009 Yukihiro Matsumoto - * @copyright Copyright (C) 2000 Network Applied Communication Laboratory, Inc. - * @copyright Copyright (C) 2000 Information-technology Promotion Agency, Japan - * @copyright This file is a part of the programming language Ruby. - * Permission is hereby granted, to either redistribute and/or - * modify this file, provided that the conditions mentioned in the - * file COPYING are met. Consult the file for details. - * +/********************************************************************** + + ruby/version.h - + + $Author$ + created at: Wed May 13 12:56:56 JST 2009 + + Copyright (C) 1993-2009 Yukihiro Matsumoto + Copyright (C) 2000 Network Applied Communication Laboratory, Inc. + Copyright (C) 2000 Information-technology Promotion Agency, Japan + +**********************************************************************/ + +/* * This file contains only * - never-changeable information, and * - interfaces accessible from extension libraries. @@ -20,140 +20,55 @@ * check the features with mkmf.rb instead. */ -/** - * @name The origin. - * - * These information never change. Just written here to remember. - * - * @{ - */ +#ifndef RUBY_VERSION_H +#define RUBY_VERSION_H 1 -/** Author of this project. */ +/* The origin. */ #define RUBY_AUTHOR "Yukihiro Matsumoto" - -/** Ruby's birth year. */ #define RUBY_BIRTH_YEAR 1993 - -/** Ruby's birth month. */ #define RUBY_BIRTH_MONTH 2 - -/** Ruby's birth day. */ #define RUBY_BIRTH_DAY 24 -/** @} */ - -/** - * @name The API version. - * - * API version is different from binary version. These numbers are for API - * stability. When you have distinct API versions x and y, you cannot expect - * codes targeted to x also works for y. - * - * However let us repeat here that it's a BAD idea to check - * #RUBY_API_VERSION_CODE form extension libraries. Different API versions are - * just different. There is no such thing like upper compatibility. - * - * @{ - */ - -/** - * Major version. This digit changes sometimes for various reasons, but that - * doesn't mean a total rewrite. Practically when it comes to API versioning, - * major and minor version changes are equally catastrophic. - */ -#define RUBY_API_VERSION_MAJOR 3 - -/** - * Minor version. As of writing this version changes annually. Greater - * version doesn't mean "better"; they just mean years passed. - */ -#define RUBY_API_VERSION_MINOR 4 - -/** - * Teeny version. This digit is kind of reserved these days. Kept 0 for the - * entire 2.x era. Waiting for future uses. - */ +/* API version */ +#define RUBY_API_VERSION_MAJOR 2 +#define RUBY_API_VERSION_MINOR 5 #define RUBY_API_VERSION_TEENY 0 - -/** - * This macro is API versions encoded into a C integer. - * - * @note Use mkmf. - * @note Don't rely on it. - */ #define RUBY_API_VERSION_CODE (RUBY_API_VERSION_MAJOR*10000+RUBY_API_VERSION_MINOR*100+RUBY_API_VERSION_TEENY) -/** @} */ - #ifdef RUBY_EXTERN -/* Internal note: this file could be included from verconf.mk _before_ - * generating config.h, on Windows. The #ifdef above is to trick such - * situation. */ -RBIMPL_SYMBOL_EXPORT_BEGIN() +#if defined(__cplusplus) +extern "C" { +#if 0 +} /* satisfy cc-mode */ +#endif +#endif + +RUBY_SYMBOL_EXPORT_BEGIN -/** - * @name Interfaces from extension libraries. +/* + * Interfaces from extension libraries. * * Before using these infos, think thrice whether they are really * necessary or not, and if the answer was yes, think twice a week * later again. - * - * @{ */ - -/** API versions, in { major, minor, teeny } order. */ RUBY_EXTERN const int ruby_api_version[3]; - -/** - * Stringised version. - * - * @note This is the runtime version, not the API version. For instance it - * was `"2.5.9"` when ::ruby_api_version was `{ 2, 5, 0 }`. - */ RUBY_EXTERN const char ruby_version[]; - -/** Date of release, in a C string. */ RUBY_EXTERN const char ruby_release_date[]; - -/** - * Target platform identifier, in a C string. - * - * @note Seasoned UNIX programmers should beware that this "platform - * identifier" is our invention; not always identical to so-called - * target triplets that GNU systems use. For instance on @shyouhei's - * machine, ::ruby_platform is `"x64_64-linux"` while its target triplet - * is `x86_64-pc-linux-gnu`. - * @note Note also that we support Windows. - */ RUBY_EXTERN const char ruby_platform[]; - -/** - * This is a monotonic increasing integer that describes specific "patch" - * level. You can know the exact changeset your binary is running by this info - * (and ::ruby_version), unless this is -1. -1 means there is no release yet - * for the version; ruby is actively developed. 0 means the initial GA version. - */ RUBY_EXTERN const int ruby_patchlevel; - -/** - * This is what `ruby -v` prints to the standard error. Something like: - * `"ruby 2.5.9p229 (2021-04-05 revision 67829) [x86_64-linux]"`. This doesn't - * include runtime options like a JIT being enabled. - */ RUBY_EXTERN const char ruby_description[]; - -/** Copyright notice. */ RUBY_EXTERN const char ruby_copyright[]; - -/** - * This is just `"ruby"` for us. But different implementations can have - * different strings here. - */ RUBY_EXTERN const char ruby_engine[]; -/** @} */ +RUBY_SYMBOL_EXPORT_END -RBIMPL_SYMBOL_EXPORT_END() +#if defined(__cplusplus) +#if 0 +{ /* satisfy cc-mode */ +#endif +} /* extern "C" { */ +#endif #endif #endif |