[gstreamermm] Refine the Doxygen main page.
- From: José Alburquerque <jaalburqu src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gstreamermm] Refine the Doxygen main page.
- Date: Mon, 24 May 2010 19:14:44 +0000 (UTC)
commit fc0b7e71f9916035724eb8e1584e4aaedafd33a0
Author: José Alburquerque <jaalburqu svn gnome org>
Date: Mon May 24 15:10:31 2010 -0400
Refine the Doxygen main page.
* gstreamer/gstreamermm.h:
- Include references to main classes that users might want to know
about.
- Make the features a list instead of a paragraph.
- Include a paragraph about initializing the library and a reference
to the GStreamer Application Development Manual.
- Use caps for section names so that it looks nice in the web pages.
Apparently, this makes Doxygen use the section title instead of the
name.
* docs/reference/Doxyfile.in: Use options from gtkmm for consistency.
* README: Typos.
ChangeLog | 16 ++++++++++++++++
README | 2 +-
docs/reference/Doxyfile.in | 17 ++++++++++-------
gstreamer/gstreamermm.h | 30 ++++++++++++++++++++----------
4 files changed, 47 insertions(+), 18 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index 8d9f848..b99067e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,19 @@
+2010-05-24 José Alburquerque <jaalburqu svn gnome org>
+
+ Refine the Doxygen main page.
+
+ * gstreamer/gstreamermm.h:
+ - Include references to main classes that users might want to know
+ about.
+ - Make the features a list instead of a paragraph.
+ - Include a paragraph about initializing the library and a reference
+ to the GStreamer Application Development Manual.
+ - Use caps for section names so that it looks nice in the web pages.
+ Apparently, this makes Doxygen use the section title instead of the
+ name.
+ * docs/reference/Doxyfile.in: Use options from gtkmm for consistency.
+ * README: Typos.
+
0.10.7.1:
2010-05-23 José Alburquerque <jaalburqu svn gnome org>
diff --git a/README b/README
index 55a4b39..2c79519 100644
--- a/README
+++ b/README
@@ -8,7 +8,7 @@ develop applications that work with multimedia in C++.
gstreamermm is developed over glibmm, libsigc++ and libxml++ and the
functionalities they provide. This means that, among other things, referencing
and unreferencing of GObjects is handled automatically via glibmm's automatic
-pointer class, Glib:RefPtr<>, and libsigc++'s slots are used for callbacks and
+pointer class, Glib::RefPtr, and libsigc++'s slots are used for callbacks and
signals.
There are several examples, including a media player, in the examples/
diff --git a/docs/reference/Doxyfile.in b/docs/reference/Doxyfile.in
index cdfa426..cd7eb88 100644
--- a/docs/reference/Doxyfile.in
+++ b/docs/reference/Doxyfile.in
@@ -1,4 +1,4 @@
-# Doxyfile 1.5.8
+# Doxyfile 1.6.1
# @configure_input@
#---------------------------------------------------------------------------
@@ -54,7 +54,7 @@ EXTRACT_STATIC = NO
EXTRACT_LOCAL_CLASSES = NO
EXTRACT_LOCAL_METHODS = NO
EXTRACT_ANON_NSPACES = NO
-HIDE_UNDOC_MEMBERS = YES
+HIDE_UNDOC_MEMBERS = NO
HIDE_UNDOC_CLASSES = YES
HIDE_FRIEND_COMPOUNDS = YES
HIDE_IN_BODY_DOCS = YES
@@ -65,6 +65,7 @@ SHOW_INCLUDE_FILES = NO
INLINE_INFO = YES
SORT_MEMBER_DOCS = YES
SORT_BRIEF_DOCS = NO
+SORT_MEMBERS_CTORS_1ST = YES
SORT_GROUP_NAMES = YES
SORT_BY_SCOPE_NAME = YES
GENERATE_TODOLIST = NO
@@ -130,7 +131,7 @@ VERBATIM_HEADERS = NO
#---------------------------------------------------------------------------
# configuration options related to the alphabetical class index
#---------------------------------------------------------------------------
-ALPHABETICAL_INDEX = NO
+ALPHABETICAL_INDEX = YES
COLS_IN_ALPHA_INDEX = 5
IGNORE_PREFIX =
#---------------------------------------------------------------------------
@@ -165,8 +166,10 @@ QHG_LOCATION =
DISABLE_INDEX = NO
ENUM_VALUES_PER_LINE = 1
GENERATE_TREEVIEW = NONE
+USE_INLINE_TREES = NO
TREEVIEW_WIDTH = 250
FORMULA_FONTSIZE = 10
+SEARCHENGINE = NO
#---------------------------------------------------------------------------
# configuration options related to the LaTeX output
#---------------------------------------------------------------------------
@@ -182,6 +185,7 @@ PDF_HYPERLINKS = YES
USE_PDFLATEX = YES
LATEX_BATCHMODE = NO
LATEX_HIDE_INDICES = NO
+LATEX_SOURCE_CODE = NO
#---------------------------------------------------------------------------
# configuration options related to the RTF output
#---------------------------------------------------------------------------
@@ -230,6 +234,9 @@ INCLUDE_FILE_PATTERNS = *.h
PREDEFINED = __cplusplus \
DOXYGEN_SHOULD_SKIP_THIS \
"G_GNUC_CONST=" \
+ "G_GNUC_NORETURN=" \
+ "G_GNUC_NULL_TERMINATED=" \
+ "G_GNUC_PURE=" \
"GSTREAMERMM_API=" \
GLIBMM_VFUNCS_ENABLED \
GLIBMM_PROPERTIES_ENABLED \
@@ -277,7 +284,3 @@ DOT_TRANSPARENT = NO
DOT_MULTI_TARGETS = YES
GENERATE_LEGEND = YES
DOT_CLEANUP = YES
-#---------------------------------------------------------------------------
-# Options related to the search engine
-#---------------------------------------------------------------------------
-SEARCHENGINE = NO
diff --git a/gstreamer/gstreamermm.h b/gstreamer/gstreamermm.h
index 29b8253..e7e1691 100644
--- a/gstreamer/gstreamermm.h
+++ b/gstreamer/gstreamermm.h
@@ -3,33 +3,43 @@
/** @mainpage gstreamermm Reference Manual
*
- * @section description Description
+ * @section Description Description
*
* gstreamermm provides C++ bindings for the <a
* href="http://gstreamer.freedesktop.org">GStreamer streaming multimedia
* library</a>. With gstreamermm it is possible to develop applications that
- * work with multimedia in C++.
+ * work with multimedia in C++. For instance, see Gst::Element, Gst::Bin and
+ * Gst::Pipeline.
*
- * @section features Features
+ * @section Features Features
*
- * gstreamermm is developed over <a
+ * - gstreamermm is developed over <a
* href="http://www.gtkmm.org/index.shtml">glibmm</a>, <a
* href="http://libsigc.sourceforge.net/">libsigc++</a> and <a
* href="http://libxmlplusplus.sourceforge.net/">libxml++</a> and the
- * functionalities they provide. This means that, among other things,
- * referencing and unreferencing of GObjects is handled automatically via
- * glibmm's automatic pointer class, Glib:RefPtr<>, and libsigc++'s slots are
- * used for callbacks and signals.
+ * functionalities they provide.
+ * - Referencing and unreferencing of GObjects is handled automatically via
+ * glibmm's automatic pointer class, Glib::RefPtr.
+ * - libsigc++'s slots are used for callbacks and signals.
+ * - Many of the GStreamer core and base plug-ins are wrapped.
*
- * @section basics Basic Usage
+ * @section Basics Basic Usage
*
- * Include the gstreamermm header:
+ * To use the library, some form of the Gst::init() method must be called
+ * before using its classes, functions, etc. To get a deeper understanding of
+ * how to set up pipelines, deal with elements, pads, etc., see the <a
+ * href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/manual/html/index.html">GStreamer
+ * Application Development Manual</a>.
+ *
+ * The following includes the gstreamermm header:
* @code
* #include <gstreamermm.h>
* @endcode
* (You may include individual headers, such as @c gstreamermm/pipeline.h
* instead.)
*
+ * @section Compiling Compiling
+ *
* If your source file is @c program.cc, you can compile it with:
* @code
* g++ program.cc -o program `pkg-config --cflags --libs gstreamermm-0.10`
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]