Add missing short descriptions, standardize them to start with a capital

	* gobject/tmpl/gclosure.sgml:
	* gobject/tmpl/signals.sgml:
	* gobject/tmpl/gparamspec.sgml:
	* gobject/tmpl/value_collection.sgml:
	* gobject/tmpl/generic_values.sgml:
	* gobject/tmpl/param_value_types.sgml:
	* gobject/tmpl/gboxed.sgml:
	* gobject/tmpl/enumerations_flags.sgml:
	* gobject/tmpl/objects.sgml:
	* gobject/tmpl/gtypemodule.sgml:
	* gobject/tmpl/gtypeplugin.sgml: Add missing short descriptions,
	standardize them to start with a capital and end without a period.

	* glib/tmpl/arrays.sgml:
	* glib/tmpl/memory_chunks.sgml:
	* glib/tmpl/macros.sgml: Remove periods from titles in examples.

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index f8cbc25c0eec549ac6889c0afcb7d4a011873a59..1c71aea8fef7c53a6c15a8f9f19fa4338dc0205e 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,22 @@
 2002-11-23  Matthias Clasen  <maclas@gmx.de>
 
+       * gobject/tmpl/gclosure.sgml: 
+       * gobject/tmpl/signals.sgml: 
+       * gobject/tmpl/gparamspec.sgml: 
+       * gobject/tmpl/value_collection.sgml: 
+       * gobject/tmpl/generic_values.sgml: 
+       * gobject/tmpl/param_value_types.sgml: 
+       * gobject/tmpl/gboxed.sgml: 
+       * gobject/tmpl/enumerations_flags.sgml: 
+       * gobject/tmpl/objects.sgml: 
+       * gobject/tmpl/gtypemodule.sgml: 
+       * gobject/tmpl/gtypeplugin.sgml: Add missing short descriptions, 
+       standardize them to start with a capital and end without a period. 
+
+       * glib/tmpl/arrays.sgml: 
+       * glib/tmpl/memory_chunks.sgml: 
+       * glib/tmpl/macros.sgml: Remove periods from titles in examples.
+
        * glib/building.sgml: Explain --enable-include-printf.
 
        * glib/Makefile.am (extra_files): 

diff --git a/docs/reference/glib/tmpl/arrays.sgml b/docs/reference/glib/tmpl/arrays.sgml
index 6602e13b16d3b28188818826ce6098aa27423b52..61babb3059fe8a2f82d0e71b19ebe98feb1a2437 100644 (file)
--- a/docs/reference/glib/tmpl/arrays.sgml
+++ b/docs/reference/glib/tmpl/arrays.sgml
@@ -31,7 +31,7 @@ To set the size of an array, use g_array_set_size().
 To free an array, use g_array_free().
 </para>
 <example>
-<title>Using a <structname>GArray</structname> to store gint values.</title>
+<title>Using a <structname>GArray</structname> to store <type>gint</type> values</title>
 <programlisting>
   GArray *garray;
   gint i;
@@ -240,7 +240,7 @@ Returns the element of a #GArray at the given index.
 The return value is cast to the given type.
 
 <example>
-<title>Getting a pointer to an element in a <structname>GArray</structname>.</title>
+<title>Getting a pointer to an element in a <structname>GArray</structname></title>
 <programlisting>
   EDayViewEvent *event;
 

diff --git a/docs/reference/glib/tmpl/macros.sgml b/docs/reference/glib/tmpl/macros.sgml
index 6ccb903c721fe6c93e615bd31cc2c6d44d187366..3749d28d1783c7b61cb079603d3096c0218f599e 100644 (file)
--- a/docs/reference/glib/tmpl/macros.sgml
+++ b/docs/reference/glib/tmpl/macros.sgml
@@ -66,7 +66,7 @@ It returns %TRUE if the GLib library is the same or newer than the given
 version.
 
 <example>
-<title>Checking the version of the GLib library.</title>
+<title>Checking the version of the GLib library</title>
 <programlisting>
   if (!GLIB_CHECK_VERSION (1, 2, 0))
     g_error ("GLib version 1.2.0 or above is needed");

diff --git a/docs/reference/glib/tmpl/memory_chunks.sgml b/docs/reference/glib/tmpl/memory_chunks.sgml
index 8336f86a512580eccd8304af4a31408022e5c4ef..2fbe0c0ac090bec9fd0628fa125379ace5204294 100644 (file)
--- a/docs/reference/glib/tmpl/memory_chunks.sgml
+++ b/docs/reference/glib/tmpl/memory_chunks.sgml
@@ -56,7 +56,7 @@ To help debug memory chunks, use g_mem_chunk_info() and g_mem_chunk_print().
 </para>
 
 <example>
