README

Wed, 28 Jun 2023 20:36:25 +0200

author
Mike Becker <universe@uap-core.de>
date
Wed, 28 Jun 2023 20:36:25 +0200
changeset 728
71c4ac35c1ce
parent 652
bf817b825ed2
child 750
8a3336743c4e
permissions
-rw-r--r--

improve how GTest config is passed during builds

151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
1 -------------------------------------------------------------------------------
256
2c21b42cf11d documentation will now be generated using pandoc
Mike Becker <universe@uap-core.de>
parents: 250
diff changeset
2 UAP Common Extensions - UCX
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
3 -------------------------------------------------------------------------------
103
08018864fb91 added license and copyright notice to all files
Mike Becker <universe@uap-core.de>
parents:
diff changeset
4
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
5 0. Table of Contents:
103
08018864fb91 added license and copyright notice to all files
Mike Becker <universe@uap-core.de>
parents:
diff changeset
6
155
45395ba5ed30 further improved build system (debug is now a target instead of a configuration)
Mike Becker <universe@uap-core.de>
parents: 152
diff changeset
7 1. Introduction ........................................................ 15
390
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
8 2. Build ............................................................... 25
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
9 3. Documentation ....................................................... 44
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
10 4. Contact ............................................................. 57
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
11 5. License ............................................................. 64
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
12
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
13
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
14 1. Introduction
159
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
15 ---------------
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
16
259
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
17 With this library we provide useful data structures and algorithms for common
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
18 programmatic tasks in the C language. By design the features are divided into
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
19 modules to minimize the library footprint. Using the build files you can create
259
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
20 a static and a shared lib containing all modules, but you may also use the UCX
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
21 sources in your project and compile specific modules by yourself to further
2f5dea574a75 modules documentation
Mike Becker <universe@uap-core.de>
parents: 256
diff changeset
22 minimize the footprint.
103
08018864fb91 added license and copyright notice to all files
Mike Becker <universe@uap-core.de>
parents:
diff changeset
23
08018864fb91 added license and copyright notice to all files
Mike Becker <universe@uap-core.de>
parents:
diff changeset
24
155
45395ba5ed30 further improved build system (debug is now a target instead of a configuration)
Mike Becker <universe@uap-core.de>
parents: 152
diff changeset
25 2. Build
159
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
26 --------
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
27
390
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
28 Untar the source archive and run
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
29
390
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
30 mkdir build
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
31 cd build
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
32 cmake ..
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
33 make
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
34
390
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
35 Optionally install UCX by running the following command as privileged user
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
36
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
37 make install
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
38
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
39 If you want to verify your build, you can run
155
45395ba5ed30 further improved build system (debug is now a target instead of a configuration)
Mike Becker <universe@uap-core.de>
parents: 152
diff changeset
40
652
bf817b825ed2 fix README showing how tests were run in the automake era
Mike Becker <universe@uap-core.de>
parents: 390
diff changeset
41 make test
155
45395ba5ed30 further improved build system (debug is now a target instead of a configuration)
Mike Becker <universe@uap-core.de>
parents: 152
diff changeset
42
45395ba5ed30 further improved build system (debug is now a target instead of a configuration)
Mike Becker <universe@uap-core.de>
parents: 152
diff changeset
43
390
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
44 3. Documentation
159
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
45 ----------------
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
46
250
b7d1317b138e updates license
Mike Becker <universe@uap-core.de>
parents: 225
diff changeset
47 Documentation is available at:
b7d1317b138e updates license
Mike Becker <universe@uap-core.de>
parents: 225
diff changeset
48
b7d1317b138e updates license
Mike Becker <universe@uap-core.de>
parents: 225
diff changeset
49 https://develop.uap-core.de/ucx/index.html
b7d1317b138e updates license
Mike Becker <universe@uap-core.de>
parents: 225
diff changeset
50
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
51 The code uses doxygen source code documentation. A html version of the
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
52 documentation is also available here:
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
53
250
b7d1317b138e updates license
Mike Becker <universe@uap-core.de>
parents: 225
diff changeset
54 https://develop.uap-core.de/ucx/api/index.html
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
55
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
56
390
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
57 4. Contact
159
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
58 ----------
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
59
250
b7d1317b138e updates license
Mike Becker <universe@uap-core.de>
parents: 225
diff changeset
60 Olaf Wintermann (olaf.wintermann@gmail.com)
b7d1317b138e updates license
Mike Becker <universe@uap-core.de>
parents: 225
diff changeset
61 Mike Becker (universe@uap-core.de)
159
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
62
390
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
63
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
64 5. License
159
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
65 ----------
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
66
390
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
67 Copyright 2021 Mike Becker, Olaf Wintermann All rights reserved.
159
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
68
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
69 Redistribution and use in source and binary forms, with or without
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
70 modification, are permitted provided that the following conditions are met:
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
71
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
72 1. Redistributions of source code must retain the above copyright
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
73 notice, this list of conditions and the following disclaimer.
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
74
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
75 2. Redistributions in binary form must reproduce the above copyright
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
76 notice, this list of conditions and the following disclaimer in the
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
77 documentation and/or other materials provided with the distribution.
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
78
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
79 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
80 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
81 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
82 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
83 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
84 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
85 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
86 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
87 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
88 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
a22b6da0587e added license to readme + added underlines to chapter titles
Mike Becker <universe@uap-core.de>
parents: 157
diff changeset
89 POSSIBILITY OF SUCH DAMAGE.

mercurial