Home | History | Annotate | only in /prebuilts/ndk/8/sources/cxx-stl/stlport
Up to higher level directory
NameDateSize
libs/13-Nov-2012
LICENSE13-Nov-20122.9K
MODULE_LICENSE_BSD_LIKE13-Nov-20120
README13-Nov-20122.5K
README.android13-Nov-2012329
README.original13-Nov-20122.4K
stlport/13-Nov-2012

README

      1 STLport for Android
      2 
      3 WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
      4 WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
      5 
      6      This feature is currently in beta. In case of issue
      7      please contact the android-ndk support forum or
      8      file bugs at http://b.android.com
      9 
     10 WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
     11 WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
     12 
     13 This directory contains a port of STLport for Android, which provides
     14 a simple STL implementation. Note that it currently does not support
     15 C++ exceptions and RTTI. Support for wchar_t and locales is probably buggy.
     16 
     17 You can either use it as a static or shared library.
     18 
     19 1/ The static library is recommended if you will only produce
     20    one shared library for your project. All necessary STLport functions
     21    will be added to it. This option should also generate smaller
     22    overall binaries.
     23 
     24 2/ The shared library, is recommended if you want to produce
     25    several shared libraries in your project, because it avoids copying the
     26    same STLport functions to each one of them, and having different instances
     27    of the same global variables (which can easily conflict or result in
     28    undefined behaviour).
     29 
     30 To use the *static* library, define APP_STL in your Application.mk as follows:
     31 
     32     APP_STL := stlport_static
     33 
     34 To use the *shared* library, use "stlport_shared" instead:
     35 
     36     APP_STL := stlport_shared
     37 
     38 Note that, in this case, you will need, in your application, to explicitely
     39 load the 'stlport_shared' library before any library that depends on it.
     40 For example:
     41 
     42     static {
     43         System.loadLibrary("stlport_shared");
     44         System.loadLibrary("foo");
     45         System.loadLibrary("bar");
     46     }
     47 
     48 If both libfoo.so and libbar.so depend on STLport.
     49 
     50 You can build the STLport unit test program by doing the following:
     51 
     52   cd $NDK
     53   tests/run-tests.sh --test=test-stlport
     54 
     55 If you have an Android device connected to your machine, this will
     56 automatically try to run the generated test command. Note that for now
     57 a few tests are still failing (mostly related to wchar_t and locales).
     58 
     59 They should be fixed hopefully by a later release of this library.
     60 
     61 The NDK comes with prebuilt binaries for this library to speed up development.
     62 You can however rebuild them from sources in your own application build by
     63 defining STLPORT_FORCE_REBUILD to 'true' in your Application.mk as in:
     64 
     65     STLPORT_FORCE_REBUILD := true
     66 
     67 
     68 VERSION INFORMATION: This module is based on STLport version 5.2.0
     69 
     70 

README.android

      1 Version: 5.2.1
      2 
      3 Changes:
      4     * Added _android.h included by _system.h
      5     * Do not use linux float functions in num_get_float.cpp as Android does not
      6       have them.
      7     * _mbstate_t.h cannot define its own mbstate_t as bionic already defines
      8       it.
      9     * _pair.h needs to define bionic's (sgi's) internal pair header guard.
     10 

README.original

      1 **********************************************************************
      2 * 	README file for STLport 5.0                                    *
      3 *                                                                    *
      4 **********************************************************************
      5 
      6 This directory contains the STLport-5.0 release.
      7 
      8 What's inside :
      9 
     10 README           - this file
     11 INSTALL          - installation instructions
     12 
     13 bin              - installation directory for STLport unit tests;
     14                    it may contain more subdirs, if you use
     15                    crosscompilation
     16 build/lib        - build directory for STLport library (if you use
     17                    STLport iostreams and/or locale only)
     18 build/test/unit  - build directory for regression (unit) tests
     19 build/test/eh    - build directory for exception handling tests
     20 stlport          - main STLport include directory
     21 src              - source for iostreams implementation and other parts
     22                    that aren't pure template code
     23 lib              - installation directory for STLport library (if you
     24                    use STLport iostreams and/or locale only);
     25                    it may contain more subdirs, if you use
     26                    crosscompilation
     27 test/unit        - unit (regression) tests
     28 test/eh          - exception handling test using STLport iostreams
     29 etc              - miscellanous files (ChangeLog, TODO, scripts, etc.) 
     30 
     31 GETTING STLPORT
     32 
     33 To download the latest version of STLport, please be sure to visit
     34 https://sourceforge.net/project/showfiles.php?group_id=146814
     35 
     36 LEGALESE
     37 
     38 This software is being distributed under the following terms:
     39 
     40  *
     41  *
     42  * Copyright (c) 1994
     43  * Hewlett-Packard Company
     44  *
     45  * Copyright (c) 1996-1999
     46  * Silicon Graphics Computer Systems, Inc.
     47  *
     48  * Copyright (c) 1997
     49  * Moscow Center for SPARC Technology
     50  *
     51  * Copyright (c) 1999-2003
     52  * Boris Fomitchev
     53  *
     54  * This material is provided "as is", with absolutely no warranty expressed
     55  * or implied. Any use is at your own risk.
     56  *
     57  * Permission to use or copy this software for any purpose is hereby granted 
     58  * without fee, provided the above notices are retained on all copies.
     59  * Permission to modify the code and to distribute modified code is granted,
     60  * provided the above notices are retained, and a notice that the code was
     61  * modified is included with the above copyright notice.
     62  *
     63 
     64 **********************************************************************
     65