-<title>Using a GMemChunk.</title>
+<title>Using a <structname>GMemChunk</structname></title>
 <programlisting>
   GMemChunk *mem_chunk;
   gchar *mem[10000];
@@ -89,7 +89,7 @@ To help debug memory chunks, use g_mem_chunk_info() and g_mem_chunk_print().
 </programlisting></example>
 
 <example>
-<title>Using a GMemChunk with data structures.</title>
+<title>Using a <structname>GMemChunk</structname> with data structures</title>
 <programlisting>
   GMemChunk *array_mem_chunk;
   GRealArray *array;

diff --git a/docs/reference/gobject/tmpl/enumerations_flags.sgml b/docs/reference/gobject/tmpl/enumerations_flags.sgml
index 44cbe2cdad2b4ed9d22b9f35b830aa1e65b29222..3a170eecb3424dc52c2afab17e6eb1fea5f13627 100644 (file)
--- a/docs/reference/gobject/tmpl/enumerations_flags.sgml
+++ b/docs/reference/gobject/tmpl/enumerations_flags.sgml
@@ -2,7 +2,7 @@
 Enums and Flags
 
 <!-- ##### SECTION Short_Description ##### -->
-Enumeration and flags types.
+Enumeration and flags types
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gobject/tmpl/gboxed.sgml b/docs/reference/gobject/tmpl/gboxed.sgml
index 44ada58087158500489e4677e80ff7acee9d6626..fbe602b6d6b612ec5b4bb2cb1f47f5f61b5eb3f1 100644 (file)
--- a/docs/reference/gobject/tmpl/gboxed.sgml
+++ b/docs/reference/gobject/tmpl/gboxed.sgml
@@ -2,7 +2,7 @@
 GBoxed
 
 <!-- ##### SECTION Short_Description ##### -->
-Mechanism to wrap opaque C structures registered by the type system.
+A mechanism to wrap opaque C structures registered by the type system
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gobject/tmpl/gclosure.sgml b/docs/reference/gobject/tmpl/gclosure.sgml
index 42774bec1d88187a7dd00750386a7e05f43df57b..06268164981cddd0a25a5cf9629612d36049866d 100644 (file)
--- a/docs/reference/gobject/tmpl/gclosure.sgml
+++ b/docs/reference/gobject/tmpl/gclosure.sgml
@@ -2,7 +2,7 @@
 Closures
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Functions as first-class objects
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gobject/tmpl/generic_values.sgml b/docs/reference/gobject/tmpl/generic_values.sgml
index 3c34e8c5f0ecfbbd7972718f7646370c1ffa7761..7d37766f625e1b56fd7ec7f8c163e5b44249e5c2 100644 (file)
--- a/docs/reference/gobject/tmpl/generic_values.sgml
+++ b/docs/reference/gobject/tmpl/generic_values.sgml
@@ -2,7 +2,7 @@
 Generic Values
 
 <!-- ##### SECTION Short_Description ##### -->
-A polymorphic type that can hold values of any other type.
+A polymorphic type that can hold values of any other type
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gobject/tmpl/gparamspec.sgml b/docs/reference/gobject/tmpl/gparamspec.sgml
index 45a79dddfa5aa4a8a5c6b51a630510b56100f48a..d372ab57df973733df87c8efe6302b5e67155c66 100644 (file)
--- a/docs/reference/gobject/tmpl/gparamspec.sgml
+++ b/docs/reference/gobject/tmpl/gparamspec.sgml
@@ -2,11 +2,11 @@
 GParamSpec
 
 <!-- ##### SECTION Short_Description ##### -->
-Meta data object for parameter specifications.
+Metadata for parameter specifications
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-#GParamSpec is an object structure that encapsulates the meta data
+#GParamSpec is an object structure that encapsulates the metadata
 required to specify parameters, such as e.g. #GObject properties.
 </para>
 
@@ -69,7 +69,7 @@ Retrieve the #GParamSpecClass of a #GParamSpec.
 
 <!-- ##### MACRO G_PARAM_SPEC_TYPE ##### -->
 <para>
-Retrive the #GType of this @pspec.
+Retrieve the #GType of this @pspec.
 </para>
 
 @pspec: a valid #GParamSpec
