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.
This commit is contained in:
Matthias Clasen 2002-11-23 22:57:35 +00:00
parent 940d8a269d
commit e80c828a42
15 changed files with 37 additions and 21 deletions

View File

@ -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):

View File

@ -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;

View File

@ -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");

View File

@ -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;

View File

@ -2,7 +2,7 @@
Enums and Flags
<!-- ##### SECTION Short_Description ##### -->
Enumeration and flags types.
Enumeration and flags types
<!-- ##### SECTION Long_Description ##### -->
<para>

View File

@ -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>

View File

@ -2,7 +2,7 @@
Closures
<!-- ##### SECTION Short_Description ##### -->
Functions as first-class objects
<!-- ##### SECTION Long_Description ##### -->
<para>

View File

@ -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>

View File

@ -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

View File

@ -2,7 +2,7 @@
GTypeModule
<!-- ##### SECTION Short_Description ##### -->
Type Loading Modules
Type loading modules
<!-- ##### SECTION Long_Description ##### -->
<para>

View File

@ -2,7 +2,7 @@
GTypePlugin
<!-- ##### SECTION Short_Description ##### -->
An interface for dynamically loadable types
<!-- ##### SECTION Long_Description ##### -->
<para>

View File

@ -2,7 +2,7 @@
GObject
<!-- ##### SECTION Short_Description ##### -->
The base object type.
The base object type
<!-- ##### SECTION Long_Description ##### -->
<para>

View File

@ -2,7 +2,7 @@
Parameters and Values
<!-- ##### SECTION Short_Description ##### -->
Standard Parameter and Value Types.
Standard Parameter and Value Types
<!-- ##### SECTION Long_Description ##### -->
<para>

View File

@ -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>

View File

@ -2,7 +2,7 @@
Varargs Value Collection
<!-- ##### SECTION Short_Description ##### -->
Converting varargs to generic values
<!-- ##### SECTION Long_Description ##### -->
<para>