diff -ruN ecos_web_cvs/ecos/packages/language/cxx/ustl/current/ChangeLog ecos/ecos/packages/language/cxx/ustl/current/ChangeLog --- ecos_web_cvs/ecos/packages/language/cxx/ustl/current/ChangeLog 2009-08-24 09:07:18.368427800 +0200 +++ ecos/ecos/packages/language/cxx/ustl/current/ChangeLog 2009-08-24 11:06:04.707942000 +0200 @@ -1,3 +1,9 @@ +2009-08-24 Uwe Kindler + + * doc/ustl.sgml Moved documentation from README file into + ustl.sgml documentation file. + * tests/stdtest.h Removed unused code + 2009-08-21 Sergei Gavrikov * src/bktrace.cpp: prevent inclusion of host header diff -ruN ecos_web_cvs/ecos/packages/language/cxx/ustl/current/README ecos/ecos/packages/language/cxx/ustl/current/README --- ecos_web_cvs/ecos/packages/language/cxx/ustl/current/README 2009-08-24 09:07:18.649674200 +0200 +++ ecos/ecos/packages/language/cxx/ustl/current/README 1970-01-01 01:00:00.000000000 +0100 @@ -1,51 +0,0 @@ -Welcome to uSTL Library 1.3 -=========================== - -The eCos uSTL library is a port of Mike Sharov's uSTL implementation. -It has the particular feature of generating small object code sizes -- an important requirement for embedded eCos based applications. -The latest version can be found at: - - http://ustl.sourceforge.net/ - http://sourceforge.net/projects/ustl/ - -The library provides a subset of the full C++ STL standard library. -uSTL is a partial implementation of the STL specification intended to -reduce code size of the derivative programs. This allows the -eCos application to use well known standard C++ STL library -containers, streams, iterators, algorithms and functors. - -For changes, see the HISTORY file. - - -eCos port specific changes/enhancements ---------------------------------------- - -By default eCos is build without exceptions and without RTTI support -(compiler switches -fno-exceptions -fno-rtti). Normally the uSTL -library relies on C++ exceptions to propagate errors and exceptions. -To build the library for eCos all occurrences of try, cath and throw -are replaced by macros USLT_TRY, USLT_CATCH_ALL, and USLT_THROW. Thus -the eCos uSTL port compiles without exceptions and without RTTI support. - -The macro USLT_THROW calls an eCos specific exception handling function -that prints exception information to the diagnostic channel. - -All features of the uSTL library are available except for memory mapped -files or memory mapped streams. - -If you use cout for printing to the console you should know that the -data is only sent if you finish all output with endl and then call -cout.flush(). - -example: - -cout << "Console output" << endl; -cout.flush(); - - -Legal Stuff ------------ - -The uSTL library is subject of copyright under MIT license. For -the license text see LICENSE file. diff -ruN ecos_web_cvs/ecos/packages/language/cxx/ustl/current/doc/ustl.sgml ecos/ecos/packages/language/cxx/ustl/current/doc/ustl.sgml --- ecos_web_cvs/ecos/packages/language/cxx/ustl/current/doc/ustl.sgml 1970-01-01 01:00:00.000000000 +0100 +++ ecos/ecos/packages/language/cxx/ustl/current/doc/ustl.sgml 2009-08-23 12:59:06.000000000 +0200 @@ -0,0 +1,152 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +The uSTL library port + +uSTL library overview + +The eCos uSTL library is a port of Mike Sharov's uSTL implementation + - a size-optimized STL. It has the particular feature of generating small +object code sizes - an important requirement for embedded eCos based +applications. The latest version can be found at +http://sourceforge.net/projects/ustl. + + + +The library provides a subset of the full C++ + +STL standard library. +uSTL is a partial implementation of the STL specification intended to +reduce code size of the derivative programs. This allows eCos applications +to use well known standard C++ STL library containers, streams, +iterators, algorithms and functors. + + + +For changes, see the HISTORY file. A detailed introduction +of the uSTL library is available on Mike Sharov's +uSTL web page. +Additional information on all the classes is available in the header +files and in the +Doxygen reference. + + +eCos specific changes/enhancements + + +All features of the uSTL library are available except for memory mapped +files or memory mapped streams. + + + +By default an eCos image is build without exceptions and without RTTI support +(compiler switches -fno-exceptions -fno-rtti). Normally the uSTL +library relies on C++ exceptions to propagate errors and exceptions. +To build uSTL for eCos all occurrences of try, +catch and throw +are replaced by macros USTL_TRY, +USTL_CATCH_ALL, and +USTL_THROW. Thus the eCos uSTL port compiles without +exceptions and without RTTI support but also works if RTTI and exceptions +are enabled. + + + +To handle and propagate uSTL exceptions when RTTI und C++ exceptions are +not available the eCos uSTL port was extended by some simple exception +handling functions. An application can use the function +ustl::set_app_exception_handler() to register an +exception handler that is called by the USTL_THROW +macro as soon as an exception is thrown by any uSTL function. + + + +void ustl::set_app_exception_handler(app_exception_handler_t func); + + + +If an exception handler is registered by an application then it replaces the +default eCos uSTL exception handler. The default exception handler simply +prints the error message of an exception to the diagnostic channel by calling +void ustl::diag_print_exception(). This function +can be called also from an application exception handler like it is done +in all test cases. + + + +void ustl::set_app_exception_handler(app_exception_handler_t func); + + + + +Using uSTL in eCos applications + +To build an eCos library with uSTL support, you can start from the +default template and then add the uSTL package +CYGPKG_USTL. If you need file streams support of if you would like +to build all uSTL tests then you need to add the File I/O package +CYGPKG_IO_FILEIO. + + + +To use uSTL in your eCos application simply include the file +<ustl.h>. All uSTL classes are in the +ustl namespace. + + + +#include <ustl.h> +using namespace ustl; + +int main (int argc, char* argv[]) +{ + cout <<"Hello world!\n"; + return EXIT_SUCCESS; +} + + + + +If you use cout for printing to the console, +then data will get send only if you finish the output with +endl or '\n' and then call +cout.flush() like it is done in the example above. + + + + +The uSTL library is subject of copyright under MIT license. For +the license text see LICENSE file. + + + + + + diff -ruN ecos_web_cvs/ecos/packages/language/cxx/ustl/current/tests/stdtest.h ecos/ecos/packages/language/cxx/ustl/current/tests/stdtest.h --- ecos_web_cvs/ecos/packages/language/cxx/ustl/current/tests/stdtest.h 2009-08-20 19:00:31.000000000 +0200 +++ ecos/ecos/packages/language/cxx/ustl/current/tests/stdtest.h 2009-08-24 11:03:48.177565800 +0200 @@ -31,22 +31,6 @@ exit (sig); } -/* -/// Called by the framework on unrecoverable exception handling errors. -static void Terminate (void) -{ - CYG_TEST_FAIL_FINISH("Unrecoverable exception handling error detected."); - raise (SIGABRT); - exit (EXIT_FAILURE); -} - -/// Called when an exception violates a throw specification. -static void OnUnexpected (void) -{ - CYG_TEST_FAIL("Fatal internal error: unexpected exception caught.\n"); - Terminate(); -} -*/ /// Installs OnSignal as handler for signals. static void InstallCleanupHandlers (void) {