From: Matthias Clasen Date: Wed, 20 Jul 2005 15:41:19 +0000 (+0000) Subject: Add some discouraging comments to the G_INLINE_FUNC macros. (#310836, X-Git-Url: http://git.openbox.org/?a=commitdiff_plain;h=e81747cdc09f1f72a42b7c4088417224f7f36417;p=dana%2Fcg-glib.git Add some discouraging comments to the G_INLINE_FUNC macros. (#310836, 2005-07-20 Matthias Clasen * glib/tmpl/macros_misc.sgml: Add some discouraging comments to the G_INLINE_FUNC macros. (#310836, Callum McKenzie) --- diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 1f426de2..3705502e 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,9 @@ +2005-07-20 Matthias Clasen + + * glib/tmpl/macros_misc.sgml: Add some discouraging + comments to the G_INLINE_FUNC macros. (#310836, + Callum McKenzie) + 2005-07-19 Matthias Clasen * glib/tmpl/byte_order.sgml: Add docs for #307047, diff --git a/docs/reference/glib/tmpl/macros_misc.sgml b/docs/reference/glib/tmpl/macros_misc.sgml index 7ac96cae..9a51aab0 100644 --- a/docs/reference/glib/tmpl/macros_misc.sgml +++ b/docs/reference/glib/tmpl/macros_misc.sgml @@ -20,10 +20,18 @@ by application programmers. -Used to declare inline functions. If inline functions are not supported on -the particular platform, the macro evaluates to the empty string. +This macro is used to export function prototypes so they can be linked +with an external version when no inlining is performed. The file which +implements the functions should define %G_IMPLEMENTS_INLINES +before including the headers which contain %G_INLINE_FUNC declarations. +Since inlining is very compiler-dependent using these macros correctly +is very difficult. Their use is strongly discouraged. + + +This macro is often mistaken for a replacement for the inline keyword; +inline is already declared in a portable manner in the glib headers +and can be used normally. -