From: Matthias Clasen Date: Mon, 1 Oct 2001 18:11:58 +0000 (+0000) Subject: consistently refer to GTK+. X-Git-Url: http://git.openbox.org/?a=commitdiff_plain;h=a6e1fafdc9847d61533a8250c64ad13ebefc50e8;p=dana%2Fcg-glib.git consistently refer to GTK+. * glib/tmpl/caches.sgml, glib/tmpl/datalist.sgml, glib/tmpl/hash_tables.sgml, glib/tmpl/messages.sgml, glib/tmpl/misc_utils.sgml: consistently refer to GTK+. * glib/tmpl/error_reporting.sgml, glib/tmpl/fileutils.sgml, glib/tmpl/windows.sgml, glib/tmpl/modules.sgml, glib/tmpl/linked_lists_single.sgml, glib/tmpl/trees-nary.sgml, glib/tmpl/trees-binary.sgml, glib/tmpl/timers.sgml: Markup fixes. --- diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 76cdcbd5..7683da3b 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,14 @@ +2001-10-01 Matthias Clasen + + * glib/tmpl/caches.sgml, glib/tmpl/datalist.sgml, + glib/tmpl/hash_tables.sgml, glib/tmpl/messages.sgml, + glib/tmpl/misc_utils.sgml: consistently refer to GTK+. + + * glib/tmpl/error_reporting.sgml, glib/tmpl/fileutils.sgml, + glib/tmpl/windows.sgml, glib/tmpl/modules.sgml, + glib/tmpl/linked_lists_single.sgml, glib/tmpl/trees-nary.sgml, + glib/tmpl/trees-binary.sgml, glib/tmpl/timers.sgml: Markup fixes. + 2001-09-30 Matthias Clasen * glib/tmpl/arrays.sgml,glib/tmpl/arrays_byte.sgml diff --git a/docs/reference/glib/tmpl/caches.sgml b/docs/reference/glib/tmpl/caches.sgml index 8c00ae5d..268859d0 100644 --- a/docs/reference/glib/tmpl/caches.sgml +++ b/docs/reference/glib/tmpl/caches.sgml @@ -10,7 +10,7 @@ A #GCache allows sharing of complex data structures, in order to save system resources. -GTK uses a #GCache for both GtkStyles and GdkGCs. These consume a lot of +GTK+ uses a #GCache for both GtkStyles and GdkGCs. These consume a lot of resources, so a #GCache is used to see if a GtkStyle or GdkGC with the required properties already exists. If it does, then the existing GtkStyle or GdkGC is used instead of creating a new one. diff --git a/docs/reference/glib/tmpl/datalist.sgml b/docs/reference/glib/tmpl/datalist.sgml index bb15c58c..06363980 100644 --- a/docs/reference/glib/tmpl/datalist.sgml +++ b/docs/reference/glib/tmpl/datalist.sgml @@ -14,7 +14,7 @@ The #GQuark methods are quicker, since the strings have to be converted to #GQuarks anyway. -Data lists are used in GTK for associating arbitrary data with +Data lists are used in GTK+ for associating arbitrary data with GtkObjects, using gtk_object_set_data() and related functions. diff --git a/docs/reference/glib/tmpl/error_reporting.sgml b/docs/reference/glib/tmpl/error_reporting.sgml index 1132ec1a..454c6e7d 100644 --- a/docs/reference/glib/tmpl/error_reporting.sgml +++ b/docs/reference/glib/tmpl/error_reporting.sgml @@ -42,7 +42,7 @@ For example: gchar* g_file_get_contents (const gchar *filename, GError **error); -If you pass a non-NULL value for the error argument, it should +If you pass a non-%NULL value for the error argument, it should point to a location where an error can be placed. For example: gchar *contents; @@ -65,14 +65,14 @@ else Note that err != NULL in this example is a reliable indicator of whether g_file_get_contents() failed. Also, g_file_get_contents() uses the -convention that a NULL return value means an error occurred (but not +convention that a %NULL return value means an error occurred (but not all functions use this convention). -Because g_file_get_contents() returns NULL on failure, if you are only +Because g_file_get_contents() returns %NULL on failure, if you are only interested in whether it failed and don't need to display an error message, you -can pass NULL for the error argument: +can pass %NULL for the error argument: contents = g_file_get_contents ("foo.txt", NULL); /* ignore errors */ if (contents != NULL) @@ -88,10 +88,10 @@ the module the error-reporting function is located in, code indicates the specific error that occurred, and message is a user-readable error message with as many details as possible. Several functions are provided to deal with an error received from a called function: -g_error_matches() returns TRUE if the error matches a given domain and code, +g_error_matches() returns %TRUE if the error matches a given domain and code, g_propagate_error() copies an error into an error location (so the calling function will receive it), and g_clear_error() clears an error location by -freeing the error and resetting the location to NULL. To display an error to the +freeing the error and resetting the location to %NULL. To display an error to the user, simply display error->message, perhaps along with additional context known only to the calling function (the file being opened, or whatever -- though in the g_file_get_contents() case, @@ -102,7 +102,7 @@ whatever -- though in the g_file_get_contents() case, When implementing a function that can report errors, the basic tool is g_set_error(). Typically, if a fatal error occurs you want to g_set_error(), then return immediately. g_set_error() does nothing if the error location passed -to it is NULL. Here's an example: +to it is %NULL. Here's an example: gint foo_open_file (GError **error) @@ -129,7 +129,7 @@ foo_open_file (GError **error) Things are somewhat more complicated if you yourself call another function that can report a #GError. If the sub-function indicates fatal errors in some way -other than reporting a #GError, such as by returning TRUE on success, you can +other than reporting a #GError, such as by returning %TRUE on success, you can simply do the following: gboolean @@ -152,7 +152,7 @@ my_function_that_can_fail (GError **err) If the sub-function does not indicate errors other than by reporting a #GError, -you need to create a temporary #GError since the passed-in one may be NULL. +you need to create a temporary #GError since the passed-in one may be %NULL. g_propagate_error() is intended for use in this case. gboolean @@ -201,12 +201,12 @@ my_function_that_can_fail (GError **err) } tmp_error should be checked immediately after -sub_function_that_can_fail(), and either cleared or propagated upward. The rule +sub_function_that_can_fail(), and either cleared or propagated upward. The rule is: after each error, you must either handle the error, or return it to the -calling function. Note that passing NULL for the error location is the +calling function. Note that passing %NULL for the error location is the equivalent of handling an error by always doing nothing about it. So the -following code is fine, assuming errors in sub_function_that_can_fail() are not -fatal to my_function_that_can_fail(): +following code is fine, assuming errors in sub_function_that_can_fail() are not +fatal to my_function_that_can_fail(): gboolean my_function_that_can_fail (GError **err) @@ -230,7 +230,7 @@ my_function_that_can_fail (GError **err) -Note that passing NULL for the error location ignores +Note that passing %NULL for the error location ignores errors; it's equivalent to try { sub_function_that_can_fail (); } catch (...) {} in C++. It does not mean to leave errors unhandled; it means to handle them by doing nothing. @@ -289,17 +289,17 @@ Summary of rules for use of #GError: - The caller may pass NULL for the #GError** if they are not interested + The caller may pass %NULL for the #GError** if they are not interested in details of the exact error that occurred. - If NULL is passed for the #GError** argument, then errors should + If %NULL is passed for the #GError** argument, then errors should not be returned to the caller, but your function should still abort and return if an error occurs. That is, control flow should - not be affected by whether the caller wants to get a #GError. + not be affected by whether the caller wants to get a #GError. @@ -315,7 +315,7 @@ Summary of rules for use of #GError: - A #GError* must be initialized to NULL before passing its address to + A #GError* must be initialized to %NULL before passing its address to a function that can report errors. @@ -323,7 +323,7 @@ Summary of rules for use of #GError: "Piling up" errors is always a bug. That is, if you assign a new - #GError to a #GError* that is non-NULL, thus overwriting the previous + #GError to a #GError* that is non-%NULL, thus overwriting the previous error, it indicates that you should have aborted the operation instead of continuing. If you were able to continue, you should have cleared the previous error with g_clear_error(). g_set_error() will complain @@ -335,17 +335,17 @@ Summary of rules for use of #GError: By convention, if you return a boolean value indicating success - then TRUE means success and FALSE means failure. If FALSE is returned, - the error must be set to a non-NULL value. + then %TRUE means success and %FALSE means failure. If %FALSE is returned, + the error must be set to a non-%NULL value. - A NULL return value is also frequently used to mean that an error - occurred. You should make clear in your documentation whether NULL is - a valid return value in non-error cases; if NULL is a valid value, + A %NULL return value is also frequently used to mean that an error + occurred. You should make clear in your documentation whether %NULL is + a valid return value in non-error cases; if %NULL is a valid value, then users must check whether an error was returned to see if the function succeeded. @@ -355,7 +355,7 @@ Summary of rules for use of #GError: When implementing a function that can report errors, you may want to add a check at the top of your function that the error return location - is either NULL or contains a NULL error + is either %NULL or contains a %NULL error (e.g. g_return_if_fail (error == NULL || *error == NULL);). @@ -375,9 +375,9 @@ Summary of rules for use of #GError: -@domain: error domain, e.g. #G_FILE_ERROR -@code: error code, e.g. %G_FILE_ERROR_NOENT -@message: human-readable informative error message +@domain: error domain, e.g. #G_FILE_ERROR. +@code: error code, e.g. %G_FILE_ERROR_NOENT. +@message: human-readable informative error message. diff --git a/docs/reference/glib/tmpl/fileutils.sgml b/docs/reference/glib/tmpl/fileutils.sgml index c13bbfcb..5949194b 100644 --- a/docs/reference/glib/tmpl/fileutils.sgml +++ b/docs/reference/glib/tmpl/fileutils.sgml @@ -16,9 +16,9 @@ File Utilities -Values corresponding to "errno" codes returned from file operations on -UNIX. Unlike errno codes, #GFileError values are available on all -systems, even Windows. The exact meaning of each code depends on what +Values corresponding to errno codes returned from file operations +on UNIX. Unlike errno codes, #GFileError values are available on +all systems, even Windows. The exact meaning of each code depends on what sort of file operation you were performing; the UNIX documentation gives more details. The following error code descriptions come from the GNU C Library manual, and are under the copyright diff --git a/docs/reference/glib/tmpl/hash_tables.sgml b/docs/reference/glib/tmpl/hash_tables.sgml index 3668ce17..13a81a24 100644 --- a/docs/reference/glib/tmpl/hash_tables.sgml +++ b/docs/reference/glib/tmpl/hash_tables.sgml @@ -15,7 +15,7 @@ very quickly. Note that neither keys nor values are copied when inserted into the #GHashTable, so they must exist for the lifetime of the #GHashTable. This means that the use of static strings is OK, but temporary -strings (i.e. those created in buffers and those returned by GTK widgets) +strings (i.e. those created in buffers and those returned by GTK+ widgets) should be copied with g_strdup() before being inserted. diff --git a/docs/reference/glib/tmpl/linked_lists_single.sgml b/docs/reference/glib/tmpl/linked_lists_single.sgml index cd7c3654..a51ca847 100644 --- a/docs/reference/glib/tmpl/linked_lists_single.sgml +++ b/docs/reference/glib/tmpl/linked_lists_single.sgml @@ -34,8 +34,8 @@ the first element in the list. The functions which insert elements return the new start of the list, which may have changed. -There is no function to create a #GSList. NULL is considered to be the empty -list so you simply set a #GSList* to NULL. +There is no function to create a #GSList. %NULL is considered to be the empty +list so you simply set a #GSList* to %NULL. To add elements, use g_slist_append(), g_slist_prepend(), g_slist_insert() @@ -155,10 +155,10 @@ to the end of the list. Inserts a node before @sibling containing @data. Returns the new head of the list. -@slist: a #GSList -@sibling: node to insert @data before -@data: data to put in the newly-inserted node -@Returns: new head of the list +@slist: a #GSList. +@sibling: node to insert @data before. +@data: data to put in the newly-inserted node. +@Returns: new head of the list. @@ -190,7 +190,7 @@ If none of the elements contain the data, the #GSList is unchanged. Removes an element from a #GSList, without freeing the element. -The removed element's next link is set to NULL, so that it becomes a +The removed element's next link is set to %NULL, so that it becomes a self-contained list with one element. @@ -204,9 +204,9 @@ self-contained list with one element. Deletes a node of @list. Returns the new list head. -@list: a #GSList -@link: node to delete -@Returns: new head of @list +@list: a #GSList. +@link: node to delete. +@Returns: new head of @list. @@ -216,9 +216,9 @@ head of the list. Contrast with g_slist_remove() which removes only the first node matching the given data. -@list: a #GSList -@data: data to remove -@Returns: new head of @list +@list: a #GSList. +@data: data to remove. +@Returns: new head of @list. @@ -276,10 +276,7 @@ Sorts a #GSList using the given comparison function. @list: a #GSList. -@compare_func: the comparison function used to sort the #GSList. This function -is passed 2 elements of the #GSList and should return 0 if they are equal, -a negative value if the first element comes before the second, or a positive -value if the first element comes after the second. +@compare_func: qsort()-style comparison function. @Returns: the start of the sorted #GList. @@ -289,9 +286,9 @@ Like g_slist_sort(), but the sort function accepts a user data argument. @list: a #GSList -@compare_func: qsort()-style comparison function -@user_data: data to pass to comparison function -@Returns: new head of the list +@compare_func: comparison function. +@user_data: data to pass to comparison function. +@Returns: new head of the list. @@ -322,7 +319,7 @@ Gets the last element in a #GSList. @list: a #GSList. -@Returns: the last element in the #GSList, or NULL if the #GSList has no +@Returns: the last element in the #GSList, or %NULL if the #GSList has no elements. @@ -332,7 +329,7 @@ A convenience macro to gets the next element in a #GSList. @slist: an element in a #GSList. -@Returns: the next element, or NULL if there are no more elements. +@Returns: the next element, or %NULL if there are no more elements. @@ -342,7 +339,7 @@ Gets the element at the given position in a #GSList. @list: a #GSList. @n: the position of the element, counting from 0. -@Returns: the element, or NULL if the position is off the end of the #GSList. +@Returns: the element, or %NULL if the position is off the end of the #GSList. @@ -352,7 +349,7 @@ Gets the data of the element at the given position. @list: a #GSList. @n: the position of the element. -@Returns: the element's data, or NULL if the position is off the end of the +@Returns: the element's data, or %NULL if the position is off the end of the #GSList. @@ -363,7 +360,7 @@ Finds the element in a #GSList which contains the given data. @list: a #GSList. @data: the element data to find. -@Returns: the found #GSList element, or NULL if it is not found. +@Returns: the found #GSList element, or %NULL if it is not found. @@ -380,7 +377,7 @@ and the given user data. @data: user data passed to the function. @func: the function to call for each element. It should return 0 when the desired element is found. -@Returns: the found #GSList element, or NULL if it is not found. +@Returns: the found #GSList element, or %NULL if it is not found. diff --git a/docs/reference/glib/tmpl/messages.sgml b/docs/reference/glib/tmpl/messages.sgml index 8ebe23e1..8487aa74 100644 --- a/docs/reference/glib/tmpl/messages.sgml +++ b/docs/reference/glib/tmpl/messages.sgml @@ -29,7 +29,7 @@ be differentiated from messages from other libraries and application code. But be careful not to define it in any public header files. -For example, GTK uses this in its Makefile.am: +For example, GTK+ uses this in its Makefile.am: INCLUDES = \ diff --git a/docs/reference/glib/tmpl/misc_utils.sgml b/docs/reference/glib/tmpl/misc_utils.sgml index f1f0b7a8..08d42d5b 100644 --- a/docs/reference/glib/tmpl/misc_utils.sgml +++ b/docs/reference/glib/tmpl/misc_utils.sgml @@ -17,9 +17,9 @@ These are portable utility functions. Gets the name of the program. -(If you are using GDK or GTK the program name is set in gdk_init(), which +(If you are using GDK or GTK+ the program name is set in gdk_init(), which is called by gtk_init(). The program name is found by taking the last -component of argv[0].) +component of argv[0].) @Returns: the name of the program. @@ -39,7 +39,7 @@ Returns an environment variable. @variable: the environment variable to get. -@Returns: the value of the environment variable, or NULL if the environment +@Returns: the value of the environment variable, or %NULL if the environment variable is not found. @@ -54,7 +54,7 @@ Gets the user name of the current user. Gets the real name of the user. This comes from the user's entry in the -passwd file. +passwd file. @Returns: the user's real name. @@ -71,7 +71,8 @@ Gets the current user's home directory. Gets the directory to use for temporary files. -This is found from inspecting the environment variables TMPDIR, TMP, and TEMP +This is found from inspecting the environment variables TMPDIR, +TMP, and TEMP in that order. If none of those are defined "/tmp" is returned. @@ -120,7 +121,7 @@ The returned string should be freed when no longer needed. -Returns TRUE if the given @file_name is an absolute file name, +Returns %TRUE if the given @file_name is an absolute file name, i.e. it contains a full path from the root directory such as '/usr/local' or 'C:/windows' on windows systems. @@ -133,7 +134,7 @@ or 'C:/windows' on windows systems. Returns a pointer into @file_name after the root component, i.e. after the '/' in Unix or 'C:/' under Windows. If @file_name is not an absolute -path it returns NULL. +path it returns %NULL. @file_name: a file name. @@ -261,7 +262,7 @@ Specifies a function to be called at normal program termination. Parses a string containing debugging options separated by ':' into a guint containing bit flags. -This is used within GDK and GTK to parse the debug options passed on the +This is used within GDK and GTK+ to parse the debug options passed on the command line or through environment variables. @@ -295,7 +296,7 @@ Declares a type of function which takes an arbitrary data pointer argument and has no return value. It is not currently used in GLib or GTK+. -@data: +@data: a data pointer. diff --git a/docs/reference/glib/tmpl/modules.sgml b/docs/reference/glib/tmpl/modules.sgml index 0719be68..028a694f 100644 --- a/docs/reference/glib/tmpl/modules.sgml +++ b/docs/reference/glib/tmpl/modules.sgml @@ -9,13 +9,13 @@ portable method for dynamically loading 'plug-ins'. These functions provide a portable way to dynamically load object files (commonly known as 'plug-ins'). The current implementation supports all systems that provide -an implementation of dlopen() (e.g. Linux/Sun), as well as HP-UX via its -shl_load() mechanism, and Windows platforms via DLLs. +an implementation of dlopen() (e.g. Linux/Sun), as well as HP-UX via its +shl_load() mechanism, and Windows platforms via DLLs. A program, which wants to use these functions must be linked to the -libraries output by the command "glib-config --libs gmodule". +libraries output by the command glib-config --libs gmodule. @@ -37,7 +37,7 @@ module is loaded and unloaded (see #GModuleCheckInit and #GModuleUnload). If your module introduces static data to common subsystems in the running -program, e.g. through calling g_quark_from_static_string ("my-module-stuff"), +program, e.g. through calling g_quark_from_static_string ("my-module-stuff"), it must ensure that it is never unloaded, by calling g_module_make_resident(). @@ -59,7 +59,7 @@ It should only be accessed via the following functions. Checks if modules are supported on the current platform. -@Returns: TRUE if modules are supported. +@Returns: %TRUE if modules are supported. @@ -70,18 +70,18 @@ added to the directory, using the correct separator character. 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 +It can be %NULL or an empty string to indicate that the module is in a standard operating-system specific directory, though this is not recommended since the wrong module may be found. For example, calling g_module_build_path() on a Linux system with a directory -of "/lib" and a module_name of "mylibrary" will return "/lib/libmylibrary.so". -On a Windows system, using "\Windows" as the directory it will return -"\Windows\mylibrary.dll". +of /lib and a module_name of "mylibrary" will return /lib/libmylibrary.so. +On a Windows system, using \Windows as the directory it will return +\Windows\mylibrary.dll. -@directory: the directory where the module is. This can be NULL or the empty +@directory: the directory where the module is. This can be %NULL or the empty string to indicate that the standard operating system-specific directories will be used, though that is not recommended. @module_name: the name of the module. @@ -97,28 +97,27 @@ count is incremented. 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 that plaform -(#G_MODULE_SUFFIX,) this suffix will be appended and the coresponding -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. +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 that 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. @file_name: the name of the file containing the module. @flags: the flags used for opening the module. Currently this can be 0 or -G_MODULE_BIND_LAZY for lazy binding, where symbols are only bound when needed. -@Returns: a #GModule on success, or NULL on failure. +#G_MODULE_BIND_LAZY for lazy binding, where symbols are only bound when needed. +@Returns: a #GModule on success, or %NULL on failure. Flags passed to g_module_open(). -G_MODULE_BIND_LAZY specifies that symbols are only resolved when needed. +#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_LAZY is not supported on all platforms.) +(#G_MODULE_BIND_LAZY is not supported on all platforms.) @G_MODULE_BIND_LAZY: @@ -132,7 +131,7 @@ Gets a symbol pointer from a module. @module: the module. @symbol_name: the name of the symbol to find. @symbol: returns the pointer to the symbol value. -@Returns: TRUE on success. +@Returns: %TRUE on success. @@ -160,7 +159,7 @@ Closes a module. @module: the module to close. -@Returns: TRUE on success. +@Returns: %TRUE on success. @@ -176,12 +175,12 @@ Gets a string describing the last module error. Specifies the type of the module initialization function. 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 +and should return %NULL on success or a string describing the initialization error. @module: the #GModule corresponding to the module which has just been loaded. -@Returns: NULL on success, or a string describing the initialization error. +@Returns: %NULL on success, or a string describing the initialization error. diff --git a/docs/reference/glib/tmpl/timers.sgml b/docs/reference/glib/tmpl/timers.sgml index fed2ad94..2ee0bfdd 100644 --- a/docs/reference/glib/tmpl/timers.sgml +++ b/docs/reference/glib/tmpl/timers.sgml @@ -29,7 +29,7 @@ Creates a new timer, and starts timing (i.e. g_timer_start() is implicitly called for you). -@Returns: a new #GTimer +@Returns: a new #GTimer. @@ -40,7 +40,7 @@ start time, so no need to call g_timer_start() immediately after creating the timer. -@timer: a #GTimer +@timer: a #GTimer. @@ -49,7 +49,7 @@ Marks an end time, so calls to g_timer_elapsed() will return the difference between this end time and the start time. -@timer: a #GTimer +@timer: a #GTimer. @@ -61,9 +61,9 @@ seconds elapsed, and the @microseconds argument allows you to get the number of microseconds. -@timer: a #GTimer -@microseconds: return location for microseconds elapsed, or %NULL -@Returns: seconds elapsed +@timer: a #GTimer. +@microseconds: return location for microseconds elapsed, or %NULL. +@Returns: seconds elapsed. @@ -73,7 +73,7 @@ already-started timer to reset the start time, so g_timer_reset() serves no purpose. -@timer: a #GTimer +@timer: a #GTimer. @@ -81,6 +81,6 @@ purpose. Destroys a timer, freeing associated resources. -@timer: a #GTimer to destroy +@timer: a #GTimer to destroy. diff --git a/docs/reference/glib/tmpl/trees-binary.sgml b/docs/reference/glib/tmpl/trees-binary.sgml index 47d6009c..832aa945 100644 --- a/docs/reference/glib/tmpl/trees-binary.sgml +++ b/docs/reference/glib/tmpl/trees-binary.sgml @@ -174,13 +174,13 @@ It should be accessed only by using the following functions. Specifies the type of function passed to g_tree_traverse(). It is passed the key and value of each node, together with the @user_data parameter passed to g_tree_traverse(). -If the function returns TRUE, the traversal is stopped. +If the function returns %TRUE, the traversal is stopped. @key: a key of a #GTree node. @value: the value corresponding to the key. @data: user data passed to g_tree_traverse(). -@Returns: TRUE to stop the traversal. +@Returns: %TRUE to stop the traversal. diff --git a/docs/reference/glib/tmpl/trees-nary.sgml b/docs/reference/glib/tmpl/trees-nary.sgml index 40d2424d..afa41e8b 100644 --- a/docs/reference/glib/tmpl/trees-nary.sgml +++ b/docs/reference/glib/tmpl/trees-nary.sgml @@ -86,8 +86,8 @@ Recursively copies a #GNode (but does not deep-copy the data inside the nodes, since there's no way for GLib to know how to do that). -@node: a #GNode -@Returns: a new #GNode containing the same data pointers +@node: a #GNode. +@Returns: a new #GNode containing the same data pointers. @@ -108,7 +108,7 @@ Inserts a #GNode beneath the parent before the given sibling. @parent: the #GNode to place @node under. -@sibling: the sibling #GNode to place @node before. If sibling is NULL, +@sibling: the sibling #GNode to place @node before. If sibling is %NULL, the node is inserted as the last child of @parent. @node: the #GNode to insert. @Returns: the inserted #GNode. @@ -120,7 +120,7 @@ Inserts a #GNode beneath the parent after the given sibling. @parent: the #GNode to place @node under. -@sibling: the sibling #GNode to place @node after. If sibling is NULL, +@sibling: the sibling #GNode to place @node after. If sibling is %NULL, the node is inserted as the first child of @parent. @node: the #GNode to insert. @Returns: the inserted #GNode. @@ -202,7 +202,7 @@ Reverses the order of the children of a #GNode. Traverses a tree starting at the given root #GNode. It calls the given function for each node visited. -The traversal can be halted at any point by returning TRUE from @func. +The traversal can be halted at any point by returning %TRUE from @func. @root: the root #GNode of the tree to traverse. @@ -245,12 +245,12 @@ including g_node_traverse() and g_node_find(). Specifies the type of function passed to g_node_traverse(). The function is called with each of the nodes visited, together with the user data passed to g_node_traverse(). -If the function returns TRUE, then the traversal is stopped. +If the function returns %TRUE, then the traversal is stopped. @node: a #GNode. @data: user data passed to g_node_traverse(). -@Returns: TRUE to stop the traversal. +@Returns: %TRUE to stop the traversal. @@ -297,7 +297,7 @@ Finds a #GNode in a tree. @flags: which types of children are to be searched, one of %G_TRAVERSE_ALL, %G_TRAVERSE_LEAFS and %G_TRAVERSE_NON_LEAFS. @data: the data to find. -@Returns: the found #GNode, or NULL if the data is not found. +@Returns: the found #GNode, or %NULL if the data is not found. @@ -309,7 +309,7 @@ Finds the first child of a #GNode with the given data. @flags: which types of children are to be searched, one of %G_TRAVERSE_ALL, %G_TRAVERSE_LEAFS and %G_TRAVERSE_NON_LEAFS. @data: the data to find. -@Returns: the found child #GNode, or NULL if the data is not found. +@Returns: the found child #GNode, or %NULL if the data is not found. @@ -341,7 +341,7 @@ Gets the first child of a #GNode. @node: a #GNode. -@Returns: the last child of @node, or NULL if @node is NULL or has no children. +@Returns: the last child of @node, or %NULL if @node is %NULL or has no children. @@ -349,14 +349,14 @@ Gets the first child of a #GNode. Gets the last child of a #GNode. -@node: a #GNode (must not be NULL). -@Returns: the last child of @node, or NULL if @node has no children. +@node: a #GNode (must not be %NULL). +@Returns: the last child of @node, or %NULL if @node has no children. Gets a child of a #GNode, using the given index. -The first child is at index 0. If the index is too big, NULL is returned. +The first child is at index 0. If the index is too big, %NULL is returned. @node: a #GNode. @@ -380,7 +380,7 @@ Gets the next sibling of a #GNode. @node: a #GNode. -@Returns: the next sibling of @node, or NULL if @node is NULL. +@Returns: the next sibling of @node, or %NULL if @node is %NULL. @@ -389,7 +389,7 @@ Gets the previous sibling of a #GNode. @node: a #GNode. -@Returns: the previous sibling of @node, or NULL if @node is NULL. +@Returns: the previous sibling of @node, or %NULL if @node is %NULL. @@ -404,20 +404,20 @@ This could possibly be the node itself. -Returns TRUE if a #GNode is a leaf node. +Returns %TRUE if a #GNode is a leaf node. @node: a #GNode. -@Returns: TRUE if the #GNode is a leaf node (i.e. it has no children). +@Returns: %TRUE if the #GNode is a leaf node (i.e. it has no children). -Returns TRUE if a #GNode is the root of a tree. +Returns %TRUE if a #GNode is the root of a tree. @node: a #GNode. -@Returns: TRUE if the #GNode is the root of a tree (i.e. it has no parent +@Returns: %TRUE if the #GNode is the root of a tree (i.e. it has no parent or siblings). @@ -426,7 +426,7 @@ or siblings). Gets the depth of a #GNode. -If @node is NULL the depth is 0. +If @node is %NULL the depth is 0. The root node has a depth of 1. For the children of the root node the depth is 2. And so on. @@ -457,14 +457,14 @@ Gets the number of children of a #GNode. -Returns TRUE if @node is an ancestor of @descendant. -This is true if node is the parent of descendant, or if node is the -grandparent of descendant etc. +Returns %TRUE if @node is an ancestor of @descendant. +This is true if node is the parent of @descendant, or if node is the +grandparent of @descendant etc. @node: a #GNode. @descendant: a #GNode. -@Returns: TRUE if @node is an ancestor of @descendant. +@Returns: %TRUE if @node is an ancestor of @descendant. @@ -473,7 +473,7 @@ Gets the maximum height of all branches beneath a #GNode. This is the maximum distance from the #GNode to all leaf nodes. -If @root is NULL, 0 is returned. If @root has no children, 1 is returned. +If @root is %NULL, 0 is returned. If @root has no children, 1 is returned. If @root has children, 2 is returned. And so on. diff --git a/docs/reference/glib/tmpl/windows.sgml b/docs/reference/glib/tmpl/windows.sgml index 04100c16..6103df86 100644 --- a/docs/reference/glib/tmpl/windows.sgml +++ b/docs/reference/glib/tmpl/windows.sgml @@ -1,5 +1,5 @@ -Windows Compatability Functions +Windows Compatibility Functions @@ -17,7 +17,7 @@ Windows Compatability Functions Provided for UNIX emulation on Windows; equivalent to UNIX -macro MAXPATHLEN, which is the maximum length of a filename +macro %MAXPATHLEN, which is the maximum length of a filename (including full path). @@ -26,8 +26,8 @@ macro MAXPATHLEN, which is the maximum length of a filename Provided for UNIX emulation on Windows; equivalent to UNIX macro -NAME_MAX, which is the maximum length of a single path component. -i.e. just the "foo" in "/usr/bin/foo". +%NAME_MAX, which is the maximum length of a single path component. +i.e. just the foo in /usr/bin/foo. @@ -40,7 +40,7 @@ Provided for UNIX emulation on Windows; process ID type. -Provided for UNIX emulation on Windows; see documentation for pipe() +Provided for UNIX emulation on Windows; see documentation for pipe() in any UNIX manual. @@ -49,7 +49,7 @@ in any UNIX manual. -Provided for UNIX emulation on Windows; see documentation for ftruncate() +Provided for UNIX emulation on Windows; see documentation for ftruncate() in any UNIX manual. @@ -59,7 +59,7 @@ in any UNIX manual. -Provided for UNIX emulation on Windows; see documentation for opendir() +Provided for UNIX emulation on Windows; see documentation for opendir() in any UNIX manual. @@ -67,7 +67,7 @@ in any UNIX manual. -Provided for UNIX emulation on Windows; see documentation for readdir() +Provided for UNIX emulation on Windows; see documentation for readdir() in any UNIX manual. @@ -75,7 +75,7 @@ in any UNIX manual. -Provided for UNIX emulation on Windows; see documentation for rewinddir() +Provided for UNIX emulation on Windows; see documentation for rewinddir() in any UNIX manual. @@ -83,7 +83,7 @@ in any UNIX manual. -Provided for UNIX emulation on Windows; see documentation for closedir() +Provided for UNIX emulation on Windows; see documentation for closedir() in any UNIX manual.