since gtk-doc does the right thing.
2003-07-25 Matthias Clasen <maclas@gmx.de>
+ * glib/gwin32.c:
+ * glib/gutf8.c:
+ * glib/gunicollate.c:
+ * glib/gtree.c:
+ * glib/gspawn.c:
+ * glib/gmain.c:
+ * glib/giochannel.c:
+ * glib/gfileutils.c:
+ * glib/gerror.c:
+ * glib/gconvert.c:
+ * glib/gasyncqueue.c:
+ * glib/gmem.c: Remove some explicit Docbook markup which is no longer necessary
+ since gtk-doc does the right thing.
+
* glib/gutf8.c (g_utf8_get_char_validated): Work around gtk-doc stupidity.
2003-07-20 Hans Breuer <hans@breuer.org>
2003-07-25 Matthias Clasen <maclas@gmx.de>
+ * glib/gwin32.c:
+ * glib/gutf8.c:
+ * glib/gunicollate.c:
+ * glib/gtree.c:
+ * glib/gspawn.c:
+ * glib/gmain.c:
+ * glib/giochannel.c:
+ * glib/gfileutils.c:
+ * glib/gerror.c:
+ * glib/gconvert.c:
+ * glib/gasyncqueue.c:
+ * glib/gmem.c: Remove some explicit Docbook markup which is no longer necessary
+ since gtk-doc does the right thing.
+
* glib/gutf8.c (g_utf8_get_char_validated): Work around gtk-doc stupidity.
2003-07-20 Hans Breuer <hans@breuer.org>
2003-07-25 Matthias Clasen <maclas@gmx.de>
+ * glib/gwin32.c:
+ * glib/gutf8.c:
+ * glib/gunicollate.c:
+ * glib/gtree.c:
+ * glib/gspawn.c:
+ * glib/gmain.c:
+ * glib/giochannel.c:
+ * glib/gfileutils.c:
+ * glib/gerror.c:
+ * glib/gconvert.c:
+ * glib/gasyncqueue.c:
+ * glib/gmem.c: Remove some explicit Docbook markup which is no longer necessary
+ since gtk-doc does the right thing.
+
* glib/gutf8.c (g_utf8_get_char_validated): Work around gtk-doc stupidity.
2003-07-20 Hans Breuer <hans@breuer.org>
2003-07-25 Matthias Clasen <maclas@gmx.de>
+ * glib/gwin32.c:
+ * glib/gutf8.c:
+ * glib/gunicollate.c:
+ * glib/gtree.c:
+ * glib/gspawn.c:
+ * glib/gmain.c:
+ * glib/giochannel.c:
+ * glib/gfileutils.c:
+ * glib/gerror.c:
+ * glib/gconvert.c:
+ * glib/gasyncqueue.c:
+ * glib/gmem.c: Remove some explicit Docbook markup which is no longer necessary
+ since gtk-doc does the right thing.
+
* glib/gutf8.c (g_utf8_get_char_validated): Work around gtk-doc stupidity.
2003-07-20 Hans Breuer <hans@breuer.org>
2003-07-25 Matthias Clasen <maclas@gmx.de>
+ * glib/gwin32.c:
+ * glib/gutf8.c:
+ * glib/gunicollate.c:
+ * glib/gtree.c:
+ * glib/gspawn.c:
+ * glib/gmain.c:
+ * glib/giochannel.c:
+ * glib/gfileutils.c:
+ * glib/gerror.c:
+ * glib/gconvert.c:
+ * glib/gasyncqueue.c:
+ * glib/gmem.c: Remove some explicit Docbook markup which is no longer necessary
+ since gtk-doc does the right thing.
+
* glib/gutf8.c (g_utf8_get_char_validated): Work around gtk-doc stupidity.
2003-07-20 Hans Breuer <hans@breuer.org>
2003-07-25 Matthias Clasen <maclas@gmx.de>
+ * glib/gwin32.c:
+ * glib/gutf8.c:
+ * glib/gunicollate.c:
+ * glib/gtree.c:
+ * glib/gspawn.c:
+ * glib/gmain.c:
+ * glib/giochannel.c:
+ * glib/gfileutils.c:
+ * glib/gerror.c:
+ * glib/gconvert.c:
+ * glib/gasyncqueue.c:
+ * glib/gmem.c: Remove some explicit Docbook markup which is no longer necessary
+ since gtk-doc does the right thing.
+
* glib/gutf8.c (g_utf8_get_char_validated): Work around gtk-doc stupidity.
2003-07-20 Hans Breuer <hans@breuer.org>
* @queue: a #GAsyncQueue.
*
* Acquires the @queue's lock. After that you can only call the
- * <function>g_async_queue_*_unlocked(<!-- -->)</function> function variants on that
+ * <function>g_async_queue_*_unlocked()</function> function variants on that
* @queue. Otherwise it will deadlock.
**/
void
* @to_codeset: destination codeset
* @from_codeset: source codeset
*
- * Same as the standard UNIX routine <function>iconv_open()</function>, but
+ * Same as the standard UNIX routine iconv_open(), but
* may be implemented via libiconv on UNIX flavors that lack
* a native implementation.
*
* @outbuf: converted output bytes
* @outbytes_left: inout parameter, bytes available to fill in @outbuf
*
- * Same as the standard UNIX routine <function>iconv()</function>, but
+ * Same as the standard UNIX routine iconv(), but
* may be implemented via libiconv on UNIX flavors that lack
* a native implementation.
*
* g_iconv_close:
* @converter: a conversion descriptor from g_iconv_open()
*
- * Same as the standard UNIX routine <function>iconv_close()</function>, but
+ * Same as the standard UNIX routine iconv_close(), but
* may be implemented via libiconv on UNIX flavors that lack
* a native implementation. Should be called to clean up
* the conversion descriptor from g_iconv_open() when
* in the output. Note that it is not guaranteed that the specification
* for the fallback sequences in @fallback will be honored. Some
* systems may do a approximate conversion from @from_codeset
- * to @to_codeset in their <function>iconv()</function> functions,
+ * to @to_codeset in their iconv() functions,
* in which case GLib will simply return that approximate conversion.
*
* Return value: If the conversion was successful, a newly allocated
* g_error_new:
* @domain: error domain
* @code: error code
- * @format: <function>printf()</function>-style format for error message
+ * @format: printf()-style format for error message
* @Varargs: parameters for message format
*
* Creates a new #GError with the given @domain and @code,
* @message: error message
*
* Creates a new #GError; unlike g_error_new(), @message is not
- * a <function>printf()</function>-style format string. Use this
+ * a printf()-style format string. Use this
* function if @message contains text you don't have control over,
- * that could include <function>printf()</function> escape sequences.
+ * that could include printf() escape sequences.
*
* Return value: a new #GError
**/
* @err: a return location for a #GError, or %NULL
* @domain: error domain
* @code: error code
- * @format: <function>printf()</function>-style format
+ * @format: printf()-style format
* @Varargs: args for @format
*
* Does nothing if @err is %NULL; if @err is non-%NULL, then *@err must
* g_mkstemp:
* @tmpl: template filename
*
- * Opens a temporary file. See the <function>mkstemp()</function> documentation
+ * Opens a temporary file. See the mkstemp() documentation
* on most UNIX-like systems. This is a portability wrapper, which simply calls
- * <function>mkstemp()</function> on systems that have it, and implements
+ * mkstemp() on systems that have it, and implements
* it in GLib otherwise.
*
* The parameter is a string that should match the rules for
- * <function>mkstemp()</function>, i.e. end in "XXXXXX". The X string will
+ * mkstemp(), i.e. end in "XXXXXX". The X string will
* be modified to form the name of a file that didn't exist.
*
- * Return value: A file handle (as from <function>open()</function>) to the file
+ * Return value: A file handle (as from open()) to the file
* opened for reading and writing. The file is opened in binary mode
* on platforms where there is a difference. The file handle should be
- * closed with <function>close()</function>. In case of errors, -1 is returned.
+ * closed with close(). In case of errors, -1 is returned.
*/
int
g_mkstemp (char *tmpl)
* files (as returned by g_get_tmp_dir()).
*
* @tmpl should be a string ending with six 'X' characters, as the
- * parameter to g_mkstemp() (or <function>mkstemp()</function>).
+ * parameter to g_mkstemp() (or mkstemp()).
* However, unlike these functions, the template should only be a
* basename, no directory components are allowed. If template is %NULL,
* a default template is used.
*
- * Note that in contrast to g_mkstemp() (and <function>mkstemp()</function>)
+ * Note that in contrast to g_mkstemp() (and mkstemp())
* @tmpl is not modified, and might thus be a read-only literal string.
*
* The actual name used is returned in @name_used if non-%NULL. This
* string should be freed with g_free() when not needed any longer.
*
- * Return value: A file handle (as from <function>open()</function>) to
+ * Return value: A file handle (as from open()) to
* the file opened for reading and writing. The file is opened in binary
* mode on platforms where there is a difference. The file handle should be
- * closed with <function>close()</function>. In case of errors, -1 is returned
+ * closed with close(). In case of errors, -1 is returned
* and @error will be set.
**/
int
* file).
*
* Sets the current position in the #GIOChannel, similar to the standard library
- * function <function>fseek()</function>.
+ * function fseek().
*
* Return value: %G_IO_ERROR_NONE if the operation was successful.
*
* g_io_channel_new_file:
* @filename: A string containing the name of a file.
* @mode: One of "r", "w", "a", "r+", "w+", "a+". These have
- * the same meaning as in <function>fopen()</function>.
+ * the same meaning as in fopen().
* @error: A location to return an error of type %G_FILE_ERROR.
*
* Open a file @filename as a #GIOChannel using mode @mode. This
* The values of the flags %G_IO_FLAG_IS_READABLE and %G_IO_FLAG_IS_WRITEABLE
* are cached for internal use by the channel when it is created.
* If they should change at some later point (e.g. partial shutdown
- * of a socket with the UNIX <function>shutdown()</function> function), the user
+ * of a socket with the UNIX shutdown() function), the user
* should immediately call g_io_channel_get_flags () to update
* the internal values of these flags.
*
* g_get_current_time:
* @result: #GTimeVal structure in which to store current time.
*
- * Equivalent to the UNIX <function>gettimeofday()</function> function, but portable.
+ * Equivalent to the UNIX gettimeofday() function, but portable.
**/
void
g_get_current_time (GTimeVal *result)
* @func: the function to call to poll all file descriptors
*
* Sets the function to use to handle polling of file descriptors. It
- * will be used instead of the <function>poll()</function> system call
+ * will be used instead of the poll() system call
* (or GLib's replacement function, which is used where
- * <function>poll()</function> isn't available).
+ * poll() isn't available).
*
* This function could possibly be used to integrate the GLib event
* loop with an external event loop.
* g_main_context_wakeup:
* @context: a #GMainContext
*
- * If @context is currently waiting in a <function>poll()</function>, interrupt
- * the <function>poll()</function>, and continue the iteration process.
+ * If @context is currently waiting in a poll(), interrupt
+ * the poll(), and continue the iteration process.
**/
void
g_main_context_wakeup (GMainContext *context)
*
* Checks whether the allocator used by g_malloc() is the system's
* malloc implementation. If it returns %TRUE memory allocated with
- * <function>malloc()</function> can be used interchangeable with
- * memory allocated using g_malloc(). This function is useful for
- * avoiding an extra copy of allocated memory returned by a
- * non-GLib-based API.
+ * malloc() can be used interchangeable with memory allocated using g_malloc().
+ * This function is useful for avoiding an extra copy of allocated memory returned
+ * by a non-GLib-based API.
*
* A different allocator can be set using g_mem_set_vtable().
*
- * Return value: if %TRUE, <function>malloc()</function> and g_malloc() can be mixed.
+ * Return value: if %TRUE, malloc() and g_malloc() can be mixed.
**/
gboolean
g_mem_is_system_malloc (void)
* @argv: child's argument vector
* @envp: child's environment, or %NULL to inherit parent's
* @flags: flags from #GSpawnFlags
- * @child_setup: function to run in the child just before <function>exec()</function>
+ * @child_setup: function to run in the child just before exec()
* @user_data: user data for @child_setup
* @child_pid: return location for child process ID, or %NULL
* @error: return location for error
* @argv: child's argument vector
* @envp: child's environment, or %NULL to inherit parent's
* @flags: flags from #GSpawnFlags
- * @child_setup: function to run in the child just before <function>exec()</function>
+ * @child_setup: function to run in the child just before exec()
* @user_data: user data for @child_setup
* @standard_output: return location for child output
* @standard_error: return location for child error messages
- * @exit_status: child exit status, as returned by <function>waitpid()</function>
+ * @exit_status: child exit status, as returned by waitpid()
* @error: return location for error
*
* Executes a child synchronously (waits for the child to exit before returning).
* All output from the child is stored in @standard_output and @standard_error,
* if those parameters are non-%NULL. If @exit_status is non-%NULL, the exit
* status of the child is stored there as it would be returned by
- * <function>waitpid()</function>; standard UNIX macros such as
- * <function>WIFEXITED()</function> and <function>WEXITSTATUS()</function>
+ * waitpid(); standard UNIX macros such as WIFEXITED() and WEXITSTATUS()
* must be used to evaluate the exit status. If an error occurs, no data is
* returned in @standard_output, @standard_error, or @exit_status.
*
* @argv: child's argument vector
* @envp: child's environment, or %NULL to inherit parent's
* @flags: flags from #GSpawnFlags
- * @child_setup: function to run in the child just before <function>exec()</function>
+ * @child_setup: function to run in the child just before exec()
* @user_data: user data for @child_setup
* @child_pid: return location for child process ID, or %NULL
* @standard_input: return location for file descriptor to write to child's stdin, or %NULL
* will only be searched if you pass the %G_SPAWN_SEARCH_PATH flag.
*
* On Windows, the low-level child process creation API
- * (<function>CreateProcess()</function>)doesn't use argument vectors,
+ * (CreateProcess())doesn't use argument vectors,
* but a command line. The C runtime library's
* <function>spawn*()</function> family of functions (which
* g_spawn_async_with_pipes() eventually calls) paste the argument
* vector elements into a command line, and the C runtime startup code
* does a corresponding recostruction of an argument vector from the
- * command line, to be passed to
- * <function>main()</function>. Complications arise when you have
+ * command line, to be passed to main(). Complications arise when you have
* argument vector elements that contain spaces of double quotes. The
- * <function>spawn()</function> functions don't do any quoting or
+ * <function>spawn*()</function> functions don't do any quoting or
* escaping, but on the other hand the startup code does do unquoting
* and unescaping in order to enable receiving arguments with embedded
* spaces or double quotes. To work around this asymmetry,
* g_spawn_async_with_pipes() will do quoting and escaping on argument
* vector elements that need it before calling the C runtime
- * <function>spawn()</function> function.
+ * spawn() function.
*
* @envp is a %NULL-terminated array of strings, where each string
* has the form <literal>KEY=VALUE</literal>. This will become
* @flags should be the bitwise OR of any flags you want to affect the
* function's behavior. On Unix, the %G_SPAWN_DO_NOT_REAP_CHILD means
* that the child will not be automatically reaped; you must call
- * <function>waitpid()</function> or handle %SIGCHLD yourself, or the
+ * waitpid() or handle %SIGCHLD yourself, or the
* child will become a zombie. On Windows, the flag means that a
* handle to the child will be returned @child_pid. You must call
- * <function>CloseHandle()</function> on it eventually (or exit the
+ * CloseHandle() on it eventually (or exit the
* process), or the child processs will continue to take up some table
* space even after its death. Quite similar to zombies on Unix,
* actually.
* %G_SPAWN_LEAVE_DESCRIPTORS_OPEN means that the parent's open file
* descriptors will be inherited by the child; otherwise all
* descriptors except stdin/stdout/stderr will be closed before
- * calling <function>exec()</function> in the child. %G_SPAWN_SEARCH_PATH
+ * calling exec() in the child. %G_SPAWN_SEARCH_PATH
* means that <literal>argv[0]</literal> need not be an absolute path, it
* will be looked for in the user's <envar>PATH</envar>.
* %G_SPAWN_STDOUT_TO_DEV_NULL means that the child's standard output will
* platforms, the function is called in the child after GLib has
* performed all the setup it plans to perform (including creating
* pipes, closing file descriptors, etc.) but before calling
- * <function>exec()</function>. That is, @child_setup is called just
- * before calling <function>exec()</function> in the child. Obviously
+ * exec(). That is, @child_setup is called just
+ * before calling exec() in the child. Obviously
* actions taken in this function will only affect the child, not the
- * parent. On Windows, there is no separate
- * <function>fork()</function> and <function>exec()</function>
+ * parent. On Windows, there is no separate fork() and exec()
* functionality. Child processes are created and run right away with
- * one API call, <function>CreateProcess()</function>. @child_setup is
+ * one API call, CreateProcess(). @child_setup is
* called in the parent process just before creating the child
* process. You should carefully consider what you do in @child_setup
* if you intend your software to be portable to Windows.
*
* If non-%NULL, @child_pid will on Unix be filled with the child's
* process ID. You can use the process ID to send signals to the
- * child, or to <function>waitpid()</function> if you specified the
+ * child, or to waitpid() if you specified the
* %G_SPAWN_DO_NOT_REAP_CHILD flag. On Windows, @child_pid will be
* filled with a handle to the child process only if you specified the
* %G_SPAWN_DO_NOT_REAP_CHILD flag. You can then access the child
* process using the Win32 API, for example wait for its termination
* with the <function>WaitFor*()</function> functions, or examine its
- * exit code with <function>GetExitCodeProcess()</function>. You
- * should close the handle with <function>CloseHandle()</function>
- * when you no longer need it.
+ * exit code with GetExitCodeProcess(). You should close the handle
+ * with CloseHandle() when you no longer need it.
*
* If non-%NULL, the @standard_input, @standard_output, @standard_error
* locations will be filled with file descriptors for writing to the child's
/**
* g_tree_new:
* @key_compare_func: the function used to order the nodes in the #GTree.
- * It should return values similar to the standard
- * <function>strcmp()</function> function -
+ * It should return values similar to the standard strcmp() function -
* 0 if the two arguments are equal, a negative value if the first argument
* comes before the second, or a positive value if the first argument comes
* after the second.
/**
* g_tree_new_with_data:
- * @key_compare_func: <function>qsort()</function>-style comparison function.
+ * @key_compare_func: qsort()-style comparison function.
* @key_compare_data: data to pass to comparison function.
*
* Creates a new #GTree with a comparison function that accepts user data.
/**
* g_tree_new_full:
- * @key_compare_func: <function>qsort()</function>-style comparison function.
+ * @key_compare_func: qsort()-style comparison function.
* @key_compare_data: data to pass to comparison function.
* @key_destroy_func: a function to free the memory allocated for the key
* used when removing the entry from the #GTree or %NULL if you don't
* correct rules for the current locale. When sorting a large
* number of strings, it will be significantly faster to
* obtain collation keys with g_utf8_collate_key() and
- * compare the keys with <function>strcmp()</function> when
+ * compare the keys with strcmp() when
* sorting instead of sorting the original strings.
*
* Return value: -1 if @str1 compares before @str2, 0 if they
* @len: length of @str, in bytes, or -1 if @str is nul-terminated.
*
* Converts a string into a collation key that can be compared
- * with other collation keys using <function>strcmp()</function>.
+ * with other collation keys using strcmp().
* The results of comparing the collation keys of two strings
- * with <function>strcmp()</function> will always be the same as
+ * with strcmp() will always be the same as
* comparing the two original keys with g_utf8_collate().
*
* Return value: a newly allocated string. This string should
* @src: UTF-8 encoded string
* @n: character count
*
- * Like the standard C <function>strncpy()</function> function, but
+ * Like the standard C strncpy() function, but
* copies a given number of characters instead of a given number of
* bytes. The @src string must be valid UTF-8 encoded text.
* (Use g_utf8_validate() on all text before trying to use UTF-8
* Translate a Win32 error code (as returned by GetLastError()) into
* the corresponding message. The message is either language neutral,
* or in the thread's language, or the user's language, the system's
- * language, or US English (see docs for <function>FormatMessage()</function>). *
+ * language, or US English (see docs for FormatMessage()). *
* The returned string should be deallocated with g_free().
*
* Returns: newly-allocated error message