glib r7608 - in branches/glib-2-18: . docs/reference docs/reference/glib/tmpl gio gmodule gobject gthread po
- From: matthiasc svn gnome org
- To: svn-commits-list gnome org
- Subject: glib r7608 - in branches/glib-2-18: . docs/reference docs/reference/glib/tmpl gio gmodule gobject gthread po
- Date: Thu, 16 Oct 2008 21:24:27 +0000 (UTC)
Author: matthiasc
Date: Thu Oct 16 21:24:27 2008
New Revision: 7608
URL: http://svn.gnome.org/viewvc/glib?rev=7608&view=rev
Log:
2.18.2
Modified:
branches/glib-2-18/ChangeLog
branches/glib-2-18/INSTALL
branches/glib-2-18/README
branches/glib-2-18/docs/reference/ChangeLog
branches/glib-2-18/docs/reference/glib/tmpl/byte_order.sgml
branches/glib-2-18/docs/reference/glib/tmpl/glib-unused.sgml
branches/glib-2-18/docs/reference/glib/tmpl/limits.sgml
branches/glib-2-18/docs/reference/glib/tmpl/macros_misc.sgml
branches/glib-2-18/docs/reference/glib/tmpl/main.sgml
branches/glib-2-18/docs/reference/glib/tmpl/memory.sgml
branches/glib-2-18/docs/reference/glib/tmpl/modules.sgml
branches/glib-2-18/docs/reference/glib/tmpl/threads.sgml
branches/glib-2-18/docs/reference/glib/tmpl/type_conversion.sgml
branches/glib-2-18/docs/reference/glib/tmpl/types.sgml
branches/glib-2-18/docs/reference/glib/tmpl/version.sgml
branches/glib-2-18/gio/ChangeLog
branches/glib-2-18/gmodule/ChangeLog
branches/glib-2-18/gobject/ChangeLog
branches/glib-2-18/gthread/ChangeLog
branches/glib-2-18/po/ChangeLog
branches/glib-2-18/po/am.po
branches/glib-2-18/po/ar.po
branches/glib-2-18/po/as.po
branches/glib-2-18/po/az.po
branches/glib-2-18/po/be.po
branches/glib-2-18/po/be latin po
branches/glib-2-18/po/bg.po
branches/glib-2-18/po/bn.po
branches/glib-2-18/po/bn_IN.po
branches/glib-2-18/po/bs.po
branches/glib-2-18/po/ca.po
branches/glib-2-18/po/cs.po
branches/glib-2-18/po/cy.po
branches/glib-2-18/po/da.po
branches/glib-2-18/po/de.po
branches/glib-2-18/po/dz.po
branches/glib-2-18/po/el.po
branches/glib-2-18/po/en_CA.po
branches/glib-2-18/po/en_GB.po
branches/glib-2-18/po/eo.po
branches/glib-2-18/po/es.po
branches/glib-2-18/po/et.po
branches/glib-2-18/po/eu.po
branches/glib-2-18/po/fa.po
branches/glib-2-18/po/fi.po
branches/glib-2-18/po/fr.po
branches/glib-2-18/po/ga.po
branches/glib-2-18/po/gl.po
branches/glib-2-18/po/gu.po
branches/glib-2-18/po/he.po
branches/glib-2-18/po/hi.po
branches/glib-2-18/po/hr.po
branches/glib-2-18/po/hu.po
branches/glib-2-18/po/hy.po
branches/glib-2-18/po/id.po
branches/glib-2-18/po/is.po
branches/glib-2-18/po/it.po
branches/glib-2-18/po/ja.po
branches/glib-2-18/po/ka.po
branches/glib-2-18/po/kn.po
branches/glib-2-18/po/ko.po
branches/glib-2-18/po/ku.po
branches/glib-2-18/po/lt.po
branches/glib-2-18/po/lv.po
branches/glib-2-18/po/mai.po
branches/glib-2-18/po/mg.po
branches/glib-2-18/po/mk.po
branches/glib-2-18/po/ml.po
branches/glib-2-18/po/mn.po
branches/glib-2-18/po/mr.po
branches/glib-2-18/po/ms.po
branches/glib-2-18/po/nb.po
branches/glib-2-18/po/ne.po
branches/glib-2-18/po/nl.po
branches/glib-2-18/po/nn.po
branches/glib-2-18/po/oc.po
branches/glib-2-18/po/or.po
branches/glib-2-18/po/pa.po
branches/glib-2-18/po/pl.po
branches/glib-2-18/po/ps.po
branches/glib-2-18/po/pt.po
branches/glib-2-18/po/pt_BR.po
branches/glib-2-18/po/ro.po
branches/glib-2-18/po/ru.po
branches/glib-2-18/po/rw.po
branches/glib-2-18/po/si.po
branches/glib-2-18/po/sk.po
branches/glib-2-18/po/sl.po
branches/glib-2-18/po/sq.po
branches/glib-2-18/po/sr.po
branches/glib-2-18/po/sr ije po
branches/glib-2-18/po/sr latin po
branches/glib-2-18/po/sv.po
branches/glib-2-18/po/ta.po
branches/glib-2-18/po/te.po
branches/glib-2-18/po/th.po
branches/glib-2-18/po/tl.po
branches/glib-2-18/po/tr.po
branches/glib-2-18/po/tt.po
branches/glib-2-18/po/uk.po
branches/glib-2-18/po/vi.po
branches/glib-2-18/po/wa.po
branches/glib-2-18/po/xh.po
branches/glib-2-18/po/yi.po
branches/glib-2-18/po/zh_CN.po
branches/glib-2-18/po/zh_HK.po
branches/glib-2-18/po/zh_TW.po
Modified: branches/glib-2-18/INSTALL
==============================================================================
--- branches/glib-2-18/INSTALL (original)
+++ branches/glib-2-18/INSTALL Thu Oct 16 21:24:27 2008
@@ -1,8 +1,8 @@
Simple install procedure
========================
- % gzip -cd glib-2.18.1.tar.gz | tar xvf - # unpack the sources
- % cd glib-2.18.1 # change to the toplevel directory
+ % gzip -cd glib-2.18.2.tar.gz | tar xvf - # unpack the sources
+ % cd glib-2.18.2 # change to the toplevel directory
% ./configure # run the `configure' script
% make # build GLIB
Modified: branches/glib-2-18/README
==============================================================================
--- branches/glib-2-18/README (original)
+++ branches/glib-2-18/README Thu Oct 16 21:24:27 2008
@@ -1,7 +1,7 @@
General Information
===================
-This is GLib version 2.18.1. GLib is the low-level core
+This is GLib version 2.18.2. GLib is the low-level core
library that forms the basis for projects such as GTK+ and GNOME. It
provides data structure handling for C, portability wrappers, and
interfaces for such runtime functionality as an event loop, threads,
Modified: branches/glib-2-18/docs/reference/glib/tmpl/byte_order.sgml
==============================================================================
--- branches/glib-2-18/docs/reference/glib/tmpl/byte_order.sgml (original)
+++ branches/glib-2-18/docs/reference/glib/tmpl/byte_order.sgml Thu Oct 16 21:24:27 2008
@@ -52,6 +52,15 @@
<!-- ##### SECTION Stability_Level ##### -->
+<!-- ##### MACRO G_BYTE_ORDER ##### -->
+<para>
+The host byte order.
+This can be either #G_LITTLE_ENDIAN or #G_BIG_ENDIAN (support for
+#G_PDP_ENDIAN may be added in future.)
+</para>
+
+
+
<!-- ##### MACRO G_LITTLE_ENDIAN ##### -->
<para>
Specifies one of the possible types of byte order.
@@ -130,6 +139,24 @@
@Returns: @val converted to host byte order.
+<!-- ##### MACRO GINT_TO_BE ##### -->
+<para>
+Converts a #gint value from host byte order to big-endian.
+</para>
+
+ val: a #gint value in host byte order.
+ Returns: @val converted to big-endian byte order.
+
+
+<!-- ##### MACRO GINT_TO_LE ##### -->
+<para>
+Converts a #gint value from host byte order to little-endian.
+</para>
+
+ val: a #gint value in host byte order.
+ Returns: @val converted to little-endian byte order.
+
+
<!-- ##### MACRO GUINT_FROM_BE ##### -->
<para>
Converts a #guint value from big-endian to host byte order.
@@ -148,6 +175,24 @@
@Returns: @val converted to host byte order.
+<!-- ##### MACRO GUINT_TO_BE ##### -->
+<para>
+Converts a #guint value from host byte order to big-endian.
+</para>
+
+ val: a #guint value in host byte order.
+ Returns: @val converted to big-endian byte order.
+
+
+<!-- ##### MACRO GUINT_TO_LE ##### -->
+<para>
+Converts a #guint value from host byte order to little-endian.
+</para>
+
+ val: a #guint value in host byte order.
+ Returns: @val converted to little-endian byte order.
+
+
<!-- ##### MACRO GLONG_FROM_BE ##### -->
<para>
Converts a #glong value from big-endian to the host byte order.
@@ -166,6 +211,24 @@
@Returns: @val converted to host byte order.
+<!-- ##### MACRO GLONG_TO_BE ##### -->
+<para>
+Converts a #glong value from host byte order to big-endian.
+</para>
+
+ val: a #glong value in host byte order.
+ Returns: @val converted to big-endian byte order.
+
+
+<!-- ##### MACRO GLONG_TO_LE ##### -->
+<para>
+Converts a #glong value from host byte order to little-endian.
+</para>
+
+ val: a #glong value in host byte order.
+ Returns: @val converted to little-endian.
+
+
<!-- ##### MACRO GULONG_FROM_BE ##### -->
<para>
Converts a #gulong value from big-endian to host byte order.
@@ -184,6 +247,24 @@
@Returns: @val converted to host byte order.
+<!-- ##### MACRO GULONG_TO_BE ##### -->
+<para>
+Converts a #gulong value from host byte order to big-endian.
+</para>
+
+ val: a #gulong value in host byte order.
+ Returns: @val converted to big-endian.
+
+
+<!-- ##### MACRO GULONG_TO_LE ##### -->
+<para>
+Converts a #gulong value from host byte order to little-endian.
+</para>
+
+ val: a #gulong value in host byte order.
+ Returns: @val converted to little-endian.
+
+
<!-- ##### MACRO GINT16_FROM_BE ##### -->
<para>
Converts a #gint16 value from big-endian to host byte order.
@@ -202,6 +283,24 @@
@Returns: @val converted to host byte order.
+<!-- ##### MACRO GINT16_TO_BE ##### -->
+<para>
+Converts a #gint16 value from host byte order to big-endian.
+</para>
+
+ val: a #gint16 value in host byte order.
+ Returns: @val converted to big-endian.
+
+
+<!-- ##### MACRO GINT16_TO_LE ##### -->
+<para>
+Converts a #gint16 value from host byte order to little-endian.
+</para>
+
+ val: a #gint16 value in host byte order.
+ Returns: @val converted to little-endian.
+
+
<!-- ##### MACRO GUINT16_FROM_BE ##### -->
<para>
Converts a #guint16 value from big-endian to host byte order.
@@ -220,6 +319,24 @@
@Returns: @val converted to host byte order.
+<!-- ##### MACRO GUINT16_TO_BE ##### -->
+<para>
+Converts a #guint16 value from host byte order to big-endian.
+</para>
+
+ val: a #guint16 value in host byte order.
+ Returns: @val converted to big-endian.
+
+
+<!-- ##### MACRO GUINT16_TO_LE ##### -->
+<para>
+Converts a #guint16 value from host byte order to little-endian.
+</para>
+
+ val: a #guint16 value in host byte order.
+ Returns: @val converted to little-endian.
+
+
<!-- ##### MACRO GINT32_FROM_BE ##### -->
<para>
Converts a #gint32 value from big-endian to host byte order.
@@ -238,6 +355,24 @@
@Returns: @val converted to host byte order.
+<!-- ##### MACRO GINT32_TO_BE ##### -->
+<para>
+Converts a #gint32 value from host byte order to big-endian.
+</para>
+
+ val: a #gint32 value in host byte order.
+ Returns: @val converted to big-endian.
+
+
+<!-- ##### MACRO GINT32_TO_LE ##### -->
+<para>
+Converts a #gint32 value from host byte order to little-endian.
+</para>
+
+ val: a #gint32 value in host byte order.
+ Returns: @val converted to little-endian.
+
+
<!-- ##### MACRO GUINT32_FROM_BE ##### -->
<para>
Converts a #guint32 value from big-endian to host byte order.
@@ -256,6 +391,24 @@
@Returns: @val converted to host byte order.
+<!-- ##### MACRO GUINT32_TO_BE ##### -->
+<para>
+Converts a #guint32 value from host byte order to big-endian.
+</para>
+
+ val: a #guint32 value in host byte order.
+ Returns: @val converted to big-endian.
+
+
+<!-- ##### MACRO GUINT32_TO_LE ##### -->
+<para>
+Converts a #guint32 value from host byte order to little-endian.
+</para>
+
+ val: a #guint32 value in host byte order.
+ Returns: @val converted to little-endian.
+
+
<!-- ##### MACRO GINT64_FROM_BE ##### -->
<para>
Converts a #gint64 value from big-endian to host byte order.
@@ -274,6 +427,24 @@
@Returns: @val converted to host byte order.
+<!-- ##### MACRO GINT64_TO_BE ##### -->
+<para>
+Converts a #gint64 value from host byte order to big-endian.
+</para>
+
+ val: a #gint64 value in host byte order.
+ Returns: @val converted to big-endian.
+
+
+<!-- ##### MACRO GINT64_TO_LE ##### -->
+<para>
+Converts a #gint64 value from host byte order to little-endian.
+</para>
+
+ val: a #gint64 value in host byte order.
+ Returns: @val converted to little-endian.
+
+
<!-- ##### MACRO GUINT64_FROM_BE ##### -->
<para>
Converts a #guint64 value from big-endian to host byte order.
@@ -292,6 +463,24 @@
@Returns: @val converted to host byte order.
+<!-- ##### MACRO GUINT64_TO_BE ##### -->
+<para>
+Converts a #guint64 value from host byte order to big-endian.
+</para>
+
+ val: a #guint64 value in host byte order.
+ Returns: @val converted to big-endian.
+
+
+<!-- ##### MACRO GUINT64_TO_LE ##### -->
+<para>
+Converts a #guint64 value from host byte order to little-endian.
+</para>
+
+ val: a #guint64 value in host byte order.
+ Returns: @val converted to little-endian.
+
+
<!-- ##### MACRO GUINT16_SWAP_BE_PDP ##### -->
<para>
Converts a #guint16 value between big-endian and pdp-endian byte order.
Modified: branches/glib-2-18/docs/reference/glib/tmpl/glib-unused.sgml
==============================================================================
--- branches/glib-2-18/docs/reference/glib/tmpl/glib-unused.sgml (original)
+++ branches/glib-2-18/docs/reference/glib/tmpl/glib-unused.sgml Thu Oct 16 21:24:27 2008
@@ -180,83 +180,6 @@
@hook_list:
@hook:
-<!-- ##### MACRO GINT16_TO_BE ##### -->
-<para>
-Converts a #gint16 value from host byte order to big-endian.
-</para>
-
- val: a #gint16 value in host byte order.
- Returns: @val converted to big-endian.
-
-<!-- ##### MACRO GINT16_TO_LE ##### -->
-<para>
-Converts a #gint16 value from host byte order to little-endian.
-</para>
-
- val: a #gint16 value in host byte order.
- Returns: @val converted to little-endian.
-
-<!-- ##### MACRO GINT32_TO_BE ##### -->
-<para>
-Converts a #gint32 value from host byte order to big-endian.
-</para>
-
- val: a #gint32 value in host byte order.
- Returns: @val converted to big-endian.
-
-<!-- ##### MACRO GINT32_TO_LE ##### -->
-<para>
-Converts a #gint32 value from host byte order to little-endian.
-</para>
-
- val: a #gint32 value in host byte order.
- Returns: @val converted to little-endian.
-
-<!-- ##### MACRO GINT64_TO_BE ##### -->
-<para>
-Converts a #gint64 value from host byte order to big-endian.
-</para>
-
- val: a #gint64 value in host byte order.
- Returns: @val converted to big-endian.
-
-<!-- ##### MACRO GINT64_TO_LE ##### -->
-<para>
-Converts a #gint64 value from host byte order to little-endian.
-</para>
-
- val: a #gint64 value in host byte order.
- Returns: @val converted to little-endian.
-
-<!-- ##### MACRO GINT_TO_BE ##### -->
-<para>
-Converts a #gint value from host byte order to big-endian.
-</para>
-
- val: a #gint value in host byte order.
- Returns: @val converted to big-endian byte order.
-
-<!-- ##### MACRO GINT_TO_LE ##### -->
-<para>
-Converts a #gint value from host byte order to little-endian.
-</para>
-
- val: a #gint value in host byte order.
- Returns: @val converted to little-endian byte order.
-
-<!-- ##### MACRO GINT_TO_POINTER ##### -->
-<para>
-Stuffs an integer into a pointer type.
-</para>
-<para>
-Remember, YOU MAY NOT STORE POINTERS IN INTEGERS. THIS IS NOT PORTABLE
-IN ANY WAY SHAPE OR FORM. These macros <emphasis>ONLY</emphasis> allow
-storing integers in pointers, and only preserve 32 bits of the
-integer; values outside the range of a 32-bit integer will be mangled.
-</para>
-
- i: integer to stuff into a pointer.
-
<!-- ##### ENUM GIOFileMode ##### -->
<para>
@@ -269,49 +192,6 @@
@G_IO_FILE_MODE_READ_WRITE_TRUNCATE:
@G_IO_FILE_MODE_READ_WRITE_APPEND:
-<!-- ##### MACRO GLIB_MAJOR_VERSION ##### -->
-<para>
-The major version number of the GLib library.
-Like #glib_major_version, but from the headers used at
-application compile time, rather than from the library linked against
-at application run time.
-</para>
-
-
-<!-- ##### MACRO GLIB_MICRO_VERSION ##### -->
-<para>
-The micro version number of the GLib library.
-Like #gtk_micro_version, but from the headers used at
-application compile time, rather than from the library linked against
-at application run time.
-</para>
-
-
-<!-- ##### MACRO GLIB_MINOR_VERSION ##### -->
-<para>
-The minor version number of the GLib library.
-Like #gtk_minor_version, but from the headers used at
-application compile time, rather than from the library linked against
-at application run time.
-</para>
-
-
-<!-- ##### MACRO GLONG_TO_BE ##### -->
-<para>
-Converts a #glong value from host byte order to big-endian.
-</para>
-
- val: a #glong value in host byte order.
- Returns: @val converted to big-endian byte order.
-
-<!-- ##### MACRO GLONG_TO_LE ##### -->
-<para>
-Converts a #glong value from host byte order to little-endian.
-</para>
-
- val: a #glong value in host byte order.
- Returns: @val converted to little-endian.
-
<!-- ##### ENUM GMatchType ##### -->
<para>
Enumeration representing different kinds of patterns. This is only used
@@ -326,170 +206,6 @@
@G_MATCH_EXACT: a pattern matching exactly one string.
@G_MATCH_LAST:
-<!-- ##### STRUCT GModule ##### -->
-<para>
-The #GModule struct is an opaque data structure to represent a
-<link linkend="glib-Dynamic-Loading-of-Modules">Dynamically-Loaded Module</link>.
-It should only be accessed via the following functions.
-</para>
-
-
-<!-- ##### USER_FUNCTION GModuleCheckInit ##### -->
-<para>
-Specifies the type of the module initialization function.
-<indexterm zone="g-module-check-init"><primary>g_module_check_init</primary></indexterm>
-If a module contains a function named g_module_check_init() it is called
-automatically when the module is loaded. It is passed the #GModule structure
-and should return %NULL on success or a string describing the initialization
-error.
-</para>
-
- module: the #GModule corresponding to the module which has just been loaded.
- Returns: %NULL on success, or a string describing the initialization error.
-
-<!-- ##### ENUM GModuleFlags ##### -->
-<para>
-Flags passed to g_module_open(). Note that these flags are
-not supported on all platforms.
-</para>
-
- G_MODULE_BIND_LAZY: specifies that symbols are only resolved when needed.
- The default action is to bind all symbols when the module is loaded.
- G_MODULE_BIND_LOCAL: specifies that symbols in the module should
- not be added to the global name space. The default action on most
- platforms is to place symbols in the module in the global name space,
- which may cause conflicts with existing symbols.
- G_MODULE_BIND_MASK: mask for all flags.
-
-<!-- ##### USER_FUNCTION GModuleUnload ##### -->
-<para>
-<indexterm zone="g-module-unload"><primary>g_module_unload</primary></indexterm>
-Specifies the type of the module function called when it is unloaded.
-If a module contains a function named g_module_unload() it is called
-automatically when the module is unloaded.
-It is passed the #GModule structure.
-</para>
-
- module: the #GModule about to be unloaded.
-
-<!-- ##### MACRO GPOINTER_TO_INT ##### -->
-<para>
-Extracts an integer from a pointer. The integer must have
-been stored in the pointer with GINT_TO_POINTER().
-</para>
-<para>
-Remember, YOU MAY NOT STORE POINTERS IN INTEGERS. THIS IS NOT PORTABLE
-IN ANY WAY SHAPE OR FORM. These macros <emphasis>ONLY</emphasis> allow
-storing integers in pointers, and only preserve 32 bits of the
-integer; values outside the range of a 32-bit integer will be mangled.
-</para>
-
- p: pointer containing an integer.
-
-<!-- ##### MACRO GPOINTER_TO_UINT ##### -->
-<para>
-Extracts an unsigned integer from a pointer. The integer must have
-been stored in the pointer with GUINT_TO_POINTER().
-</para>
-
- p: pointer to extract an unsigned integer from.
-
-<!-- ##### TYPEDEF GPid ##### -->
-<para>
-A type which is used to hold a process identification.
-On Unix, processes are identified by a process id (an
-integer), while Windows uses process handles (which are
-pointers).
-</para>
-
-
-<!-- ##### MACRO GUINT16_TO_BE ##### -->
-<para>
-Converts a #guint16 value from host byte order to big-endian.
-</para>
-
- val: a #guint16 value in host byte order.
- Returns: @val converted to big-endian.
-
-<!-- ##### MACRO GUINT16_TO_LE ##### -->
-<para>
-Converts a #guint16 value from host byte order to little-endian.
-</para>
-
- val: a #guint16 value in host byte order.
- Returns: @val converted to little-endian.
-
-<!-- ##### MACRO GUINT32_TO_BE ##### -->
-<para>
-Converts a #guint32 value from host byte order to big-endian.
-</para>
-
- val: a #guint32 value in host byte order.
- Returns: @val converted to big-endian.
-
-<!-- ##### MACRO GUINT32_TO_LE ##### -->
-<para>
-Converts a #guint32 value from host byte order to little-endian.
-</para>
-
- val: a #guint32 value in host byte order.
- Returns: @val converted to little-endian.
-
-<!-- ##### MACRO GUINT64_TO_BE ##### -->
-<para>
-Converts a #guint64 value from host byte order to big-endian.
-</para>
-
- val: a #guint64 value in host byte order.
- Returns: @val converted to big-endian.
-
-<!-- ##### MACRO GUINT64_TO_LE ##### -->
-<para>
-Converts a #guint64 value from host byte order to little-endian.
-</para>
-
- val: a #guint64 value in host byte order.
- Returns: @val converted to little-endian.
-
-<!-- ##### MACRO GUINT_TO_BE ##### -->
-<para>
-Converts a #guint value from host byte order to big-endian.
-</para>
-
- val: a #guint value in host byte order.
- Returns: @val converted to big-endian byte order.
-
-<!-- ##### MACRO GUINT_TO_LE ##### -->
-<para>
-Converts a #guint value from host byte order to little-endian.
-</para>
-
- val: a #guint value in host byte order.
- Returns: @val converted to little-endian byte order.
-
-<!-- ##### MACRO GUINT_TO_POINTER ##### -->
-<para>
-Stuffs an unsigned integer into a pointer type.
-</para>
-
- u: unsigned integer to stuff into the pointer.
-
-<!-- ##### MACRO GULONG_TO_BE ##### -->
-<para>
-Converts a #gulong value from host byte order to big-endian.
-</para>
-
- val: a #gulong value in host byte order.
- Returns: @val converted to big-endian.
-
-<!-- ##### MACRO GULONG_TO_LE ##### -->
-<para>
-Converts a #gulong value from host byte order to little-endian.
-</para>
-
- val: a #gulong value in host byte order.
- Returns: @val converted to little-endian.
-
<!-- ##### USER_FUNCTION GWarningFunc ##### -->
<para>
Specifies the type of function passed to g_set_warning_handler().
@@ -497,14 +213,6 @@
@str: the warning message.
-<!-- ##### MACRO G_BYTE_ORDER ##### -->
-<para>
-The host byte order.
-This can be either #G_LITTLE_ENDIAN or #G_BIG_ENDIAN (support for
-#G_PDP_ENDIAN may be added in future.)
-</para>
-
-
<!-- ##### MACRO G_CHANNEL_ERROR ##### -->
<para>
@@ -519,214 +227,6 @@
</para>
-<!-- ##### MACRO G_GINT16_FORMAT ##### -->
-<para>
-This is the platform dependent conversion specifier for scanning and
-printing values of type #gint16. 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.
-</para>
-
-<para>
-<informalexample>
-<programlisting>
-gint16 in;
-gint32 out;
-sscanf ("42", "%" G_GINT16_FORMAT, &in)
-out = in * 1000;
-g_print ("%" G_GINT32_FORMAT, out);
-</programlisting>
-</informalexample>
-</para>
-
-
-<!-- ##### 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,
-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.
-</para>
-
-<para>
-The following example prints "0x7b";
-<informalexample>
-<programlisting>
-gint16 value = 123;
-g_print ("%#" G_GINT16_MODIFIER "x", value);
-</programlisting>
-</informalexample>
-</para>
-
- Since: 2.4
-
-<!-- ##### MACRO G_GINT32_FORMAT ##### -->
-<para>
-This is the platform dependent conversion specifier for scanning and
-printing values of type #gint32. See also #G_GINT16_FORMAT.
-</para>
-
-
-<!-- ##### 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.
-</para>
-
- Since: 2.4
-
-<!-- ##### MACRO G_GINT64_CONSTANT ##### -->
-<para>
-This macro is used to insert 64-bit integer literals into the source code.
-</para>
-
- val: a literal integer value, e.g. 0x1d636b02300a7aa7U.
-
-<!-- ##### MACRO G_GINT64_FORMAT ##### -->
-<para>
-This is the platform dependent conversion specifier for scanning and
-printing values of type #gint64. See also #G_GINT16_FORMAT.
-</para>
-
-<note>
-<para>
-Some platforms do not support scanning and printing 64 bit integers,
-even though the types are supported. On such platforms #G_GINT64_FORMAT
-is not defined. Note that scanf() may not support 64 bit integers, even
-if #G_GINT64_FORMAT is defined. Due to its weak error handling, scanf() is not
-recommended for parsing anyway; consider using g_strtoull() instead.
-</para>
-</note>
-
-
-<!-- ##### 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.
-</para>
-
-<note>
-<para>
-Some platforms do not support printing 64 bit integers,
-even though the types are supported. On such platforms #G_GINT64_MODIFIER
-is not defined.
-</para>
-</note>
-
- Since: 2.4
-
-<!-- ##### MACRO G_GNUC_INTERNAL ##### -->
-<para>
-This attribute can be used for marking library functions as being used
-internally to the library only, which may allow the compiler to handle
-function calls more efficiently.
-Note that static functions do not need to be marked as internal in this way.
-See the GNU C documentation for details.
-</para>
-<para>
-When using a compiler that supports the GNU C hidden visibility attribute,
-this macro expands to <literal>__attribute__((visibility("hidden")))</literal>.
-When using the Sun Studio compiler, it expands to <literal>__hidden</literal>.
-</para>
-<para>
-Note that for portability, the attribute should be placed before the
-function declaration. While GCC allows the macro after the declaration,
-Sun Studio does not.
-</para>
-<informalexample><programlisting>
-G_GNUC_INTERNAL
-void _g_log_fallback_handler (const gchar *log_domain,
- GLogLevelFlags log_level,
- const gchar *message,
- gpointer unused_data);
-</programlisting></informalexample>
-
-Since: 2.6
-
-
-<!-- ##### MACRO G_GSIZE_FORMAT ##### -->
-<para>
-This is the platform dependent conversion specifier for scanning and
-printing values of type #gsize. See also #G_GINT16_FORMAT.
-</para>
-
- Since: 2.6
-
-<!-- ##### 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.
-</para>
-
- Since: 2.6
-
-<!-- ##### MACRO G_GSSIZE_FORMAT ##### -->
-<para>
-This is the platform dependent conversion specifier for scanning and
-printing values of type #gssize. See also #G_GINT16_FORMAT.
-</para>
-
- Since: 2.6
-
-<!-- ##### MACRO G_GUINT16_FORMAT ##### -->
-<para>
-This is the platform dependent conversion specifier for scanning and
-printing values of type #guint16. See also #G_GINT16_FORMAT.
-</para>
-
-
-<!-- ##### MACRO G_GUINT32_FORMAT ##### -->
-<para>
-This is the platform dependent conversion specifier for scanning and
-printing values of type #guint32. See also #G_GINT16_FORMAT.
-</para>
-
-
-<!-- ##### MACRO G_GUINT64_CONSTANT ##### -->
-<para>
-This macro is used to insert 64-bit unsigned integer literals into the
-source code.
-</para>
-
- val: a literal integer value, e.g. 0x1d636b02300a7aa7U.
- Since: 2.10
-
-<!-- ##### MACRO G_GUINT64_FORMAT ##### -->
-<para>
-This is the platform dependent conversion specifier for scanning and
-printing values of type #guint64. See also #G_GINT16_FORMAT.
-</para>
-
-<note>
-<para>
-Some platforms do not support scanning and printing 64 bit integers,
-even though the types are supported. On such platforms #G_GUINT64_FORMAT
-is not defined. Note that scanf() may not support 64 bit integers, even
-if #G_GINT64_FORMAT is defined. Due to its weak error handling, scanf() is not
-recommended for parsing anyway; consider using g_strtoull() instead.
-</para>
-</note>
-
-
-<!-- ##### MACRO G_HAVE_GINT64 ##### -->
-<para>
-This macro is defined if 64-bit signed and unsigned integers are available
-on the platform.
-</para>
-
- Deprecated: GLib requires 64-bit integer support since version 2.0, therefore
-%G_HAVE_GINT64 is <emphasis>always</emphasis> defined.
-
-<!-- ##### 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_HOOK_DEFERRED_DESTROY ##### -->
<para>
@@ -767,159 +267,6 @@
</para>
-<!-- ##### MACRO G_MAXDOUBLE ##### -->
-<para>
-The maximum value which can be held in a #gdouble.
-</para>
-
-
-<!-- ##### MACRO G_MAXFLOAT ##### -->
-<para>
-The maximum value which can be held in a #gfloat.
-</para>
-
-
-<!-- ##### MACRO G_MAXINT ##### -->
-<para>
-The maximum value which can be held in a #gint.
-</para>
-
-
-<!-- ##### MACRO G_MAXLONG ##### -->
-<para>
-The maximum value which can be held in a #glong.
-</para>
-
-
-<!-- ##### MACRO G_MAXOFFSET ##### -->
-<para>
-The maximum value which can be held in a #goffset.
-</para>
-
-
-<!-- ##### MACRO G_MAXSHORT ##### -->
-<para>
-The maximum value which can be held in a #gshort.
-</para>
-
-
-<!-- ##### MACRO G_MAXSIZE ##### -->
-<para>
-The maximum value which can be held in a #gsize.
-</para>
-
- Since: 2.4
-
-<!-- ##### MACRO G_MAXSSIZE ##### -->
-<para>
-The maximum value which can be held in a #gssize.
-</para>
-
- Since: 2.14
-
-<!-- ##### MACRO G_MAXUINT ##### -->
-<para>
-The maximum value which can be held in a #guint.
-</para>
-
-
-<!-- ##### MACRO G_MAXULONG ##### -->
-<para>
-The maximum value which can be held in a #gulong.
-</para>
-
-
-<!-- ##### MACRO G_MAXUSHORT ##### -->
-<para>
-The maximum value which can be held in a #gushort.
-</para>
-
-
-<!-- ##### MACRO G_MINDOUBLE ##### -->
-<para>
-The minimum positive value which can be held in a #gdouble.
-</para>
-<para>
-If you are interested in the smallest value which can be held in a #gdouble,
-use -G_MAXDOUBLE.
-</para>
-
-
-<!-- ##### MACRO G_MINFLOAT ##### -->
-<para>
-The minimum positive value which can be held in a #gfloat.
-</para>
-<para>
-If you are interested in the smallest value which can be held in a #gfloat,
-use -G_MAX_FLOAT.
-</para>
-
-
-<!-- ##### MACRO G_MININT ##### -->
-<para>
-The minimum value which can be held in a #gint.
-</para>
-
-
-<!-- ##### MACRO G_MINLONG ##### -->
-<para>
-The minimum value which can be held in a #glong.
-</para>
-
-
-<!-- ##### MACRO G_MINOFFSET ##### -->
-<para>
-The minimum value which can be held in a #goffset.
-</para>
-
-
-<!-- ##### MACRO G_MINSHORT ##### -->
-<para>
-The minimum value which can be held in a #gshort.
-</para>
-
-
-<!-- ##### MACRO G_MINSSIZE ##### -->
-<para>
-The minimum value which can be held in a #gssize.
-</para>
-
- Since: 2.14
-
-<!-- ##### MACRO G_MODULE_EXPORT ##### -->
-<para>
-Used to declare functions exported by modules. This is a no-op on Linux and
-Unices, but when compiling for Windows, it marks a symbol to be exported from
-the library or executable being built.
-</para>
-
-
-<!-- ##### MACRO G_MODULE_IMPORT ##### -->
-<para>
-Used to declare functions imported from modules.
-</para>
-
-
-<!-- ##### MACRO G_MODULE_SUFFIX ##### -->
-<para>
-Expands to the proper shared library suffix for the current platform
-without the leading dot. For the most Unices and Linux this is "so",
-for some HP-UX versions this is "sl" and for Windows this is "dll".
-</para>
-
-
-<!-- ##### MACRO G_THREADS_ENABLED ##### -->
-
-<para>
-This macro is defined if GLib was compiled with thread support. This
-does not necessarily mean that there is a thread implementation
-available, but it does mean that the infrastructure is in place and
-that once you provide a thread implementation to g_thread_init(), GLib
-will be multi-thread safe. If #G_THREADS_ENABLED is not defined, then
-Glib is not, and cannot be, multi-thread safe.
-</para>
-
-
<!-- ##### MACRO NAME_MAX ##### -->
<para>
Provided for UNIX emulation on Windows; equivalent to UNIX macro
@@ -1406,117 +753,6 @@
@mem: the memory to check.
-<!-- ##### MACRO g_memmove ##### -->
-<para>
-
-</para>
-
- dest:
- src:
- len:
-
-<!-- ##### FUNCTION g_module_build_path ##### -->
-<para>
-A portable way to build the filename of a module. The platform-specific
-prefix and suffix are added to the filename, if needed, and the result is
-added to the directory, using the correct separator character.
-</para>
-<para>
-The directory should specify the directory where the module can be found.
-It can be %NULL or an empty string to indicate that the module is in a standard
-platform-specific directory, though this is not recommended since the
-wrong module may be found.
-</para>
-<para>
-For example, calling g_module_build_path() on a Linux system with a @directory
-of <filename>/lib</filename> and a @module_name of "mylibrary" will return
-<filename>/lib/libmylibrary.so</filename>. On a Windows system, using
-<filename>\Windows</filename> as the directory it will return
-<filename>\Windows\mylibrary.dll</filename>.
-</para>
-
- directory: the directory where the module is. This can be %NULL or the empty
-string to indicate that the standard platform-specific directories will be
-used, though that is not recommended.
- module_name: the name of the module.
- Returns: the complete path of the module, including the standard library
-prefix and suffix. This should be freed when no longer needed.
-
-<!-- ##### FUNCTION g_module_close ##### -->
-<para>
-Closes a module.
-</para>
-
- module: a #GModule to close.
- Returns: %TRUE on success.
-
-<!-- ##### FUNCTION g_module_error ##### -->
-<para>
-Gets a string describing the last module error.
-</para>
-
- Returns: a string describing the last module error.
-
-<!-- ##### FUNCTION g_module_make_resident ##### -->
-<para>
-Ensures that a module will never be unloaded.
-Any future g_module_close() calls on the module will be ignored.
-</para>
-
- module: a #GModule to make permanently resident.
-
-<!-- ##### FUNCTION g_module_name ##### -->
-<para>
-Gets the filename from a #GModule.
-</para>
-
- module: a #GModule.
- Returns: the filename of the module, or "main" if the module is the main
-program itself.
-
-<!-- ##### FUNCTION g_module_open ##### -->
-<para>
-Opens a module. If the module has already been opened, its reference
-count is incremented.
-</para>
-
-<para>
-First of all g_module_open() tries to open @file_name as a module. If
-that fails and @file_name has the ".la"-suffix (and is a libtool archive)
-it tries to open the corresponding module. If that fails and it doesn't
-have the proper module suffix for the platform (#G_MODULE_SUFFIX), this
-suffix will be appended and the corresponding module will be opended. If
-that fails and @file_name doesn't have the ".la"-suffix, this suffix is
-appended and g_module_open() tries to open the corresponding module. If
-eventually that fails as well, %NULL is returned.
-</para>
-
- file_name: the name of the file containing the module, or %NULL to obtain
- a #GModule representing the main program itself.
- flags: the flags used for opening the module. This can be the logical
-OR of any of the #GModuleFlags.
- Returns: a #GModule on success, or %NULL on failure.
-
-<!-- ##### FUNCTION g_module_supported ##### -->
-<para>
-Checks if modules are supported on the current platform.
-</para>
-
- Returns: %TRUE if modules are supported.
-
-<!-- ##### FUNCTION g_module_symbol ##### -->
-<para>
-Gets a symbol pointer from a module, such as one exported by #G_MODULE_EXPORT.
-</para>
-<para>
-Note that a valid symbol can be %NULL.
-</para>
-
- module: a #GModule.
- symbol_name: the name of the symbol to find.
- symbol: returns the pointer to the symbol value.
- Returns: %TRUE on success.
-
<!-- ##### FUNCTION g_regex_error_quark ##### -->
<para>
@@ -1664,80 +900,6 @@
</para>
-<!-- ##### TYPEDEF gint16 ##### -->
-<para>
-A signed integer guaranteed to be 16 bits on all platforms.
-Values of this type can range from -32,768 to 32,767.
-</para>
-
-
-<!-- ##### TYPEDEF gint32 ##### -->
-<para>
-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>
-
-
-<!-- ##### TYPEDEF gint64 ##### -->
-<para>
-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.
-</para>
-
-
-<!-- ##### TYPEDEF gint8 ##### -->
-<para>
-A signed integer guaranteed to be 8 bits on all platforms.
-Values of this type can range from -128 to 127.
-</para>
-
-
-<!-- ##### TYPEDEF goffset ##### -->
-<para>
-A signed integer type that is used for file offsets, corresponding to the
-C99 type off64_t.
-</para>
-
-Since: 2.14
-
-
-<!-- ##### TYPEDEF gsize ##### -->
-<para>
-An unsigned integer type of the result of the sizeof operator, corresponding
-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.
-</para>
-
-
-<!-- ##### TYPEDEF gssize ##### -->
-<para>
-A signed variant of gsize, corresponding to the ssize_t defined on most platforms.
-</para>
-
-
-<!-- ##### TYPEDEF guint16 ##### -->
-<para>
-An unsigned integer guaranteed to be 16 bits on all platforms.
-Values of this type can range from 0 to 65,535.
-</para>
-
-
-<!-- ##### TYPEDEF guint32 ##### -->
-<para>
-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>
-
-
-<!-- ##### TYPEDEF guint8 ##### -->
-<para>
-An unsigned integer guaranteed to be 8 bits on all platforms.
-Values of this type can range from 0 to 255.
-</para>
-
-
<!-- ##### MACRO lseek ##### -->
<para>
Modified: branches/glib-2-18/docs/reference/glib/tmpl/limits.sgml
==============================================================================
--- branches/glib-2-18/docs/reference/glib/tmpl/limits.sgml (original)
+++ branches/glib-2-18/docs/reference/glib/tmpl/limits.sgml Thu Oct 16 21:24:27 2008
@@ -18,6 +18,69 @@
<!-- ##### SECTION Stability_Level ##### -->
+<!-- ##### MACRO G_MININT ##### -->
+<para>
+The minimum value which can be held in a #gint.
+</para>
+
+
+
+<!-- ##### MACRO G_MAXINT ##### -->
+<para>
+The maximum value which can be held in a #gint.
+</para>
+
+
+
+<!-- ##### MACRO G_MAXUINT ##### -->
+<para>
+The maximum value which can be held in a #guint.
+</para>
+
+
+
+<!-- ##### MACRO G_MINSHORT ##### -->
+<para>
+The minimum value which can be held in a #gshort.
+</para>
+
+
+
+<!-- ##### MACRO G_MAXSHORT ##### -->
+<para>
+The maximum value which can be held in a #gshort.
+</para>
+
+
+
+<!-- ##### MACRO G_MAXUSHORT ##### -->
+<para>
+The maximum value which can be held in a #gushort.
+</para>
+
+
+
+<!-- ##### MACRO G_MINLONG ##### -->
+<para>
+The minimum value which can be held in a #glong.
+</para>
+
+
+
+<!-- ##### MACRO G_MAXLONG ##### -->
+<para>
+The maximum value which can be held in a #glong.
+</para>
+
+
+
+<!-- ##### MACRO G_MAXULONG ##### -->
+<para>
+The maximum value which can be held in a #gulong.
+</para>
+
+
+
<!-- ##### MACRO G_MININT8 ##### -->
<para>
The minimum value which can be held in a #gint8.
@@ -111,3 +174,77 @@
+<!-- ##### MACRO G_MAXSIZE ##### -->
+<para>
+The maximum value which can be held in a #gsize.
+</para>
+
+ Since: 2.4
+
+
+<!-- ##### MACRO G_MINSSIZE ##### -->
+<para>
+The minimum value which can be held in a #gssize.
+</para>
+
+ Since: 2.14
+
+
+<!-- ##### MACRO G_MAXSSIZE ##### -->
+<para>
+The maximum value which can be held in a #gssize.
+</para>
+
+ Since: 2.14
+
+
+<!-- ##### MACRO G_MINOFFSET ##### -->
+<para>
+The minimum value which can be held in a #goffset.
+</para>
+
+
+
+<!-- ##### MACRO G_MAXOFFSET ##### -->
+<para>
+The maximum value which can be held in a #goffset.
+</para>
+
+
+
+<!-- ##### MACRO G_MINFLOAT ##### -->
+<para>
+The minimum positive value which can be held in a #gfloat.
+</para>
+<para>
+If you are interested in the smallest value which can be held in a #gfloat,
+use -G_MAX_FLOAT.
+</para>
+
+
+
+<!-- ##### MACRO G_MAXFLOAT ##### -->
+<para>
+The maximum value which can be held in a #gfloat.
+</para>
+
+
+
+<!-- ##### MACRO G_MINDOUBLE ##### -->
+<para>
+The minimum positive value which can be held in a #gdouble.
+</para>
+<para>
+If you are interested in the smallest value which can be held in a #gdouble,
+use -G_MAXDOUBLE.
+</para>
+
+
+
+<!-- ##### MACRO G_MAXDOUBLE ##### -->
+<para>
+The maximum value which can be held in a #gdouble.
+</para>
+
+
+
Modified: branches/glib-2-18/docs/reference/glib/tmpl/macros_misc.sgml
==============================================================================
--- branches/glib-2-18/docs/reference/glib/tmpl/macros_misc.sgml (original)
+++ branches/glib-2-18/docs/reference/glib/tmpl/macros_misc.sgml Thu Oct 16 21:24:27 2008
@@ -320,6 +320,46 @@
+<!-- ##### 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
+internally to the library only, which may allow the compiler to handle
+function calls more efficiently.
+Note that static functions do not need to be marked as internal in this way.
+See the GNU C documentation for details.
+</para>
+<para>
+When using a compiler that supports the GNU C hidden visibility attribute,
+this macro expands to <literal>__attribute__((visibility("hidden")))</literal>.
+When using the Sun Studio compiler, it expands to <literal>__hidden</literal>.
+</para>
+<para>
+Note that for portability, the attribute should be placed before the
+function declaration. While GCC allows the macro after the declaration,
+Sun Studio does not.
+</para>
+<informalexample><programlisting>
+G_GNUC_INTERNAL
+void _g_log_fallback_handler (const gchar *log_domain,
+ GLogLevelFlags log_level,
+ const gchar *message,
+ gpointer unused_data);
+</programlisting></informalexample>
+
+Since: 2.6
+
+
+
<!-- ##### MACRO G_GNUC_MAY_ALIAS ##### -->
<para>
Expands to the GNU C <literal>may_alias</literal> type attribute
@@ -379,3 +419,160 @@
@Since: 2.4
+<!-- ##### 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,
+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.
+</para>
+
+<para>
+The following example prints "0x7b";
+<informalexample>
+<programlisting>
+gint16 value = 123;
+g_print ("%#" G_GINT16_MODIFIER "x", value);
+</programlisting>
+</informalexample>
+</para>
+
+ Since: 2.4
+
+
+<!-- ##### MACRO G_GINT16_FORMAT ##### -->
+<para>
+This is the platform dependent conversion specifier for scanning and
+printing values of type #gint16. 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.
+</para>
+
+<para>
+<informalexample>
+<programlisting>
+gint16 in;
+gint32 out;
+sscanf ("42", "%" G_GINT16_FORMAT, &in)
+out = in * 1000;
+g_print ("%" G_GINT32_FORMAT, out);
+</programlisting>
+</informalexample>
+</para>
+
+
+
+<!-- ##### MACRO G_GUINT16_FORMAT ##### -->
+<para>
+This is the platform dependent conversion specifier for scanning and
+printing values of type #guint16. See also #G_GINT16_FORMAT.
+</para>
+
+
+
+<!-- ##### 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.
+</para>
+
+ Since: 2.4
+
+
+<!-- ##### MACRO G_GINT32_FORMAT ##### -->
+<para>
+This is the platform dependent conversion specifier for scanning and
+printing values of type #gint32. See also #G_GINT16_FORMAT.
+</para>
+
+
+
+<!-- ##### MACRO G_GUINT32_FORMAT ##### -->
+<para>
+This is the platform dependent conversion specifier for scanning and
+printing values of type #guint32. See also #G_GINT16_FORMAT.
+</para>
+
+
+
+<!-- ##### 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.
+</para>
+
+<note>
+<para>
+Some platforms do not support printing 64 bit integers,
+even though the types are supported. On such platforms #G_GINT64_MODIFIER
+is not defined.
+</para>
+</note>
+
+ Since: 2.4
+
+
+<!-- ##### MACRO G_GINT64_FORMAT ##### -->
+<para>
+This is the platform dependent conversion specifier for scanning and
+printing values of type #gint64. See also #G_GINT16_FORMAT.
+</para>
+
+<note>
+<para>
+Some platforms do not support scanning and printing 64 bit integers,
+even though the types are supported. On such platforms #G_GINT64_FORMAT
+is not defined. Note that scanf() may not support 64 bit integers, even
+if #G_GINT64_FORMAT is defined. Due to its weak error handling, scanf() is not
+recommended for parsing anyway; consider using g_strtoull() instead.
+</para>
+</note>
+
+
+
+<!-- ##### MACRO G_GUINT64_FORMAT ##### -->
+<para>
+This is the platform dependent conversion specifier for scanning and
+printing values of type #guint64. See also #G_GINT16_FORMAT.
+</para>
+
+<note>
+<para>
+Some platforms do not support scanning and printing 64 bit integers,
+even though the types are supported. On such platforms #G_GUINT64_FORMAT
+is not defined. Note that scanf() may not support 64 bit integers, even
+if #G_GINT64_FORMAT is defined. Due to its weak error handling, scanf() is not
+recommended for parsing anyway; consider using g_strtoull() instead.
+</para>
+</note>
+
+
+
+<!-- ##### 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.
+</para>
+
+ Since: 2.6
+
+
+<!-- ##### MACRO G_GSIZE_FORMAT ##### -->
+<para>
+This is the platform dependent conversion specifier for scanning and
+printing values of type #gsize. See also #G_GINT16_FORMAT.
+</para>
+
+ Since: 2.6
+
+
+<!-- ##### MACRO G_GSSIZE_FORMAT ##### -->
+<para>
+This is the platform dependent conversion specifier for scanning and
+printing values of type #gssize. See also #G_GINT16_FORMAT.
+</para>
+
+ Since: 2.6
+
+
Modified: branches/glib-2-18/docs/reference/glib/tmpl/main.sgml
==============================================================================
--- branches/glib-2-18/docs/reference/glib/tmpl/main.sgml (original)
+++ branches/glib-2-18/docs/reference/glib/tmpl/main.sgml Thu Oct 16 21:24:27 2008
@@ -645,6 +645,15 @@
@Returns:
+<!-- ##### TYPEDEF GPid ##### -->
+<para>
+A type which is used to hold a process identification.
+On Unix, processes are identified by a process id (an
+integer), while Windows uses process handles (which are
+pointers).
+</para>
+
+
<!-- ##### USER_FUNCTION GChildWatchFunc ##### -->
<para>
The type of functions to be called when a child exists.
Modified: branches/glib-2-18/docs/reference/glib/tmpl/memory.sgml
==============================================================================
--- branches/glib-2-18/docs/reference/glib/tmpl/memory.sgml (original)
+++ branches/glib-2-18/docs/reference/glib/tmpl/memory.sgml Thu Oct 16 21:24:27 2008
@@ -258,6 +258,16 @@
@Returns: Pointer to stack space for @n_structs chunks of type @struct_type
+<!-- ##### MACRO g_memmove ##### -->
+<para>
+
+</para>
+
+ dest:
+ src:
+ len:
+
+
<!-- ##### FUNCTION g_memdup ##### -->
<para>
Allocates @byte_size bytes of memory, and copies @byte_size bytes into it
Modified: branches/glib-2-18/docs/reference/glib/tmpl/modules.sgml
==============================================================================
--- branches/glib-2-18/docs/reference/glib/tmpl/modules.sgml (original)
+++ branches/glib-2-18/docs/reference/glib/tmpl/modules.sgml Thu Oct 16 21:24:27 2008
@@ -99,3 +99,186 @@
<!-- ##### SECTION Stability_Level ##### -->
+<!-- ##### STRUCT GModule ##### -->
+<para>
+The #GModule struct is an opaque data structure to represent a
+<link linkend="glib-Dynamic-Loading-of-Modules">Dynamically-Loaded Module</link>.
+It should only be accessed via the following functions.
+</para>
+
+
+<!-- ##### FUNCTION g_module_supported ##### -->
+<para>
+Checks if modules are supported on the current platform.
+</para>
+
+ Returns: %TRUE if modules are supported.
+
+
+<!-- ##### FUNCTION g_module_build_path ##### -->
+<para>
+A portable way to build the filename of a module. The platform-specific
+prefix and suffix are added to the filename, if needed, and the result is
+added to the directory, using the correct separator character.
+</para>
+<para>
+The directory should specify the directory where the module can be found.
+It can be %NULL or an empty string to indicate that the module is in a standard
+platform-specific directory, though this is not recommended since the
+wrong module may be found.
+</para>
+<para>
+For example, calling g_module_build_path() on a Linux system with a @directory
+of <filename>/lib</filename> and a @module_name of "mylibrary" will return
+<filename>/lib/libmylibrary.so</filename>. On a Windows system, using
+<filename>\Windows</filename> as the directory it will return
+<filename>\Windows\mylibrary.dll</filename>.
+</para>
+
+ directory: the directory where the module is. This can be %NULL or the empty
+string to indicate that the standard platform-specific directories will be
+used, though that is not recommended.
+ module_name: the name of the module.
+ Returns: the complete path of the module, including the standard library
+prefix and suffix. This should be freed when no longer needed.
+
+
+<!-- ##### FUNCTION g_module_open ##### -->
+<para>
+Opens a module. If the module has already been opened, its reference
+count is incremented.
+</para>
+
+<para>
+First of all g_module_open() tries to open @file_name as a module. If
+that fails and @file_name has the ".la"-suffix (and is a libtool archive)
+it tries to open the corresponding module. If that fails and it doesn't
+have the proper module suffix for the platform (#G_MODULE_SUFFIX), this
+suffix will be appended and the corresponding module will be opended. If
+that fails and @file_name doesn't have the ".la"-suffix, this suffix is
+appended and g_module_open() tries to open the corresponding module. If
+eventually that fails as well, %NULL is returned.
+</para>
+
+ file_name: the name of the file containing the module, or %NULL to obtain
+ a #GModule representing the main program itself.
+ flags: the flags used for opening the module. This can be the logical
+OR of any of the #GModuleFlags.
+ Returns: a #GModule on success, or %NULL on failure.
+
+
+<!-- ##### ENUM GModuleFlags ##### -->
+<para>
+Flags passed to g_module_open(). Note that these flags are
+not supported on all platforms.
+</para>
+
+ G_MODULE_BIND_LAZY: specifies that symbols are only resolved when needed.
+ The default action is to bind all symbols when the module is loaded.
+ G_MODULE_BIND_LOCAL: specifies that symbols in the module should
+ not be added to the global name space. The default action on most
+ platforms is to place symbols in the module in the global name space,
+ which may cause conflicts with existing symbols.
+ G_MODULE_BIND_MASK: mask for all flags.
+
+<!-- ##### FUNCTION g_module_symbol ##### -->
+<para>
+Gets a symbol pointer from a module, such as one exported by #G_MODULE_EXPORT.
+</para>
+<para>
+Note that a valid symbol can be %NULL.
+</para>
+
+ module: a #GModule.
+ symbol_name: the name of the symbol to find.
+ symbol: returns the pointer to the symbol value.
+ Returns: %TRUE on success.
+
+
+<!-- ##### FUNCTION g_module_name ##### -->
+<para>
+Gets the filename from a #GModule.
+</para>
+
+ module: a #GModule.
+ Returns: the filename of the module, or "main" if the module is the main
+program itself.
+
+
+<!-- ##### FUNCTION g_module_make_resident ##### -->
+<para>
+Ensures that a module will never be unloaded.
+Any future g_module_close() calls on the module will be ignored.
+</para>
+
+ module: a #GModule to make permanently resident.
+
+
+<!-- ##### FUNCTION g_module_close ##### -->
+<para>
+Closes a module.
+</para>
+
+ module: a #GModule to close.
+ Returns: %TRUE on success.
+
+
+<!-- ##### FUNCTION g_module_error ##### -->
+<para>
+Gets a string describing the last module error.
+</para>
+
+ Returns: a string describing the last module error.
+
+
+<!-- ##### USER_FUNCTION GModuleCheckInit ##### -->
+<para>
+Specifies the type of the module initialization function.
+<indexterm zone="g-module-check-init"><primary>g_module_check_init</primary></indexterm>
+If a module contains a function named g_module_check_init() it is called
+automatically when the module is loaded. It is passed the #GModule structure
+and should return %NULL on success or a string describing the initialization
+error.
+</para>
+
+ module: the #GModule corresponding to the module which has just been loaded.
+ Returns: %NULL on success, or a string describing the initialization error.
+
+
+<!-- ##### USER_FUNCTION GModuleUnload ##### -->
+<para>
+<indexterm zone="g-module-unload"><primary>g_module_unload</primary></indexterm>
+Specifies the type of the module function called when it is unloaded.
+If a module contains a function named g_module_unload() it is called
+automatically when the module is unloaded.
+It is passed the #GModule structure.
+</para>
+
+ module: the #GModule about to be unloaded.
+
+
+<!-- ##### MACRO G_MODULE_SUFFIX ##### -->
+<para>
+Expands to the proper shared library suffix for the current platform
+without the leading dot. For the most Unices and Linux this is "so",
+for some HP-UX versions this is "sl" and for Windows this is "dll".
+</para>
+
+
+
+<!-- ##### MACRO G_MODULE_EXPORT ##### -->
+<para>
+Used to declare functions exported by modules. This is a no-op on Linux and
+Unices, but when compiling for Windows, it marks a symbol to be exported from
+the library or executable being built.
+</para>
+
+
+
+<!-- ##### MACRO G_MODULE_IMPORT ##### -->
+<para>
+Used to declare functions imported from modules.
+</para>
+
+
+
Modified: branches/glib-2-18/docs/reference/glib/tmpl/threads.sgml
==============================================================================
--- branches/glib-2-18/docs/reference/glib/tmpl/threads.sgml (original)
+++ branches/glib-2-18/docs/reference/glib/tmpl/threads.sgml Thu Oct 16 21:24:27 2008
@@ -89,6 +89,19 @@
<!-- ##### SECTION Stability_Level ##### -->
+<!-- ##### MACRO G_THREADS_ENABLED ##### -->
+
+<para>
+This macro is defined if GLib was compiled with thread support. This
+does not necessarily mean that there is a thread implementation
+available, but it does mean that the infrastructure is in place and
+that once you provide a thread implementation to g_thread_init(), GLib
+will be multi-thread safe. If #G_THREADS_ENABLED is not defined, then
+Glib is not, and cannot be, multi-thread safe.
+</para>
+
+
+
<!-- ##### MACRO G_THREADS_IMPL_POSIX ##### -->
<para>
Modified: branches/glib-2-18/docs/reference/glib/tmpl/type_conversion.sgml
==============================================================================
--- branches/glib-2-18/docs/reference/glib/tmpl/type_conversion.sgml (original)
+++ branches/glib-2-18/docs/reference/glib/tmpl/type_conversion.sgml Thu Oct 16 21:24:27 2008
@@ -57,6 +57,52 @@
<!-- ##### SECTION Stability_Level ##### -->
+<!-- ##### MACRO GINT_TO_POINTER ##### -->
+<para>
+Stuffs an integer into a pointer type.
+</para>
+<para>
+Remember, YOU MAY NOT STORE POINTERS IN INTEGERS. THIS IS NOT PORTABLE
+IN ANY WAY SHAPE OR FORM. These macros <emphasis>ONLY</emphasis> allow
+storing integers in pointers, and only preserve 32 bits of the
+integer; values outside the range of a 32-bit integer will be mangled.
+</para>
+
+ i: integer to stuff into a pointer.
+
+
+<!-- ##### MACRO GPOINTER_TO_INT ##### -->
+<para>
+Extracts an integer from a pointer. The integer must have
+been stored in the pointer with GINT_TO_POINTER().
+</para>
+<para>
+Remember, YOU MAY NOT STORE POINTERS IN INTEGERS. THIS IS NOT PORTABLE
+IN ANY WAY SHAPE OR FORM. These macros <emphasis>ONLY</emphasis> allow
+storing integers in pointers, and only preserve 32 bits of the
+integer; values outside the range of a 32-bit integer will be mangled.
+</para>
+
+ p: pointer containing an integer.
+
+
+<!-- ##### MACRO GUINT_TO_POINTER ##### -->
+<para>
+Stuffs an unsigned integer into a pointer type.
+</para>
+
+ u: unsigned integer to stuff into the pointer.
+
+
+<!-- ##### MACRO GPOINTER_TO_UINT ##### -->
+<para>
+Extracts an unsigned integer from a pointer. The integer must have
+been stored in the pointer with GUINT_TO_POINTER().
+</para>
+
+ p: pointer to extract an unsigned integer from.
+
+
<!-- ##### MACRO GSIZE_TO_POINTER ##### -->
<para>
Stuffs a #gsize into a pointer type.
Modified: branches/glib-2-18/docs/reference/glib/tmpl/types.sgml
==============================================================================
--- branches/glib-2-18/docs/reference/glib/tmpl/types.sgml (original)
+++ branches/glib-2-18/docs/reference/glib/tmpl/types.sgml Thu Oct 16 21:24:27 2008
@@ -119,6 +119,66 @@
</para>
+<!-- ##### TYPEDEF gint8 ##### -->
+<para>
+A signed integer guaranteed to be 8 bits on all platforms.
+Values of this type can range from -128 to 127.
+</para>
+
+
+<!-- ##### TYPEDEF guint8 ##### -->
+<para>
+An unsigned integer guaranteed to be 8 bits on all platforms.
+Values of this type can range from 0 to 255.
+</para>
+
+
+<!-- ##### TYPEDEF gint16 ##### -->
+<para>
+A signed integer guaranteed to be 16 bits on all platforms.
+Values of this type can range from -32,768 to 32,767.
+</para>
+
+
+<!-- ##### TYPEDEF guint16 ##### -->
+<para>
+An unsigned integer guaranteed to be 16 bits on all platforms.
+Values of this type can range from 0 to 65,535.
+</para>
+
+
+<!-- ##### TYPEDEF gint32 ##### -->
+<para>
+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>
+
+
+<!-- ##### TYPEDEF guint32 ##### -->
+<para>
+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>
+
+
+<!-- ##### MACRO G_HAVE_GINT64 ##### -->
+<para>
+This macro is defined if 64-bit signed and unsigned integers are available
+on the platform.
+</para>
+
+ Deprecated: GLib requires 64-bit integer support since version 2.0, therefore
+%G_HAVE_GINT64 is <emphasis>always</emphasis> defined.
+
+
+<!-- ##### TYPEDEF gint64 ##### -->
+<para>
+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.
+</para>
+
+
<!-- ##### FUNCTION guint64 ##### -->
<para>
An unsigned integer guaranteed to be 64 bits on all platforms.
@@ -128,6 +188,24 @@
@Returns:
+<!-- ##### MACRO G_GINT64_CONSTANT ##### -->
+<para>
+This macro is used to insert 64-bit integer literals into the source code.
+</para>
+
+ val: a literal integer value, e.g. 0x1d636b02300a7aa7U.
+
+
+<!-- ##### MACRO G_GUINT64_CONSTANT ##### -->
+<para>
+This macro is used to insert 64-bit unsigned integer literals into the
+source code.
+</para>
+
+ val: a literal integer value, e.g. 0x1d636b02300a7aa7U.
+ Since: 2.10
+
+
<!-- ##### TYPEDEF gfloat ##### -->
<para>
Corresponds to the standard C <type>float</type> type.
@@ -142,3 +220,27 @@
</para>
+<!-- ##### TYPEDEF gsize ##### -->
+<para>
+An unsigned integer type of the result of the sizeof operator, corresponding
+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.
+</para>
+
+
+<!-- ##### TYPEDEF gssize ##### -->
+<para>
+A signed variant of gsize, corresponding to the ssize_t defined on most platforms.
+</para>
+
+
+<!-- ##### TYPEDEF goffset ##### -->
+<para>
+A signed integer type that is used for file offsets, corresponding to the
+C99 type off64_t.
+</para>
+
+Since: 2.14
+
+
Modified: branches/glib-2-18/docs/reference/glib/tmpl/version.sgml
==============================================================================
--- branches/glib-2-18/docs/reference/glib/tmpl/version.sgml (original)
+++ branches/glib-2-18/docs/reference/glib/tmpl/version.sgml Thu Oct 16 21:24:27 2008
@@ -87,6 +87,36 @@
@Returns:
+<!-- ##### MACRO GLIB_MAJOR_VERSION ##### -->
+<para>
+The major version number of the GLib library.
+Like #glib_major_version, but from the headers used at
+application compile time, rather than from the library linked against
+at application run time.
+</para>
+
+
+
+<!-- ##### MACRO GLIB_MINOR_VERSION ##### -->
+<para>
+The minor version number of the GLib library.
+Like #gtk_minor_version, but from the headers used at
+application compile time, rather than from the library linked against
+at application run time.
+</para>
+
+
+
+<!-- ##### MACRO GLIB_MICRO_VERSION ##### -->
+<para>
+The micro version number of the GLib library.
+Like #gtk_micro_version, but from the headers used at
+application compile time, rather than from the library linked against
+at application run time.
+</para>
+
+
+
<!-- ##### MACRO GLIB_CHECK_VERSION ##### -->
<para>
Checks the version of the GLib library.
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]