descriptionnone
ownerbluecoder@gmx.de
last changeTue, 11 Aug 2009 16:24:19 +0000 (11 18:24 +0200)
content tags
add:
README
         lightlibc++
         ===========

Contents:
1. What is this?
2. What requirements?
3. How do I use it?
4. How do I test it?


1. What is this?
================

This is a C++ standard library, that is supposed to support the ISO/IEC C++
ISO/IEC 14882:2003 and the ISO/IEC C++ [TODO: 1x] standards. It is written to
be portable. It is supposed to be especially usable in hobby operating systems
environments.

2. What requirements
====================

A C library is required and the in libc.README documentated changes have to be
made.

3. How do I use it?
===================

lightlibc++ comes with a Makefile for a gcc-based host-environment, so that you
can compile the code and run the testsuite for the library on your host
platform. If you choose to use lightlibc++ in your own hobby operating system
make sure that you have a working libc. Apart from that the only thing you have
to do is write a Makefile, that builds the library for your operating system.
You might want to have a look at the Makefile provided for compilation and
testing on the host operating system.
Apart from that you can use the following defines to configure the library:

* _LIGHTLIBCPP_CPP03
  The library uses only C++03 language features and provides everything it can
  with these features (including C++10 library stuff)
* _LIGHTLIBCPP_CPP03_STRICT
  The library uses only C++03 language features and provides only the C++03
  standard library stuff
* _LIGHTLIBCPP_CPP10
  The library uses C++10 language features and provides the full C++03 and
  C++10 library
* _LIGHTLIBCPP_CPP10_STRICT
  The library uses C++10 language features and provides the full C++10 library
  and marks deprecated stuff from C++03 accordingly
* _LIGHTLIBCPP_CPP10_NO_RVALUE_REFERENCES
  The library does not use rvalue references
* _LIGHTLIBCPP_CPP10_NO_VARIADIC_TEMPLATES
  The library does not use variadic templates
* _LIGHTLIBCPP_CPP10_DEFAULT_DELETE_FUNCTIONS
  The library does not use defaulted/deleted functions
* _LIGHTLIBCPP_NO_EXCEPTIONS
  The library does not use exceptions
* _LIGHTLIBCPP_NO_RTTI
  The library does not use rtti

The
* _LIGHTLIBCPP_CPP03 and _LIGHTLIBCPP_CPP10
* _LIGHTLIBCPP_NO_EXCEPTIONS
* _LIGHTLIBCPP_NO_RTTI
defines are automatically defined in lightlibc++/compiler.hpp for g++ according
to the -fno-exceptions, -fno-rtti (gcc 4.3 or later only), -std=c++98 and
-std=c++0x compiler switches.

The
* _LIGHTLIBCPP_CPP10_NO_VARIADIC_TEMPLATES
* _LIGHTLIBCPP_CPP10_NO_DEFAULT_DELETE_FUNCTIONS
* _LIGHTLIBCPP_CPP10_NO_RVALUE_REFERENCES
defines are automatically defined in lightlibc++/compiler.hpp for g++ according
to the gcc version.


4. How do I test it?
====================

The supplied Makefile comes with an 'all-host' target which will build the
library on the host platform (gcc required), an 'testcases-host' target which
will build and execute the testcases on the host platform.
shortlog
2009-08-11 Jörg Pfähler+ 21.6 Strings library, Null-terminated sequence utilit... master
2009-08-11 Jörg Pfähler+ 18.3 Language support library, Implementation propert...
2009-08-07 Jörg Pfähler+ testsuite can also be checked against the host Standa...
2009-08-06 Jörg Pfähler* Makefile: to ease crosscompilation
2009-06-12 Jörg Pfähler+ 18.9 Language support library, Initializer lists...
2009-06-12 Jörg Pfähler+ 19.3 Diagnostics library, Assertions: <cassert>
2009-06-12 Jörg Pfähler* _LIGHTLIBCPP_NO_EXCEPTIONS and _LIGHTLIBCPP_NO_RTTI...
2009-06-12 Jörg Pfähler* Fixed the numeration to comply with the newest C...
2009-06-12 Jörg Pfähler+ 18.8 Language support library, Other runtime support...
2009-06-12 Jörg Pfähler+ testcases: 18.1 Language support library, Types:...
2009-06-07 Jörg Pfähler+ C++ ABI: pure virtual functions
2009-06-07 Jörg Pfähler* 18.6 Language support library, Type identification...
2009-06-07 Jörg Pfähler* Makefile: variable for the tools from the host enviro...
2009-06-02 Jörg Pfähler+ 18.5 Language support library, Dynamic memory managem...
2009-06-02 Jörg Pfähler+ 18.7 Language support library, Exception handling...
2009-06-02 Jörg Pfähler+ 18.4 Language support library, Start and termination...
...
heads
15 years ago master