glib r7730 - in trunk/docs/reference: . glib/tmpl

[behdad svn gnome org]

Author: behdad
Date: Mon Dec  8 02:11:30 2008
New Revision: 7730
URL: http://svn.gnome.org/viewvc/glib?rev=7730&view=rev

Log:
2008-12-07  Behdad Esfahbod  <behdad gnome org>

        Bug 563150 â G_GU?INT*_MODIFIER/FORMAT docs

        * glib/tmpl/glib-unused.sgml:
        * glib/tmpl/macros_misc.sgml:
        * glib/tmpl/types.sgml:
        Update docs to mention scanning as well as printing.
        Cross reference these from their respective types.



Modified:
   trunk/docs/reference/ChangeLog
   trunk/docs/reference/glib/tmpl/macros_misc.sgml
   trunk/docs/reference/glib/tmpl/types.sgml

Modified: trunk/docs/reference/glib/tmpl/macros_misc.sgml
==============================================================================
--- trunk/docs/reference/glib/tmpl/macros_misc.sgml	(original)
+++ trunk/docs/reference/glib/tmpl/macros_misc.sgml	Mon Dec  8 02:11:30 2008
@@ -353,16 +353,6 @@
 
 
 
-<!-- ##### MACRO G_HAVE_GNUC_VISIBILITY ##### -->
-<para>
-This macro is defined as 1 if the compiler supports ELF visibility 
-attributes (currently only <command>gcc</command>).
-</para>
-
-Since: 2.6
-
-
-
 <!-- ##### MACRO G_GNUC_INTERNAL ##### -->
 <para>
 This attribute can be used for marking library functions as being used 
@@ -454,8 +444,8 @@
 
 <!-- ##### MACRO G_GINT16_MODIFIER ##### -->
 <para>
-The platform dependent length modifier for constructing printf() conversion
-specifiers for values of type #gint16 or #guint16. It is a string literal, 
+The platform dependent length modifier for conversion specifiers for scanning
+and printing values of type #gint16 or #guint16. It is a string literal, 
 but doesn't include the percent-sign, such that you can add precision and 
 length modifiers between percent-sign and conversion specifier and append a 
 conversion specifier.
@@ -506,8 +496,9 @@
 
 <!-- ##### MACRO G_GINT32_MODIFIER ##### -->
 <para>
-The platform dependent length modifier for constructing printf() conversion
-specifiers for values of type #gint32 or #guint32. See also #G_GINT16_MODIFIER.
+The platform dependent length modifier for conversion specifiers for scanning
+and printing values of type #gint32 or #guint32. It is a string literal, 
+See also #G_GINT16_MODIFIER.
 </para>
 
 @Since: 2.4
@@ -531,8 +522,8 @@
 
 <!-- ##### MACRO G_GINT64_MODIFIER ##### -->
 <para>
-The platform dependent length modifier for constructing printf() conversion
-specifiers for values of type #gint64 or #guint64. See also #G_GINT16_MODIFIER.
+The platform dependent length modifier for conversion specifiers for scanning
+and printing values of type #gint64 or #guint64. It is a string literal, 
 </para>
 
 <note>
@@ -584,8 +575,8 @@
 
 <!-- ##### MACRO G_GSIZE_MODIFIER ##### -->
 <para>
-The platform dependent length modifier for constructing printf() conversion
-specifiers for values of type #gsize or #gssize. See also #G_GINT16_MODIFIER.
+The platform dependent length modifier for conversion specifiers for scanning
+and printing values of type #gsize or #gssize. It is a string literal, 
 </para>
 
 @Since: 2.6

Modified: trunk/docs/reference/glib/tmpl/types.sgml
==============================================================================
--- trunk/docs/reference/glib/tmpl/types.sgml	(original)
+++ trunk/docs/reference/glib/tmpl/types.sgml	Mon Dec  8 02:11:30 2008
@@ -138,6 +138,10 @@
 A signed integer guaranteed to be 16 bits on all platforms.
 Values of this type can range from -32,768 to 32,767.
 </para>
+<para>
+To print or scan values of this type, use
+%G_GINT16_MODIFIER and/or %G_GINT16_FORMAT.
+</para>
 
 
 <!-- ##### TYPEDEF guint16 ##### -->
@@ -145,6 +149,10 @@
 An unsigned integer guaranteed to be 16 bits on all platforms.
 Values of this type can range from 0 to 65,535.
 </para>
+<para>
+To print or scan values of this type, use
+%G_GINT16_MODIFIER and/or %G_GUINT16_FORMAT.
+</para>
 
 
 <!-- ##### TYPEDEF gint32 ##### -->
@@ -152,6 +160,10 @@
 A signed integer guaranteed to be 32 bits on all platforms.
 Values of this type can range from -2,147,483,648 to 2,147,483,647.
 </para>
+<para>
+To print or scan values of this type, use
+%G_GINT32_MODIFIER and/or %G_GINT32_FORMAT.
+</para>
 
 
 <!-- ##### TYPEDEF guint32 ##### -->
@@ -159,6 +171,10 @@
 An unsigned integer guaranteed to be 32 bits on all platforms.
 Values of this type can range from 0 to 4,294,967,295.
 </para>
+<para>
+To print or scan values of this type, use
+%G_GINT32_MODIFIER and/or %G_GUINT32_FORMAT.
+</para>
 
 
 <!-- ##### MACRO G_HAVE_GINT64 ##### -->
@@ -177,6 +193,10 @@
 Values of this type can range from -9,223,372,036,854,775,808 to
 9,223,372,036,854,775,807.
 </para>
+<para>
+To print or scan values of this type, use
+%G_GINT64_MODIFIER and/or %G_GINT64_FORMAT.
+</para>
 
 
 <!-- ##### FUNCTION guint64 ##### -->
@@ -184,6 +204,10 @@
 An unsigned integer guaranteed to be 64 bits on all platforms.
 Values of this type can range from 0 to 18,446,744,073,709,551,615.
 </para>
+<para>
+To print or scan values of this type, use
+%G_GINT64_MODIFIER and/or %G_GUINT64_FORMAT.
+</para>
 
 @Returns: 
 
@@ -227,12 +251,20 @@
 value of a pointer, so it is usually 32bit wide on a 32bit platform and
 64bit wide on a 64bit platform.
 </para>
+<para>
+To print or scan values of this type, use
+%G_GSIZE_MODIFIER and/or %G_GSIZE_FORMAT.
+</para>
 
 
 <!-- ##### TYPEDEF gssize ##### -->
 <para>
 A signed variant of gsize, corresponding to the ssize_t defined on most platforms.
 </para>
+<para>
+To print or scan values of this type, use
+%G_GSIZE_MODIFIER and/or %G_GSSIZE_FORMAT.
+</para>
 
 
 <!-- ##### TYPEDEF goffset ##### -->