]> mj.ucw.cz Git - libucw.git/blob - ucw/doc/index.txt
aaaadc6e965436315a5a06843827836b5bcd5ad1
[libucw.git] / ucw / doc / index.txt
1 The UCW library
2 ===============
3
4 The UCW library aims to provide a set general purpose tools for programming
5 in the C language. It contains generic data structures (lists, trees, hash
6 tables etc.), fast memory allocators optimized for various usage patterns,
7 abstract I/O streams and optimized implementations of some common algorithms
8 (e.g., sorting of arrays and files).
9
10 Please note that this documentation is not yet complete. Many modules are
11 not described, so you might need to look into the source code.
12
13 You can see the index of <<def_index:,documented definitions>>.
14
15 Modules
16 -------
17 - <<basics:,Basics>>
18 - <<log:,Logging>>
19 - <<fastbuf:,Fastbufs>>
20 - <<basecode:,Base64 and Base224 encoding>>
21 - <<hash:,Hashing routines>>
22 - <<conf:,Configuration and command line parser>>
23 - <<mempool:,Memory pools>>
24 - <<eltpool:,Fixed-sized allocators>>
25 - <<mainloop:,Mainloop>>
26 - <<unaligned:,Unaligned data>>
27 - <<lists:,Linked lists>>
28 - <<heap:,Binary heaps>>
29 - <<binheap:,Binomial heaps>>
30 - <<hashtable:,Hash tables>>
31 - <<growbuf:,Growing buffers>>
32 - <<chartype:,Single-byte characters>>
33 - <<unicode:,Multi-byte characters>>
34 - <<prime:,Prime numbers>>
35 - <<sort:,Sorting>>
36 - <<binsearch:,Binary search>>
37 - <<compress:,Compression>>
38 - <<trans:,Transactions and resource tracking>>
39 - <<string:,String operations>>
40 - <<time:,Time and timers>>
41
42 Other features
43 --------------
44 - <<configure:,Compile time configuration>>
45 - <<config:,Configuration file syntax>>
46 - <<docsys:,Documentation system>>
47 - <<generic:,Macro-generated generics>>
48 - <<relnotes:,Release notes>>
49
50 Yet undocumented modules
51 ------------------------
52 - Allocators
53   * `gary.h`
54 - Trie
55   * `trie.h`
56 - Red-black trees
57   * `redblack.h`
58 - Bit manipulation
59   * `bitarray.h`
60   * `bitopts.h`
61   * `bitsig.h`
62 - String manipulation
63   * `kmp.h`
64   * `kmp-search.h`
65   * `regex.h`
66   * `stkstring.h`
67   * `strtonum.h`
68   * `wildmatch.h`
69 - File manipulation
70   * `asio.h`
71   * `io.h`
72   * `partmap.h`
73 - Address manipulation
74   * `url.h`
75   * `ipaccess.h`
76 - Threads
77   * `semaphore.h`
78   * `threads.h`
79   * `workqueue.h`
80 - Miscellaneous
81   * `sighandler.h`
82   * `process.h`
83
84 License
85 -------
86 The UCW library is copyrighted by its authors:
87
88 - Pavel Charvát <mailto:pchar\@ucw.cz[]>
89 - Martin Mareš <mailto:mj\@ucw.cz[]>
90 - Robert Špalek <mailto:robert\@ucw.cz[]>
91 - Michal Vaner <mailto:vorner\@ucw.cz[]>
92
93 It can be freely distributed and used according to the terms of
94 the GNU Lesser General Public License.