README

Tue, 16 Jan 2024 23:15:36 +0100

author
Mike Becker <universe@uap-core.de>
date
Tue, 16 Jan 2024 23:15:36 +0100
changeset 811
b02ad05c7f2d
parent 760
52e49533e7b4
permissions
-rw-r--r--

fix missing va_end() calls

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
760
52e49533e7b4 update build instructions
Mike Becker <universe@uap-core.de>
parents: 750
diff changeset
22 minimize the footprint, e.g. when you need lists, but do not need hash maps.
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
760
52e49533e7b4 update build instructions
Mike Becker <universe@uap-core.de>
parents: 750
diff changeset
28 The build processes requires executing a simple configure script and calling
52e49533e7b4 update build instructions
Mike Becker <universe@uap-core.de>
parents: 750
diff changeset
29 make. You can clone the repository or download the sources from SourceForge.
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
30
750
8a3336743c4e update CHANGELOG, COPYING, and README
Mike Becker <universe@uap-core.de>
parents: 652
diff changeset
31 wget https://sourceforge.net/projects/ucx/files/ucx-latest.tar.gz
8a3336743c4e update CHANGELOG, COPYING, and README
Mike Becker <universe@uap-core.de>
parents: 652
diff changeset
32 tar -xzf ucx-latest.tar.gz
8a3336743c4e update CHANGELOG, COPYING, and README
Mike Becker <universe@uap-core.de>
parents: 652
diff changeset
33 cd ucx-latest
151
fc8d05972af7 added README file - TODO: make install
Mike Becker <universe@uap-core.de>
parents: 103
diff changeset
34
760
52e49533e7b4 update build instructions
Mike Becker <universe@uap-core.de>
parents: 750
diff changeset
35 Then execute ./configure with the options you like. You can get a list of
52e49533e7b4 update build instructions
Mike Becker <universe@uap-core.de>
parents: 750
diff changeset
36 all available options with ./configure --help. The recommended configuration
52e49533e7b4 update build instructions
Mike Becker <universe@uap-core.de>
parents: 750
diff changeset
37 for production builds is ./configure --release.
390
d345541018fa starts ucx 3.0 development
Mike Becker <universe@uap-core.de>
parents: 259
diff changeset
38
760
52e49533e7b4 update build instructions
Mike Becker <universe@uap-core.de>
parents: 750
diff changeset
39 ./configure --release
52e49533e7b4 update build instructions
Mike Becker <universe@uap-core.de>
parents: 750
diff changeset
40 make
52e49533e7b4 update build instructions
Mike Becker <universe@uap-core.de>
parents: 750
diff changeset
41 make check # only available when built with tests
52e49533e7b4 update build instructions
Mike Becker <universe@uap-core.de>
parents: 750
diff changeset
42 sudo make install
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
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
750
8a3336743c4e update CHANGELOG, COPYING, and README
Mike Becker <universe@uap-core.de>
parents: 652
diff changeset
67 Copyright 2023 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