[glibmm/glibmm-2-24] Documentation: Add more links to main page, and mention giomm.
- From: Murray Cumming <murrayc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glibmm/glibmm-2-24] Documentation: Add more links to main page, and mention giomm.
- Date: Mon, 3 May 2010 21:38:43 +0000 (UTC)
commit f4c74d287c79bd920625e40351e505231428c98a
Author: Murray Cumming <murrayc murrayc com>
Date: Mon May 3 23:38:35 2010 +0200
Documentation: Add more links to main page, and mention giomm.
* glib/glibmm.h: Add more doxggen links to groups and classes, based on
http://www.gtkmm.org/documentation.shtml and a look at the classes list.
Mention giomm features and add giomm to the pkg-config calls and mention
giomm.h
ChangeLog | 9 +++++++++
glib/glibmm.h | 33 +++++++++++++++++++++++++--------
2 files changed, 34 insertions(+), 8 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 1ef78af..0d93c0f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2010-05-03 Murray Cumming <murrayc murrayc-x61>
+
+ Documentation: Add more links to main page, and mention giomm.
+
+ * glib/glibmm.h: Add more doxggen links to groups and classes, based on
+ http://www.gtkmm.org/documentation.shtml and a look at the classes list.
+ Mention giomm features and add giomm to the pkg-config calls and mention
+ giomm.h
+
2010-04-27 David King <davidk openismus com>
Further changes to main page documentation
diff --git a/glib/glibmm.h b/glib/glibmm.h
index 2945add..76a2f0d 100644
--- a/glib/glibmm.h
+++ b/glib/glibmm.h
@@ -24,33 +24,50 @@
*
* @section description Description
*
- * glibmm is the official C++ interface for the popular library %Glib. See also
- * the <a href="http://library.gnome.org/devel/gtkmm-tutorial/stable/">
+ * glibmm is the official C++ interface for the popular cross-platform library %Glib.
+ * It provides non-UI API that is not available in standard C++ and makes it
+ * possible for gtkmm to wrap GObject-based APIs.
+ * See also the <a href="http://library.gnome.org/devel/gtkmm-tutorial/stable/">
* Programming with gtkmm</a> book for a tutorial on programming with gtkmm and
* glibmm.
*
* @section features Features
*
- * - A UTF-8 string class that has the interface of std::string.
- * - A reference-counting smartpointer for easy memory management.
- * - Intermediate types for compatibility with STL containers.
+ * - Glib::ustring: A UTF-8 string class that can be used interchangably with std::string. Plus @ref StringUtils
+ * - Glib::RefPtr: A reference-counting smartpointer, for use with Glib::ObjectBase or similar
+ * - @ref CharsetConv
+ * - Glib::Regex: Regular expression string matching.
+ * - Glib::KeyFile: Parsing and writing of key files (similar to .ini files)
+ * - Glib::Checksum
+ * - Glib::Date, Glib::Timer, Glib::TimeVal
+ * - Glib::Dispatcher: Inter-thread communication
+ * - @ref FileUtils and @ref UriUtils
+ * - @ref MainLoop
+ * - @ref Spawn
+ * - @ref Threads
+ * - @ref MiscUtils
+ *
+ * giomm (part of the glibmm project) also contains:
+ * - Asynchronous IO. See Gio::File and the @ref Streams.
+ * - @ref NetworkIO
*
* @section basics Basic Usage
*
- * Include the glibmm header:
+ * Include the glibmm header, plus giomm if necessary:
* @code
* #include <glibmm.h>
+ * #include <giomm.h>
* @endcode
* (You may include individual headers, such as @c glibmm/ustring.h instead.)
*
* If your source file is @c program.cc, you can compile it with:
* @code
- * g++ program.cc -o program `pkg-config --cflags --libs glibmm-2.4`
+ * g++ program.cc -o program `pkg-config --cflags --libs glibmm-2.4 giomm-2.4`
* @endcode
*
* Alternatively, if using autoconf, use the following in @c configure.ac:
* @code
- * PKG_CHECK_MODULES([GLIBMM], [glibmm-2.4])
+ * PKG_CHECK_MODULES([GLIBMM], [glibmm-2.4 giomm-2.4])
* @endcode
* Then use the generated @c GLIBMM_CFLAGS and @c GLIBMM_LIBS variables in the
* project Makefile.am files. For example:
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]