@@ -77,7 +77,7 @@ Retrive the #GType of this @pspec.
 
 <!-- ##### MACRO G_PARAM_SPEC_TYPE_NAME ##### -->
 <para>
-Retrive the #GType name of this @pspec.
+Retrieve the #GType name of this @pspec.
 </para>
 
 @pspec: a valid #GParamSpec
@@ -85,7 +85,7 @@ Retrive the #GType name of this @pspec.
 
 <!-- ##### MACRO G_PARAM_SPEC_VALUE_TYPE ##### -->
 <para>
-Retrive the #GType to intiialize a #GValue for this parameter.
+Retrieve the #GType to intiialize a #GValue for this parameter.
 </para>
 
 @pspec: a valid #GParamSpec

diff --git a/docs/reference/gobject/tmpl/gtypemodule.sgml b/docs/reference/gobject/tmpl/gtypemodule.sgml
index 095199357f807ed33a8c8048c52e07d0146b5cea..a6e4bf5d06aa6723b6ca59dbc492c6f1485b8293 100644 (file)
--- a/docs/reference/gobject/tmpl/gtypemodule.sgml
+++ b/docs/reference/gobject/tmpl/gtypemodule.sgml
@@ -2,7 +2,7 @@
 GTypeModule
 
 <!-- ##### SECTION Short_Description ##### -->
-Type Loading Modules
+Type loading modules
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gobject/tmpl/gtypeplugin.sgml b/docs/reference/gobject/tmpl/gtypeplugin.sgml
index 284c74f44bb330b8c43f29c9dffe2b7927c0db93..5091bd0eda3c6e4e2a78d0ef7d27f5d94435cd8e 100644 (file)
--- a/docs/reference/gobject/tmpl/gtypeplugin.sgml
+++ b/docs/reference/gobject/tmpl/gtypeplugin.sgml
@@ -2,7 +2,7 @@
 GTypePlugin
 
 <!-- ##### SECTION Short_Description ##### -->
-
+An interface for dynamically loadable types
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gobject/tmpl/objects.sgml b/docs/reference/gobject/tmpl/objects.sgml
index 29ec9ad6fa33faee4f7b2802c666fdcc27c68f04..246d2ab50f03e6e57dbeecd899a6c737226a0f5b 100644 (file)
--- a/docs/reference/gobject/tmpl/objects.sgml
+++ b/docs/reference/gobject/tmpl/objects.sgml
@@ -2,7 +2,7 @@
 GObject
 
 <!-- ##### SECTION Short_Description ##### -->
-The base object type.
+The base object type
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gobject/tmpl/param_value_types.sgml b/docs/reference/gobject/tmpl/param_value_types.sgml
index 04210f7a9d6688ca03bae4857bc50e86ba537c2a..8db4da530ccc4807674ea4fa3655b832a3a713e6 100644 (file)
--- a/docs/reference/gobject/tmpl/param_value_types.sgml
+++ b/docs/reference/gobject/tmpl/param_value_types.sgml
@@ -2,7 +2,7 @@
 Parameters and Values
 
 <!-- ##### SECTION Short_Description ##### -->
-Standard Parameter and Value Types.
+Standard Parameter and Value Types
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gobject/tmpl/signals.sgml b/docs/reference/gobject/tmpl/signals.sgml
index 408a8c28dd4a58ec096f3b3eeb37714d6a49d8d4..06d91a7742b98f3a648777df1252ce7f744c2c1f 100644 (file)
--- a/docs/reference/gobject/tmpl/signals.sgml
+++ b/docs/reference/gobject/tmpl/signals.sgml
@@ -2,8 +2,7 @@
 Signals
 
 <!-- ##### SECTION Short_Description ##### -->
-Signals provide a means for customization of object behaviour and are used
-as general purpose notification mechanism.
+A means for customization of object behaviour and a general purpose notification mechanism
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gobject/tmpl/value_collection.sgml b/docs/reference/gobject/tmpl/value_collection.sgml
index 1ee2e9b28b66865b04766aeedaff0eed87b787f4..0694b2aca3ae6756692b227eef176c295d4628b1 100644 (file)
--- a/docs/reference/gobject/tmpl/value_collection.sgml
+++ b/docs/reference/gobject/tmpl/value_collection.sgml
@@ -2,7 +2,7 @@
 Varargs Value Collection
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Converting varargs to generic values
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>