luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-07-30 05:43:28 +02:00
Code Issues Packages Projects Releases Wiki Activity

Reword some docs comments to avoid 'Returns ...'

Browse Source 
If gtk-doc sees 'Returns ...' written in the text of the documentation
for a macro, it thinks that you are talking about the return value.

Avoid doing that and use 'Returns:' explicitly if we mean to.
This commit is contained in:
Ryan Lortie
2011-07-22 12:57:59 +02:00
parent a0ed253718
commit 4f36eb0f6d
2 changed files with 20 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
glib/gutils.h
View File

@@ -452,9 +452,8 @@ const gchar * glib_check_version (guint required_major,
* @minor: the minor version to check for
* @micro: the micro version to check for
*
* Checks the version of the GLib library.
* Returns %TRUE if the version of the GLib header files
* is the same as or newer than the passed-in version.
* Checks the version of the GLib library that is being compiled
* against.
*
* <example>
* <title>Checking the version of the GLib library</title>
@@ -463,6 +462,11 @@ const gchar * glib_check_version (guint required_major,
* g_error ("GLib version 1.2.0 or above is needed");
* </programlisting>
* </example>
*
* See glib_check_version() for a runtime check.
*
* Returns: %TRUE if the version of the GLib header files
* is the same as or newer than the passed-in version.
*/
#define GLIB_CHECK_VERSION(major,minor,micro) \
(GLIB_MAJOR_VERSION > (major) || \