Author: sebor Date: Thu Apr 24 13:08:41 2008 New Revision: 651377 URL: http://svn.apache.org/viewvc?rev=651377&view=rev Log: 2008-04-24 Martin Sebor <[EMAIL PROTECTED]>
* README (Disclaimer): Removed incubation disclaimer. (Contents, Library Installation on UNIX Systems): Updated library version number. (Compatibility): Updated. (Unpacking Instructions): Removed "incubating." (Test Suite Files): Removed references to end users. (C Library Configuration Macros): Added _RWSTD_NO_EQUAL_CTYPE_MASK. (Platform Identification Macros): Added a few more examples. (Platform Notes): Updated with latest tested platforms. Replaced references to AMD64 and EM64T with the generic x86_64. Modified: stdcxx/branches/4.2.x/README Modified: stdcxx/branches/4.2.x/README URL: http://svn.apache.org/viewvc/stdcxx/branches/4.2.x/README?rev=651377&r1=651376&r2=651377&view=diff ============================================================================== --- stdcxx/branches/4.2.x/README (original) +++ stdcxx/branches/4.2.x/README Thu Apr 24 13:08:41 2008 @@ -1,31 +1,12 @@ $Id$ - Apache C++ Standard Library (STDCXX) 4.2.0 + Apache C++ Standard Library (STDCXX) 4.2.1 ------------------------------------------ - i. Disclaimer - ------------- - - The ASF Incubation Policy requires every Podling (project of the - Apache Incubator) to include a clear disclaimer on its Web site and - in all documentation stating that it is undergoing incubation. The - following is the text of the required disclaimer. - - STDCXX is an effort undergoing incubation at the Apache Software - Foundation (ASF), sponsored by the Apache Incubator PMC. Incubation - is required of all newly accepted projects until a further review - indicates that the infrastructure, communications, and decision - making process have stabilized in a manner consistent with other - successful ASF projects. While incubation status is not necessarily - a reflection of the completeness or stability of the code, it does - indicate that the project has yet to be fully endorsed by the ASF. - - 0 Index -------- - Disclaimer ....................................................... i Index ............................................................ 0 Contents ......................................................... 1 Compatibility ................................................ 1.1 @@ -84,7 +65,7 @@ 1 Contents ----------- - This file is part of version 4.2.0 of the Apache C++ Standard + This file is part of version 4.2.1 of the Apache C++ Standard Library (STDCXX), an Open Source implementation of the C++ Standard Library conforming to INCITS/ISO/IEC 14882-2003 Programming Languages -- C++. @@ -115,19 +96,15 @@ 1.1 Compatibility ------------------ - This version of the library is source and binary compatible with all - previous 4.x releases. Programs compiled and linked with previous - versions of the (shared) library within the 4.x lineage will - continue to link and work correctly when linked with this version of - the library (this is sometimes referred to a backward - compatibility), provided the same compiler is used to compile both - the programs and the library. Changing the compiler or its version - may have an impact on the binary compatibility of the generated - object code. Programs compiled and linked with this version of the - library may not link with with prior versions of the library, or may - not operate correctly (this is sometimes referred to as forward - compatibility). - + This version of the library is source as well as both backward and + forward binary compatible with all past or future 4.2.x releases. + Programs compiled and linked with other releases of the (shared) + library within the 4.2.x lineage will continue to link and work + correctly when linked with this version of the library, provided the + same compiler is used to compile both the programs and the library. + Changing the compiler, its version, or some compiler options may + have an impact on the binary compatibility of the generated object + code. 2 Requirements --------------- @@ -140,28 +117,19 @@ o GNU gunzip o GNU make, version 3.70 or later (referred to as gmake here) - o GNU gcc, version 2.95.2 or later, or - o EDG eccp 2.42 or later, or - o Comeau C++ 4.2.42 or later, or - o HP aCC 3.13 or later for PA-RISC, or - o HP aCC 5.36 or later for IPF, or - o Intel C++ 7.0 or later for Linux/IA32 or IA64, or - o Compaq/HP C++ 6.2 or later for Tru64 UNIX, or - o IBM VisualAge 5.0 or later for AIX 4.3 or later - o SGI MIPSpro 7.3 or later for IRIX - o Sun C++ 5.3 or later for SunOS 5.6 or later + o C++ compiler and linker 3 Unpacking Instructions ------------------------- The distribution consists entirely of a single file named either - stdcxx-incubating-X.Y.Z.tar.gz for a final release, or - stdcxx-incubating-X.Y.Z-YYYYMMDD.tar.gz for snapshots. + stdcxx-X.Y.Z.tar.gz for a final release, or + stdcxx-X.Y.Z-YYYYMMDD.tar.gz for snapshots. To unpack the tarball, execute the following command: - $ gunzip -c stdcxx-incubating-X.Y.Z.tar.gz | tar -xf - + $ gunzip -c stdcxx-X.Y.Z.tar.gz | tar -xf - Above, X, Y, and Z are the major, minor, and micro version number of the library, respectively, and the optional -YYYYMMDD part is the @@ -291,14 +259,13 @@ Several utility programs are provided in complete source form along with the library sources. They are: exec, gencat, locale and - localedef. The header and source files for these utilities are + localedef. The header and source files for these utilities are contained in the ${TOPDIR}/util/ directory. The exec and gencat utilities are part of the test harness and are not intended to be - used directly or distributed to end users. The localedef utility is - used to build locales from locale definition files and character set - description files. Locales generated by the utility can be read by - the locale utility and used by the Apache C++ Standard Library's - localization library. + used directly. The localedef utility is used to build locales from + locale definition files and character set description files. + Locales generated by the utility can be read by the locale utility + and used by the Apache C++ Standard Library's localization library. 4.3 Locales @@ -724,7 +691,7 @@ +- include/*{,.cc} library headers | /config.h generated configuration header +- lib/libstd*.[a|so] archive or .so symbolic link - | libstd*.so.4.2.0 versioned shared library + | libstd*.so.4.2.1 versioned shared library +- nls/*/* codeset and locale databases To specify a subset of locales to install instead of the full set, @@ -918,12 +885,16 @@ The name of the macro depends on the name of the operating system typically reported by the uname utility: - _RWSTD_OS_AIX: AIX - _RWSTD_OS_HP_UX: HP-UX - _RWSTD_OS_IRIX64: IRIX - _RWSTD_OS_LINUX: Linux - _RWSTD_OS_OSF1: Tru64 UNIX - _RWSTD_OS_SUNOS: SunOS and Solaris + _RWSTD_OS_AIX: AIX + _RWSTD_OS_DARWIN: Apple Darwin + _RWSTD_OS_FREEBSD: FreeBSD + _RWSTD_OS_HP_UX: HP-UX + _RWSTD_OS_IRIX64: IRIX + _RWSTD_OS_LINUX: Linux + _RWSTD_OS_NETBSD: NetBSD + _RWSTD_OS_OSF1: Tru64 UNIX + _RWSTD_OS_SUNOS: SunOS and Solaris + _RWSTD_OS_WINDOWS: Microsoft Windows o _RWSTD_OS_SYSNAME @@ -1341,6 +1312,11 @@ 8.3.4 C Library Configuration Macros ------------------------------------- + o _RWSTD_NO_EQUAL_CTYPE_MASK [auto, lib] + + When #defined, the isxxx() and iswxxx() character classification + functions return different results for of the same arguments. + o _RWSTD_NO_LIBC_IN_STD [auto, over] When #defined, the names defined by the C library are expected to @@ -1943,12 +1919,6 @@ This release tested with: o EDG eccp 3.9 on Red Hat Enterprise Linux 5.0, x86_64 - The library fails to build unless _RWSTDDEBUG is #defined. - See http://issues.apache.org/jira/browse/STDCXX-595 - - The test driver and the exec utility fail to build. - See http://issues.apache.org/jira/browse/STDCXX-414 - o EDG eccp 3.9 on Solaris 9 @@ -1961,15 +1931,17 @@ This release tested with: + o gcc 4.3.0, Fedora 8, x86_64 + o gcc 4.2.1, Fedora 8, x86_64 o gcc 4.1.1, Solaris 10, SPARC - o gcc 4.1.0, SuSE Linux Enterprise Server 10.0, EM64T + o gcc 4.1.0, SUSE Linux Enterprise Server 10, x86_64 o gcc 4.0.1, Mac OS X (Darwin), x86 - o gcc 3.4.6, Red Hat Enterprise Linux 4, Update 4, AMD64 and EM64T - o gcc 3.4.4, Cygwin on Windows XP SP 2, x86 + o gcc 3.4.6, Red Hat Enterprise Linux 4, x86_64 + o gcc 3.4.4, Cygwin on Windows XP, x86 o gcc 3.4.4, FreeBSD 6.2, x86 - o gcc 3.4.4, Red Hat Enterprise Linux 4, Update 2, IA64 - o gcc 3.3.3, SuSE Linux Enterprise Server 9.1, AMD64 - o gcc 3.2.3, Red Hat Enterprise Linux 3, Update 8, EM64T + o gcc 3.4.4, Red Hat Enterprise Linux 4, IA64 + o gcc 3.3.3, SUSE Linux Enterprise Server 9.1, x86_64 + o gcc 3.2.3, Red Hat Enterprise Linux 3, x86_64 10.7 HP aCC @@ -1980,12 +1952,10 @@ This release tested with: - o aCC 6.13, HPUX 11.23, IPF - o aCC 6.05, HPUX 11.23, IPF + o aCC 6.15, HPUX 11.23, IPF + o aCC 6.15, HPUX 11.23, IPF o aCC 6.00, HPUX 11.23, IPF o aCC 5.57, HPUX 11.23, IPF - o aCC 3.74, HPUX 11.31, PA-RISC - o aCC 3.73, HPUX 11.31, PA-RISC o aCC 3.73, HPUX 11.23, PA-RISC o aCC 3.73, HPUX 11.11, PA-RISC o aCC 3.63, HPUX 11.31, PA-RISC @@ -2005,10 +1975,10 @@ o XLC++ 7.0, AIX 5.3, POWER o VisualAge C++ 6.0, AIX 5.2, POWER - For builds with VisualAge C++ 5.0 and 6.0 there are some - special considerations when building programs that use the - implicit inclusion mechanism (i.e., the -qtempinc mode which is - active by default). + For builds with VisualAge C++ 5.0 and 6.0 there are some special + considerations when building programs that use the implicit + inclusion mechanism (i.e., the -qtempinc mode which is active by + default). The mechanism imposes some restrictions on the way the source code is structured: template declarations have to be present in header @@ -2022,22 +1992,13 @@ --------------- Ported to Intel C++ 7.0 through 9.0 on Linux and Windows (x86, - IA64, and EM64T). + IA64, and x86_64). This release tested with: - o Intel C++ 10.0, Red Hat Enterprise Linux 4, Update 4, AMD64 and EM64T - o Intel C++ 10.0, SuSE Linux Enterprise Server 10.0, EM64T - o Intel C++ 10.0, Windows 2000 SP 4, x86 - o Intel C++ 10.0, Windows 2003 SP 1, EM64T and x86 - o Intel C++ 10.0, Windows XP SP 2, EM64T and x86 - o Intel C++ 10.0, Windows Vista, EM64T - o Intel C++ 9.1, Red Hat Enterprise Linux 4, Update 4, AMD64 and EM64T - o Intel C++ 9.1, Red Hat Enterprise Linux 4, Update 2, IA64 - o Intel C++ 9.1, SuSE Linux Enterprise Server 10.0, EM64T - o Intel C++ 9.1, Windows 2000 SP 4, x86 - o Intel C++ 9.1, Windows 2003 SP 1, x86 - o Intel C++ 9.1, Windows XP SP 2, x86 + o Intel C++ 10.0 and 9.1, Red Hat Enterprise Linux 5 and 4, x86_64 + o Intel C++ 10.0 and 9.1, SUSE Linux Enterprise Server 10 and 9, x86_64 + o Intel C++ 10.0 and 9.1, Windows Vista, XP and 2003, x86_64 and x86 10.10 KAI C++ -------------- @@ -2052,20 +2013,15 @@ 10.12 Microsoft Visual Studio ------------------------------ - Ported to Visual Studio .NET 2002 (AKA MSVC 7.0) through Visual - Studio .NET 2005 (AKA MSVC 8.0) on Windows (x86, IA64, and EM64T), - and Visual Studio 2008 (AKA MSVC 9.0), Beta 2. + Ported to Visual Studio .NET 2002 (AKA MSVC 7.0) through Visual + Studio .NET 2008 (AKA MSVC 9.0) on Windows (x86, IA64, and + x86_64). This release tested with: - o Visual Studio 2008 Beta 2, Windows XP, x86 - o Visual Studio 2005, Windows 2000 SP 4, x86 - o Visual Studio 2005, Windows 2003 SP 1, EM64T and x86 - o Visual Studio 2005, Windows XP SP 2, EM64T and x86 - o Visual Studio 2005, Windows Vista, EM64T - o Visual Studio 2003, Windows 2000 SP 4, x86 - o Visual Studio 2003, Windows 2003 SP 1, x86 - o Visual Studio 2003, Windows XP SP 2, x86 + o Visual Studio 2008, Windows Vista, XP, and 2003, x86 and x86_64 + o Visual Studio 2005, Windows Vista, XP, and 2003, x86 and x86_64 + o Visual Studio 2003, Windows XP and 2003, x86 10.13 SGI MIPSpro @@ -2092,12 +2048,10 @@ This release tested with: - o Sun C++ 5.9, Red Hat Enterprise Linux 4, Update 4, AMD64 and EM64T - o Sun C++ 5.9, SuSE Linux Enterprise Server 9.1, AMD64 - o Sun C++ 5.9, Solaris 10, AMD64 and SPARC - o Sun C++ 5.9, Solaris 9, SPARC - o Sun C++ 5.8, Solaris 10, AMD64 and SPARC - o Sun C++ 5.8, Solaris 8, SPARC + o Sun C++ 5.9, Red Hat Enterprise Linux 4, Update 4, x86_64 + o Sun C++ 5.9, SUSE Linux Enterprise Server 9.1, x86_64 + o Sun C++ 5.9, Solaris 10, 9, 8, x86_64 and SPARC + o Sun C++ 5.8, Solaris 10, 9, 8, x86_64 and SPARC o Sun C++ 5.7, Solaris 10, SPARC o Sun C++ 5.6, Solaris 9, SPARC o Sun C++ 5.3, Solaris 8, SPARC