README

Fri, 27 Jun 2014 12:06:53 +0200

author
Mike Becker <universe@uap-core.de>
date
Fri, 27 Jun 2014 12:06:53 +0200
changeset 175
f5aa799abd86
parent 159
a22b6da0587e
child 177
11ad03783baf
permissions
-rw-r--r--

adjusted README

universe@103 1
universe@151 2 -------------------------------------------------------------------------------
universe@151 3 UAP Common eXtensions - UCX
universe@151 4 -------------------------------------------------------------------------------
universe@103 5
universe@151 6 0. Table of Contents:
universe@103 7
universe@155 8 1. Introduction ........................................................ 15
universe@159 9 2. Build ............................................................... 26
universe@159 10 3. Install ............................................................. 58
universe@159 11 4. Documentation ....................................................... 71
universe@159 12 5. Contact ............................................................. 80
universe@159 13 6. License ............................................................. 89
universe@103 14
universe@103 15
universe@151 16 1. Introduction
universe@159 17 ---------------
universe@103 18
universe@151 19 UAP Common eXtensions provide useful data structures and algorithms for common
universe@151 20 programmatic tasks in C language. By design the features are divided into
universe@151 21 modules to minimize the library footprint. Using the build files you can create
universe@155 22 a static and a shared lib containing all modules, but you might also want use
universe@155 23 the UCX sources in your project and compile specific modules to further minimize
universe@155 24 the footprint. Feel free to do so.
universe@151 25
universe@151 26
universe@155 27 2. Build
universe@159 28 --------
universe@151 29
universe@151 30 Untar the source archive and run
universe@151 31
universe@151 32 make CONF=<yourconfig>
universe@151 33
universe@155 34 If you are going to use gcc, then simply run
universe@151 35
universe@151 36 make
universe@151 37
universe@157 38 The available configurations are clang, gcc, mingw, osx and suncc.
universe@151 39
universe@151 40 The build files are placed into a build subdirectory, which is created if it
universe@151 41 does not exists.
universe@151 42
universe@175 43 The default target builds optimized binaries. Use the debug target by running
universe@155 44
universe@155 45 make debug CONF=<yourconfig>
universe@155 46
universe@155 47 to disable optimization and enable debug symbols.
universe@155 48
universe@155 49 If you want to test your build either run
universe@155 50
universe@155 51 make run CONF=<yourconfig>
universe@155 52
universe@155 53 or
universe@155 54
universe@155 55 make run-debug CONF=<yourconfig>
universe@155 56
universe@155 57 Again, you can omit the CONF parameter, when using the gcc.
universe@155 58
universe@155 59 3. Install
universe@159 60 ----------
universe@155 61
universe@155 62 Build the binaries as described in chapter two. Then install UCX, by running
universe@151 63
universe@151 64 make install
universe@151 65
universe@151 66 or
universe@151 67
universe@151 68 make install PREFIX=<install_dir>
universe@151 69
universe@151 70 The default prefix is /usr/local.
universe@151 71
universe@155 72 4. Documentation
universe@159 73 ----------------
universe@151 74
universe@151 75 The code uses doxygen source code documentation. A html version of the
universe@151 76 documentation is also available here:
universe@151 77
universe@175 78 http://develop.uap-core.de/ucx/api/current/index.html
universe@151 79
universe@151 80
universe@155 81 5. Contact
universe@159 82 ----------
universe@151 83
universe@151 84 Mike "UniversE" Becker (universe@uap-core.de)
universe@151 85 Olaf "Prometheus" Wintermann (prometheus@uap-core.de)
universe@159 86
universe@159 87 6. License
universe@159 88 ----------
universe@159 89
universe@159 90 Copyright 2013 Olaf Wintermann. All rights reserved.
universe@159 91
universe@159 92 Redistribution and use in source and binary forms, with or without
universe@159 93 modification, are permitted provided that the following conditions are met:
universe@159 94
universe@159 95 1. Redistributions of source code must retain the above copyright
universe@159 96 notice, this list of conditions and the following disclaimer.
universe@159 97
universe@159 98 2. Redistributions in binary form must reproduce the above copyright
universe@159 99 notice, this list of conditions and the following disclaimer in the
universe@159 100 documentation and/or other materials provided with the distribution.
universe@159 101
universe@159 102 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
universe@159 103 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
universe@159 104 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
universe@159 105 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
universe@159 106 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
universe@159 107 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
universe@159 108 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
universe@159 109 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
universe@159 110 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
universe@159 111 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
universe@159 112 POSSIBILITY OF SUCH DAMAGE.

mercurial