From 8426d48f3914780bea21ce06b625a62b501ad036 Mon Sep 17 00:00:00 2001 From: Behdad Esfahbod Date: Mon, 8 Dec 2008 02:11:30 +0000 Subject: [PATCH] =?utf8?q?Bug=20563150=20=E2=80=93=20G=5FGU=3FINT*=5FMODIF?= =?utf8?q?IER/FORMAT=20docs?= MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit 2008-12-07 Behdad Esfahbod 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. svn path=/trunk/; revision=7730 --- docs/reference/ChangeLog | 10 ++++++++++ docs/reference/glib/tmpl/macros_misc.sgml | 27 +++++++++----------------- docs/reference/glib/tmpl/types.sgml | 32 +++++++++++++++++++++++++++++++ 3 files changed, 51 insertions(+), 18 deletions(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 156556d..33aaef4 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,13 @@ +2008-12-07 Behdad Esfahbod + + 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. + 2008-12-01 Matthias Clasen * === Released 2.19.2 === diff --git a/docs/reference/glib/tmpl/macros_misc.sgml b/docs/reference/glib/tmpl/macros_misc.sgml index c9e878c..84e2a83 100644 --- a/docs/reference/glib/tmpl/macros_misc.sgml +++ b/docs/reference/glib/tmpl/macros_misc.sgml @@ -353,16 +353,6 @@ See the GNU C documentation for details. - - -This macro is defined as 1 if the compiler supports ELF visibility -attributes (currently only gcc). - - -Since: 2.6 - - - This attribute can be used for marking library functions as being used @@ -454,8 +444,8 @@ Expands to a string identifying the current function. -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 @@ printing values of type #guint16. See also #G_GINT16_FORMAT. -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. @Since: 2.4 @@ -531,8 +522,8 @@ printing values of type #guint32. See also #G_GINT16_FORMAT. -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, @@ -584,8 +575,8 @@ recommended for parsing anyway; consider using g_strtoull() instead. -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, @Since: 2.6 diff --git a/docs/reference/glib/tmpl/types.sgml b/docs/reference/glib/tmpl/types.sgml index 4c3b778..0f2b37c 100644 --- a/docs/reference/glib/tmpl/types.sgml +++ b/docs/reference/glib/tmpl/types.sgml @@ -138,6 +138,10 @@ Values of this type can range from 0 to 255. A signed integer guaranteed to be 16 bits on all platforms. Values of this type can range from -32,768 to 32,767. + +To print or scan values of this type, use +%G_GINT16_MODIFIER and/or %G_GINT16_FORMAT. + @@ -145,6 +149,10 @@ Values of this type can range from -32,768 to 32,767. An unsigned integer guaranteed to be 16 bits on all platforms. Values of this type can range from 0 to 65,535. + +To print or scan values of this type, use +%G_GINT16_MODIFIER and/or %G_GUINT16_FORMAT. + @@ -152,6 +160,10 @@ Values of this type can range from 0 to 65,535. 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. + +To print or scan values of this type, use +%G_GINT32_MODIFIER and/or %G_GINT32_FORMAT. + @@ -159,6 +171,10 @@ Values of this type can range from -2,147,483,648 to 2,147,483,647. An unsigned integer guaranteed to be 32 bits on all platforms. Values of this type can range from 0 to 4,294,967,295. + +To print or scan values of this type, use +%G_GINT32_MODIFIER and/or %G_GUINT32_FORMAT. + @@ -177,6 +193,10 @@ A signed integer guaranteed to be 64 bits on all platforms. Values of this type can range from -9,223,372,036,854,775,808 to 9,223,372,036,854,775,807. + +To print or scan values of this type, use +%G_GINT64_MODIFIER and/or %G_GINT64_FORMAT. + @@ -184,6 +204,10 @@ Values of this type can range from -9,223,372,036,854,775,808 to 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. + +To print or scan values of this type, use +%G_GINT64_MODIFIER and/or %G_GUINT64_FORMAT. + @Returns: @@ -227,12 +251,20 @@ to the size_t type defined in C99. This type is wide enough to hold the numeric value of a pointer, so it is usually 32bit wide on a 32bit platform and 64bit wide on a 64bit platform. + +To print or scan values of this type, use +%G_GSIZE_MODIFIER and/or %G_GSIZE_FORMAT. + A signed variant of gsize, corresponding to the ssize_t defined on most platforms. + +To print or scan values of this type, use +%G_GSIZE_MODIFIER and/or %G_GSSIZE_FORMAT. + -- 2.7.4