mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-11-02 15:46:17 +01:00
Require gtk-doc 1.8.
2007-11-25 Matthias Clasen <mclasen@redhat.com>
* configure.in: Require gtk-doc 1.8.
* glib/gasyncqueue.c:
* glib/gdate.c:
* glib/gfileutils.c:
* glib/gmain.c:
* glib/gmarkup.c:
* glib/gregex.c:
* glib/gtestutils.c:
* glib/gutils.c: Use gtk-doc abbreviations for
examples in doc comments.
svn path=/trunk/; revision=5933
This commit is contained in:
Matthias Clasen
Matthias Clasen
parent
0c01c6f1ad
commit
d2f111fca7
14
ChangeLog
14
ChangeLog
@ -1,3 +1,17 @@
|
||||
2007-11-25 Matthias Clasen <mclasen@redhat.com>
|
||||
|
||||
* configure.in: Require gtk-doc 1.8.
|
||||
|
||||
* glib/gasyncqueue.c:
|
||||
* glib/gdate.c:
|
||||
* glib/gfileutils.c:
|
||||
* glib/gmain.c:
|
||||
* glib/gmarkup.c:
|
||||
* glib/gregex.c:
|
||||
* glib/gtestutils.c:
|
||||
* glib/gutils.c: Use gtk-doc abbreviations for
|
||||
examples in doc comments.
|
||||
|
||||
2007-11-24 Matthias Clasen <mclasen@redhat.com>
|
||||
|
||||
* */Makefile.am: Replace INCLUDES by AM_CPPFLAGS, other
|
||||
|
||||
@ -2299,7 +2299,7 @@ dnl **************************
|
||||
dnl *** Checks for gtk-doc ***
|
||||
dnl **************************
|
||||
|
||||
GTK_DOC_CHECK([1.4])
|
||||
GTK_DOC_CHECK([1.8])
|
||||
|
||||
AC_ARG_ENABLE(man,
|
||||
[AC_HELP_STRING([--enable-man],
|
||||
|
||||
@ -565,7 +565,7 @@ g_async_queue_length_unlocked (GAsyncQueue* queue)
|
||||
*
|
||||
* If you were sorting a list of priority numbers to make sure the
|
||||
* lowest priority would be at the top of the queue, you could use:
|
||||
* <informalexample><programlisting>
|
||||
* |[
|
||||
* gint32 id1;
|
||||
* gint32 id2;
|
||||
*
|
||||
@ -573,7 +573,7 @@ g_async_queue_length_unlocked (GAsyncQueue* queue)
|
||||
* id2 = GPOINTER_TO_INT (element2);
|
||||
*
|
||||
* return (id1 > id2 ? +1 : id1 == id2 ? 0 : -1);
|
||||
* </programlisting></informalexample>
|
||||
* ]|
|
||||
*
|
||||
* Since: 2.10
|
||||
**/
|
||||
|
||||
@ -864,9 +864,9 @@ g_date_set_parse (GDate *d,
|
||||
* Sets the value of a date from a <type>time_t</type> value.
|
||||
*
|
||||
* To set the value of a date to the current day, you could write:
|
||||
* <informalexample><programlisting>
|
||||
* |[
|
||||
* g_date_set_time_t (date, time (NULL));
|
||||
* </programlisting></informalexample>
|
||||
* ]|
|
||||
*
|
||||
* Since: 2.10
|
||||
*/
|
||||
|
||||
@ -154,14 +154,14 @@ g_mkdir_with_parents (const gchar *pathname,
|
||||
* For example, you might think you could use %G_FILE_TEST_IS_SYMLINK
|
||||
* to know whether it is is safe to write to a file without being
|
||||
* tricked into writing into a different location. It doesn't work!
|
||||
*
|
||||
* <informalexample><programlisting>
|
||||
* |[
|
||||
* /* DON'T DO THIS */
|
||||
* if (!g_file_test (filename, G_FILE_TEST_IS_SYMLINK)) {
|
||||
* if (!g_file_test (filename, G_FILE_TEST_IS_SYMLINK))
|
||||
* {
|
||||
* fd = g_open (filename, O_WRONLY);
|
||||
* /* write to fd */
|
||||
* }
|
||||
* </programlisting></informalexample>
|
||||
* ]|
|
||||
*
|
||||
* Another thing to note is that %G_FILE_TEST_EXISTS and
|
||||
* %G_FILE_TEST_IS_EXECUTABLE are implemented using the access()
|
||||
|
||||
@ -1897,7 +1897,7 @@ g_main_current_source (void)
|
||||
* from within idle handlers, but may have freed the object
|
||||
* before the dispatch of your idle handler.
|
||||
*
|
||||
* <informalexample><programlisting>
|
||||
* |[
|
||||
* static gboolean
|
||||
* idle_callback (gpointer data)
|
||||
* {
|
||||
@ -1927,7 +1927,7 @@ g_main_current_source (void)
|
||||
*
|
||||
* G_OBJECT_CLASS (parent_class)->finalize (object);
|
||||
* }
|
||||
* </programlisting></informalexample>
|
||||
* ]|
|
||||
*
|
||||
* This will fail in a multi-threaded application if the
|
||||
* widget is destroyed before the idle handler fires due
|
||||
@ -1935,7 +1935,7 @@ g_main_current_source (void)
|
||||
* this particular problem, is to check to if the source
|
||||
* has already been destroy within the callback.
|
||||
*
|
||||
* <informalexample><programlisting>
|
||||
* |[
|
||||
* static gboolean
|
||||
* idle_callback (gpointer data)
|
||||
* {
|
||||
@ -1950,7 +1950,7 @@ g_main_current_source (void)
|
||||
*
|
||||
* return FALSE;
|
||||
* }
|
||||
* </programlisting></informalexample>
|
||||
* ]|
|
||||
*
|
||||
* Return value: %TRUE if the source has been destroyed
|
||||
*
|
||||
|
||||
@ -2296,7 +2296,7 @@ g_markup_vprintf_escaped (const char *format,
|
||||
* output, without having to worry that the strings
|
||||
* might themselves contain markup.
|
||||
*
|
||||
* <informalexample><programlisting>
|
||||
* |[
|
||||
* const char *store = "Fortnum & Mason";
|
||||
* const char *item = "Tea";
|
||||
* char *output;
|
||||
@ -2306,7 +2306,7 @@ g_markup_vprintf_escaped (const char *format,
|
||||
* "<item>%s</item>"
|
||||
* "</purchase>",
|
||||
* store, item);
|
||||
* </programlisting></informalexample>
|
||||
* ]|
|
||||
*
|
||||
* Return value: newly allocated result from formatting
|
||||
* operation. Free with g_free().
|
||||
|
||||
@ -1103,7 +1103,7 @@ g_regex_match_simple (const gchar *pattern,
|
||||
* To retrieve all the non-overlapping matches of the pattern in
|
||||
* string you can use g_match_info_next().
|
||||
*
|
||||
* <informalexample><programlisting>
|
||||
* |[
|
||||
* static void
|
||||
* print_uppercase_words (const gchar *string)
|
||||
* {
|
||||
@ -1123,7 +1123,7 @@ g_regex_match_simple (const gchar *pattern,
|
||||
* g_match_info_free (match_info);
|
||||
* g_regex_unref (regex);
|
||||
* }
|
||||
* </programlisting></informalexample>
|
||||
* ]|
|
||||
*
|
||||
* Returns: %TRUE is the string matched, %FALSE otherwise
|
||||
*
|
||||
@ -1172,7 +1172,7 @@ g_regex_match (const GRegex *regex,
|
||||
* To retrieve all the non-overlapping matches of the pattern in
|
||||
* string you can use g_match_info_next().
|
||||
*
|
||||
* <informalexample><programlisting>
|
||||
* |[
|
||||
* static void
|
||||
* print_uppercase_words (const gchar *string)
|
||||
* {
|
||||
@ -1198,7 +1198,7 @@ g_regex_match (const GRegex *regex,
|
||||
* g_error_free (error);
|
||||
* }
|
||||
* }
|
||||
* </programlisting></informalexample>
|
||||
* ]|
|
||||
*
|
||||
* Returns: %TRUE is the string matched, %FALSE otherwise
|
||||
*
|
||||
|
||||
@ -1275,7 +1275,7 @@ test_time_stamp (void)
|
||||
* The forking parent process then asserts successfull child program
|
||||
* termination and validates cihld program outputs.
|
||||
*
|
||||
* <informalexample><programlisting>
|
||||
* |[
|
||||
* static void
|
||||
* test_fork_patterns (void)
|
||||
* {
|
||||
@ -1289,7 +1289,7 @@ test_time_stamp (void)
|
||||
* g_test_trap_assert_stdout ("*somagic17*");
|
||||
* g_test_trap_assert_stderr ("*semagic43*");
|
||||
* }
|
||||
* </programlisting></informalexample>
|
||||
* ]|
|
||||
*
|
||||
* Returns: %TRUE for the forked child and %FALSE for the executing parent process.
|
||||
*/
|
||||
|
||||
@ -36,6 +36,7 @@
|
||||
#include <stdarg.h>
|
||||
#include <stdlib.h>
|
||||
#include <stdio.h>
|
||||
#include <libintl.h>
|
||||
#include <locale.h>
|
||||
#include <string.h>
|
||||
#include <ctype.h> /* For tolower() */
|
||||
@ -1781,11 +1782,11 @@ g_get_real_name (void)
|
||||
* g_get_homedir() not pay attention to <envar>HOME</envar> and to
|
||||
* return the real home directory for the user. If applications
|
||||
* want to pay attention to <envar>HOME</envar>, they can do:
|
||||
* <informalexample><programlisting>
|
||||
* |[
|
||||
* const char *homedir = g_getenv ("HOME");
|
||||
* if (!homedir)
|
||||
* homedir = g_get_homedir (<!-- -->);
|
||||
* </programlisting></informalexample>
|
||||
* ]|
|
||||
*
|
||||
* Returns: the current user's home directory
|
||||
*/
|
||||
@ -3130,10 +3131,6 @@ _g_utils_thread_init (void)
|
||||
g_get_language_names ();
|
||||
}
|
||||
|
||||
#ifdef ENABLE_NLS
|
||||
|
||||
#include <libintl.h>
|
||||
|
||||
#ifdef G_OS_WIN32
|
||||
|
||||
/**
|
||||
@ -3197,8 +3194,6 @@ _glib_gettext (const gchar *str)
|
||||
return dgettext (GETTEXT_PACKAGE, str);
|
||||
}
|
||||
|
||||
#endif /* ENABLE_NLS */
|
||||
|
||||
#ifdef G_OS_WIN32
|
||||
|
||||
/* Binary compatibility versions. Not for newly compiled code. */
|
||||
|
||||
Loading…
Reference in New Issue
Block a user