README@45395ba5ed30 (annotated)
README
Mon, 09 Sep 2013 10:48:08 +0200
- author
- Mike Becker <universe@uap-core.de>
- date
- Mon, 09 Sep 2013 10:48:08 +0200
- changeset 155
- 45395ba5ed30
- parent 152
- 3238f65db163
- child 156
- 6a4bd1f4c57e
- permissions
- -rw-r--r--
further improved build system (debug is now a target instead of a configuration)
| 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@155 | 9 | 2. Build ............................................................... 25 |
| universe@155 | 10 | 3. Install ............................................................. 58 |
| universe@155 | 11 | 4. Documentation ....................................................... 70 |
| universe@155 | 12 | 5. Contact ............................................................. 78 |
| universe@103 | 13 | |
| universe@103 | 14 | |
| universe@151 | 15 | 1. Introduction |
| universe@103 | 16 | |
| universe@151 | 17 | UAP Common eXtensions provide useful data structures and algorithms for common |
| universe@151 | 18 | programmatic tasks in C language. By design the features are divided into |
| universe@151 | 19 | modules to minimize the library footprint. Using the build files you can create |
| universe@155 | 20 | a static and a shared lib containing all modules, but you might also want use |
| universe@155 | 21 | the UCX sources in your project and compile specific modules to further minimize |
| universe@155 | 22 | the footprint. Feel free to do so. |
| universe@151 | 23 | |
| universe@151 | 24 | |
| universe@155 | 25 | 2. Build |
| universe@151 | 26 | |
| universe@151 | 27 | Untar the source archive and run |
| universe@151 | 28 | |
| universe@151 | 29 | make CONF=<yourconfig> |
| universe@151 | 30 | |
| universe@155 | 31 | If you are going to use gcc, then simply run |
| universe@151 | 32 | |
| universe@151 | 33 | make |
| universe@151 | 34 | |
| universe@155 | 35 | The available configurations are clang, gcc, g++, osx, suncc and windows. The |
| universe@155 | 36 | later uses microsoft visual C++ compiler. If you want to use mingw oder cygwin, |
| universe@155 | 37 | you can use the default gcc configuration. |
| universe@151 | 38 | |
| universe@151 | 39 | The build files are placed into a build subdirectory, which is created if it |
| universe@151 | 40 | does not exists. |
| universe@151 | 41 | |
| universe@155 | 42 | The default target builds an optimized binaries. Use the debug target by running |
| universe@155 | 43 | |
| universe@155 | 44 | make debug CONF=<yourconfig> |
| universe@155 | 45 | |
| universe@155 | 46 | to disable optimization and enable debug symbols. |
| universe@155 | 47 | |
| universe@155 | 48 | If you want to test your build either run |
| universe@155 | 49 | |
| universe@155 | 50 | make run CONF=<yourconfig> |
| universe@155 | 51 | |
| universe@155 | 52 | or |
| universe@155 | 53 | |
| universe@155 | 54 | make run-debug CONF=<yourconfig> |
| universe@155 | 55 | |
| universe@155 | 56 | Again, you can omit the CONF parameter, when using the gcc. |
| universe@155 | 57 | |
| universe@155 | 58 | 3. Install |
| universe@155 | 59 | |
| universe@155 | 60 | Build the binaries as described in chapter two. Then install UCX, by running |
| universe@151 | 61 | |
| universe@151 | 62 | make install |
| universe@151 | 63 | |
| universe@151 | 64 | or |
| universe@151 | 65 | |
| universe@151 | 66 | make install PREFIX=<install_dir> |
| universe@151 | 67 | |
| universe@151 | 68 | The default prefix is /usr/local. |
| universe@151 | 69 | |
| universe@155 | 70 | 4. Documentation |
| universe@151 | 71 | |
| universe@151 | 72 | The code uses doxygen source code documentation. A html version of the |
| universe@151 | 73 | documentation is also available here: |
| universe@151 | 74 | |
| universe@151 | 75 | http://develop.uap-core.de/ucx/1.0/index.html |
| universe@151 | 76 | |
| universe@151 | 77 | |
| universe@155 | 78 | 5. Contact |
| universe@151 | 79 | |
| universe@151 | 80 | Copyright (c) 2013 Olaf Wintermann |
| universe@151 | 81 | |
| universe@151 | 82 | Mike "UniversE" Becker (universe@uap-core.de) |
| universe@151 | 83 | Olaf "Prometheus" Wintermann (prometheus@uap-core.de) |
