Console: Overhaul documentation
[senf.git] / Utils / Mainpage.dox
1 // $Id$
2 //
3 // Copyright (C) 2007
4 // Fraunhofer Institute for Open Communication Systems (FOKUS)
5 // Competence Center NETwork research (NET), St. Augustin, GERMANY
6 //     Stefan Bund <g0dil@berlios.de>
7 //
8 // This program is free software; you can redistribute it and/or modify
9 // it under the terms of the GNU General Public License as published by
10 // the Free Software Foundation; either version 2 of the License, or
11 // (at your option) any later version.
12 //
13 // This program is distributed in the hope that it will be useful,
14 // but WITHOUT ANY WARRANTY; without even the implied warranty of
15 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 // GNU General Public License for more details.
17 //
18 // You should have received a copy of the GNU General Public License
19 // along with this program; if not, write to the
20 // Free Software Foundation, Inc.,
21 // 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
22
23 namespace senf {
24
25 /** \mainpage The SENF Utilities Library
26
27     The Utilities Library is a collection of independent utilities.
28
29
30     \section basic_helpers C++ Language helpers and library extensions
31
32     <table class="listing">
33     <tr><td>\ref membind</td><td>a simple <a
34     href="http://www.boost.org/libs/bind/bind.html">Boost.Bind</a> extension</td></tr>
35
36     <tr><td>\ref senfmpl</td><td>Some simple tools which help to solve common meta-programming
37     tasks</td></tr>
38
39     <tr><td>\ref senfpp</td><td>Extensions to the <a
40     href="http://www.boost.org/doc/libs/1_33_1/libs/preprocessor/doc/index.html">Boost.Preprocessor</a>
41     library</td></tr>
42
43     <tr><td>\ref typetraits</td><td>Extensions to the <a
44     href="http://www.boost.org/doc/libs/1_33_1/doc/html/boost_typetraits.html">Boost.TypeTraits</a>
45     library</td></tr>
46
47     <tr><td>\ref boost_parameter</td><td>Utilities concerning the <a
48     href="http://www.boost.org/doc/libs/1_33_1/libs/parameter/doc/html/index.html">Boost.Parameter</a>
49     library</td></tr>
50     </table>
51
52
53     \section basic_mixins Mixin classes
54     
55     <table class="listing">
56     <tr><td>\ref intrusive_refcount</td><td>mixin to simplify writing classes for use with <a
57     href="http://www.boost.org/libs/smart_ptr/intrusive_ptr.html">boost::intrusive_ptr</a></td></tr>
58
59     <tr><td>\ref safe_bool</td><td>a mixin class to provide a really safe replacement for
60     <tt>operator bool</tt>
61     
62     <tr><td>\ref singleton</td><td>mixin to make a class a singleton</td></tr>
63     </table>
64     
65
66     \section memory_management Memory Management
67
68     <table class="listing">
69     <tr><td>\ref SENF_SCOPED_BUFFER</td><td>a portable way to efficiently allocate temporary
70     buffers</td></tr>
71
72     <tr><td>\ref pool_alloc_mixin</td><td>mixin to provide pool allocation to a class</td></tr>
73     
74     <tr><td>\ref contiguous_storage_iterator</td><td>traits class to check iterator type for raw
75     pointer accessibility</td></tr>
76     </table>
77
78
79     \section typeinfo C++ Type interface
80
81     <table class="listing">
82     <tr><td>\ref prettyName()</td><td>an interface to the C++ demangler of g++ to get formated type
83     names from typeinfo objects</td></tr>
84
85     <tr><td>\ref TypeIdValue</td><td>class wrapping a typeid in a way that it can be used like any
86     other value type, e.g. as the key in a map.</td></tr>
87     </table>
88     
89
90     \section miscstuff Miscellaneous
91
92     <table class="listing">
93     <tr><td>\ref exception</td><td>standard exception for system errors (errno)</td></tr>
94
95     <tr><td>\ref hexdump</td><td>a simple but usefull function to write binary data in in
96     hexadecimal format.</td></tr>
97
98     <tr><td>\ref IpChecksum</td><td>calculating the 16 bit checksum used in the IP
99     specification</td></tr>
100
101     <tr><td>\ref utils_tags</td><td>Miscellaneous type tags</td></tr>
102     </table>
103
104     \section compatibility Compatibility
105
106     <table class="listing">
107     <tr><td>\ref auto_unit_test.hh</td><td>Boost auto unit test compatibility across Boost versions
108     1.33 and 1.34</td></tr>
109     </table>
110  */
111
112 }
113
114 \f
115 // Local Variables:
116 // mode: c++
117 // fill-column: 100
118 // c-file-style: "senf"
119 // indent-tabs-mode: nil
120 // ispell-local-dictionary: "american"
121 // mode: auto-fill
122 // End: