From 0cc20b7e0b8376a1b7c14a1a712d1f22a8c0eac0 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Wed, 5 Feb 2014 20:17:46 -0500 Subject: [PATCH] Don't use in docs Switch to simpler markdown, `foo`. --- gio/gdesktopappinfo.c | 10 +++++----- gio/gfiledescriptorbased.c | 6 +++--- gio/gresource.c | 7 ++++--- gio/gsettings.c | 5 ++--- gio/gsettingsbackend.c | 2 +- gio/gsettingsschema.c | 15 +++++++-------- gio/gtestdbus.c | 8 ++++---- gio/gunixconnection.c | 6 +++--- gio/gunixfdlist.c | 6 +++--- gio/gunixfdmessage.c | 8 ++++---- gio/gunixinputstream.c | 6 +++--- gio/gunixmounts.c | 9 ++++----- gio/gunixoutputstream.c | 6 +++--- gio/gunixsocketaddress.c | 6 +++--- gio/gvolume.c | 9 ++++----- gio/gwin32inputstream.c | 6 +++--- gio/gwin32outputstream.c | 6 +++--- glib/docs.c | 4 ++-- glib/gconvert.c | 3 +-- glib/ggettext.c | 6 +++--- glib/grand.c | 4 ++-- glib/gstrfuncs.c | 8 +++----- glib/gtestutils.c | 16 ++++++++-------- glib/gtimezone.c | 11 +++++------ glib/gunidecomp.c | 12 ++++++------ glib/gutils.c | 26 ++++++++++++-------------- gmodule/gmodule.c | 11 +++++------ 27 files changed, 106 insertions(+), 116 deletions(-) diff --git a/gio/gdesktopappinfo.c b/gio/gdesktopappinfo.c index e0096676e..af14815a1 100644 --- a/gio/gdesktopappinfo.c +++ b/gio/gdesktopappinfo.c @@ -58,9 +58,9 @@ * #GDesktopAppInfo is an implementation of #GAppInfo based on * desktop files. * - * Note that <gio/gdesktopappinfo.h> belongs to - * the UNIX-specific GIO interfaces, thus you have to use the - * gio-unix-2.0.pc pkg-config file when using it. + * Note that `` belongs to the UNIX-specific + * GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config + * file when using it. */ #define DEFAULT_APPLICATIONS_GROUP "Default Applications" @@ -1306,13 +1306,13 @@ g_desktop_app_info_new_from_filename (const char *filename) * * A desktop file id is the basename of the desktop file, including the * .desktop extension. GIO is looking for a desktop file with this name - * in the applications subdirectories of the XDG + * in the `applications` subdirectories of the XDG * data directories (i.e. the directories specified in the `XDG_DATA_HOME` * and `XDG_DATA_DIRS` environment variables). GIO also supports the * prefix-to-subdirectory mapping that is described in the * Menu * Spec (i.e. a desktop id of kde-foo.desktop will match - * /usr/share/applications/kde/foo.desktop). + * `/usr/share/applications/kde/foo.desktop`). * * Returns: a new #GDesktopAppInfo, or %NULL if no desktop file with that id */ diff --git a/gio/gfiledescriptorbased.c b/gio/gfiledescriptorbased.c index a7829cf28..a0ae22241 100644 --- a/gio/gfiledescriptorbased.c +++ b/gio/gfiledescriptorbased.c @@ -32,9 +32,9 @@ * #GFileDescriptorBased is implemented by streams (implementations of * #GInputStream or #GOutputStream) that are based on file descriptors. * - * Note that <gio/gfiledescriptorbased.h> belongs to - * the UNIX-specific GIO interfaces, thus you have to use the - * gio-unix-2.0.pc pkg-config file when using it. + * Note that `` belongs to the UNIX-specific + * GIO interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config + * file when using it. * * Since: 2.24 * diff --git a/gio/gresource.c b/gio/gresource.c index 646708a4d..2aacb013d 100644 --- a/gio/gresource.c +++ b/gio/gresource.c @@ -45,9 +45,10 @@ G_DEFINE_BOXED_TYPE (GResource, g_resource, g_resource_ref, g_resource_unref) * @short_description: Resource framework * @include: gio/gio.h * - * Applications and libraries often contain binary or textual data that is really part of the - * application, rather than user data. For instance #GtkBuilder .ui files, splashscreen images, - * GMenu markup xml, CSS files, icons, etc. These are often shipped as files in $datadir/appname, or + * Applications and libraries often contain binary or textual data that is + * really part of the application, rather than user data. For instance + * #GtkBuilder .ui files, splashscreen images, GMenu markup xml, CSS files, + * icons, etc. These are often shipped as files in `$datadir/appname`, or * manually included as literal strings in the code. * * The #GResource API and the glib-compile-resources program diff --git a/gio/gsettings.c b/gio/gsettings.c index bbc8bddc8..28a9ebb1f 100644 --- a/gio/gsettings.c +++ b/gio/gsettings.c @@ -98,8 +98,7 @@ * A DTD for the gschema XML format can be found here: gschema.dtd * * The glib-compile-schemas - * tool expects schema files to have the extension - * .gschema.xml + * tool expects schema files to have the extension `.gschema.xml`. * * At runtime, schemas are identified by their id (as specified * in the id attribute of the @@ -205,7 +204,7 @@ * ]| * * glib-compile-schemas expects schema files to have the extension - * .gschema.override + * `.gschema.override`. * * ## Binding * diff --git a/gio/gsettingsbackend.c b/gio/gsettingsbackend.c index 0643da5da..c0bcaeb08 100644 --- a/gio/gsettingsbackend.c +++ b/gio/gsettingsbackend.c @@ -79,7 +79,7 @@ static gboolean g_settings_has_backend; * implementations, but does not carry the same stability guarantees * as the public GIO API. For this reason, you have to define the * C preprocessor symbol %G_SETTINGS_ENABLE_BACKEND before including - * gio/gsettingsbackend.h + * `gio/gsettingsbackend.h`. **/ static gboolean diff --git a/gio/gsettingsschema.c b/gio/gsettingsschema.c index 29d6f0478..fb8a64aec 100644 --- a/gio/gsettingsschema.c +++ b/gio/gsettingsschema.c @@ -250,16 +250,15 @@ g_settings_schema_source_unref (GSettingsSchemaSource *source) * This function is not required for normal uses of #GSettings but it * may be useful to authors of plugin management systems. * - * The directory should contain a file called - * gschemas.compiled as produced by the + * The directory should contain a file called `gschemas.compiled` as + * produced by the * glib-compile-schemas tool. * - * If @trusted is %TRUE then gschemas.compiled is - * trusted not to be corrupted. This assumption has a performance - * advantage, but can result in crashes or inconsistent behaviour in the - * case of a corrupted file. Generally, you should set @trusted to - * %TRUE for files installed by the system and to %FALSE for files in - * the home directory. + * If @trusted is %TRUE then `gschemas.compiled` is trusted not to be + * corrupted. This assumption has a performance advantage, but can result + * in crashes or inconsistent behaviour in the case of a corrupted file. + * Generally, you should set @trusted to %TRUE for files installed by the + * system and to %FALSE for files in the home directory. * * If @parent is non-%NULL then there are two effects. * diff --git a/gio/gtestdbus.c b/gio/gtestdbus.c index 012c7e010..f7cc0a62b 100644 --- a/gio/gtestdbus.c +++ b/gio/gtestdbus.c @@ -338,13 +338,13 @@ _g_test_watcher_remove_pid (GPid pid) * code tree. * * The first thing you will need is a separate service description file for the - * D-Bus daemon. Typically a services subdirectory of - * your tests directory is a good place to put this file. + * D-Bus daemon. Typically a `services` subdirectory of your `tests` directory + * is a good place to put this file. * * The service file should list your service along with an absolute path to the * uninstalled service executable in your source tree. Using autotools we would - * achieve this by adding a file such as my-server.service.in - * in the services directory and have it processed by configure. + * achieve this by adding a file such as `my-server.service.in` in the services + * directory and have it processed by configure. * |[ * [D-BUS Service] * Name=org.gtk.GDBus.Examples.ObjectManager diff --git a/gio/gunixconnection.c b/gio/gunixconnection.c index b79fdd2cc..b5da60a4e 100644 --- a/gio/gunixconnection.c +++ b/gio/gunixconnection.c @@ -39,9 +39,9 @@ * It contains functions to do some of the UNIX socket specific * functionality like passing file descriptors. * - * Note that <gio/gunixconnection.h> belongs to - * the UNIX-specific GIO interfaces, thus you have to use the - * gio-unix-2.0.pc pkg-config file when using it. + * Note that `` belongs to the UNIX-specific + * GIO interfaces, thus you have to use the `gio-unix-2.0.pc` + * pkg-config file when using it. * * Since: 2.22 */ diff --git a/gio/gunixfdlist.c b/gio/gunixfdlist.c index 7d5d732e8..5808e40cd 100644 --- a/gio/gunixfdlist.c +++ b/gio/gunixfdlist.c @@ -26,9 +26,9 @@ * the %G_SOCKET_ADDRESS_UNIX family by using g_socket_send_message() * and received using g_socket_receive_message(). * - * Note that <gio/gunixfdlist.h> belongs to - * the UNIX-specific GIO interfaces, thus you have to use the - * gio-unix-2.0.pc pkg-config file when using it. + * Note that `` belongs to the UNIX-specific GIO + * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config + * file when using it. */ #include "config.h" diff --git a/gio/gunixfdmessage.c b/gio/gunixfdmessage.c index a2746d9b8..12e62c53f 100644 --- a/gio/gunixfdmessage.c +++ b/gio/gunixfdmessage.c @@ -29,10 +29,10 @@ * stream-oriented UNIX sockets, see g_unix_connection_send_fd() and * g_unix_connection_receive_fd(). * - * Note that <gio/gunixfdmessage.h> belongs to - * the UNIX-specific GIO interfaces, thus you have to use the - * gio-unix-2.0.pc pkg-config file when using it. - **/ + * Note that `` belongs to the UNIX-specific GIO + * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config + * file when using it. + */ #include "config.h" diff --git a/gio/gunixinputstream.c b/gio/gunixinputstream.c index 51a46ee88..1d7d88d30 100644 --- a/gio/gunixinputstream.c +++ b/gio/gunixinputstream.c @@ -51,9 +51,9 @@ * asynchronous I/O. If it refers to a regular file, it will fall back * to doing asynchronous I/O in another thread.) * - * Note that <gio/gunixinputstream.h> belongs - * to the UNIX-specific GIO interfaces, thus you have to use the - * gio-unix-2.0.pc pkg-config file when using it. + * Note that `` belongs to the UNIX-specific GIO + * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config + * file when using it. */ enum { diff --git a/gio/gunixmounts.c b/gio/gunixmounts.c index dad997ab5..4999354c6 100644 --- a/gio/gunixmounts.c +++ b/gio/gunixmounts.c @@ -79,9 +79,9 @@ static const char *_resolve_dev_root (void); * * Routines for managing mounted UNIX mount points and paths. * - * Note that <gio/gunixmounts.h> belongs to the - * UNIX-specific GIO interfaces, thus you have to use the - * gio-unix-2.0.pc pkg-config file when using it. + * Note that `` belongs to the UNIX-specific GIO + * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config + * file when using it. */ /* @@ -217,8 +217,7 @@ is_in (const char *value, const char *set[]) /** * g_unix_is_mount_path_system_internal: - * @mount_path: a mount path, e.g. /media/disk - * or /usr + * @mount_path: a mount path, e.g. `/media/disk` or `/usr` * * Determines if @mount_path is considered an implementation of the * OS. This is primarily used for hiding mountable and mounted volumes diff --git a/gio/gunixoutputstream.c b/gio/gunixoutputstream.c index b3d2d3462..353be07d0 100644 --- a/gio/gunixoutputstream.c +++ b/gio/gunixoutputstream.c @@ -51,9 +51,9 @@ * asynchronous I/O. If it refers to a regular file, it will fall back * to doing asynchronous I/O in another thread.) * - * Note that <gio/gunixoutputstream.h> belongs - * to the UNIX-specific GIO interfaces, thus you have to use the - * gio-unix-2.0.pc pkg-config file when using it. + * Note that `` belongs to the UNIX-specific GIO + * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file + * when using it. */ enum { diff --git a/gio/gunixsocketaddress.c b/gio/gunixsocketaddress.c index cf9f7bb78..6b46ed0d7 100644 --- a/gio/gunixsocketaddress.c +++ b/gio/gunixsocketaddress.c @@ -44,9 +44,9 @@ * errors. You can use g_unix_socket_address_abstract_names_supported() * to see if abstract names are supported. * - * Note that <gio/gunixsocketaddress.h> belongs to - * the UNIX-specific GIO interfaces, thus you have to use the - * gio-unix-2.0.pc pkg-config file when using it. + * Note that `` belongs to the UNIX-specific GIO + * interfaces, thus you have to use the `gio-unix-2.0.pc` pkg-config file + * when using it. */ /** diff --git a/gio/gvolume.c b/gio/gvolume.c index fb5fc8125..87830233d 100644 --- a/gio/gvolume.c +++ b/gio/gvolume.c @@ -63,11 +63,10 @@ * to an application via the commandline). For this purpose, GIO * allows to obtain an 'identifier' for the volume. There can be * different kinds of identifiers, such as Hal UDIs, filesystem labels, - * traditional Unix devices (e.g. /dev/sda2), - * uuids. GIO uses predefind strings as names for the different kinds - * of identifiers: #G_VOLUME_IDENTIFIER_KIND_HAL_UDI, - * #G_VOLUME_IDENTIFIER_KIND_LABEL, etc. Use g_volume_get_identifier() - * to obtain an identifier for a volume. + * traditional Unix devices (e.g. `/dev/sda2`), UUIDs. GIO uses predefined + * strings as names for the different kinds of identifiers: + * #G_VOLUME_IDENTIFIER_KIND_HAL_UDI, #G_VOLUME_IDENTIFIER_KIND_LABEL, etc. + * Use g_volume_get_identifier() to obtain an identifier for a volume. * * * Note that #G_VOLUME_IDENTIFIER_KIND_HAL_UDI will only be available diff --git a/gio/gwin32inputstream.c b/gio/gwin32inputstream.c index b607c550b..685ecb0dd 100644 --- a/gio/gwin32inputstream.c +++ b/gio/gwin32inputstream.c @@ -44,9 +44,9 @@ * #GWin32InputStream implements #GInputStream for reading from a * Windows file handle. * - * Note that <gio/gwin32inputstream.h> belongs - * to the Windows-specific GIO interfaces, thus you have to use the - * gio-windows-2.0.pc pkg-config file when using it. + * Note that `` belongs to the Windows-specific GIO + * interfaces, thus you have to use the `gio-windows-2.0.pc` pkg-config file + * when using it. */ enum { diff --git a/gio/gwin32outputstream.c b/gio/gwin32outputstream.c index bae510245..13476c02a 100644 --- a/gio/gwin32outputstream.c +++ b/gio/gwin32outputstream.c @@ -45,9 +45,9 @@ * #GWin32OutputStream implements #GOutputStream for writing to a * Windows file handle. * - * Note that <gio/gwin32outputstream.h> belongs - * to the Windows-specific GIO interfaces, thus you have to use the - * gio-windows-2.0.pc pkg-config file when using it. + * Note that `` belongs to the Windows-specific GIO + * interfaces, thus you have to use the `gio-windows-2.0.pc` pkg-config file + * when using it. */ enum { diff --git a/glib/docs.c b/glib/docs.c index 28e2077c8..ea4dc2d61 100644 --- a/glib/docs.c +++ b/glib/docs.c @@ -2319,8 +2319,8 @@ * @static: empty or "static" * @dll_name: the name of the (pointer to the) char array where * the DLL name will be stored. If this is used, you must also - * include windows.h. If you need a more - * complex DLL entry point function, you cannot use this + * include `windows.h`. If you need a more complex DLL entry + * point function, you cannot use this * * On Windows, this macro defines a DllMain() function that stores * the actual DLL name that the code being compiled will be included in. diff --git a/glib/gconvert.c b/glib/gconvert.c index a835b79fc..62518c0f3 100644 --- a/glib/gconvert.c +++ b/glib/gconvert.c @@ -110,8 +110,7 @@ * encoding for file names in the `G_FILENAME_ENCODING` * environment variable. For example, if your installation uses - * ISO-8859-1 for file names, you can put this in your - * ~/.profile: + * ISO-8859-1 for file names, you can put this in your `~/.profile` * * export G_FILENAME_ENCODING=ISO-8859-1 * diff --git a/glib/ggettext.c b/glib/ggettext.c index 30f061000..2c27441e8 100644 --- a/glib/ggettext.c +++ b/glib/ggettext.c @@ -473,9 +473,9 @@ g_dngettext (const gchar *domain, * easy-to-use form. * * In order to use these macros in an application, you must include - * glib/gi18n.h. For use in a library, you must include - * glib/gi18n-lib.h after defining the %GETTEXT_PACKAGE - * macro suitably for your library: + * `<glib/gi18n.h>`. For use in a library, you must include + * `<glib/gi18n-lib.h>` + * after defining the %GETTEXT_PACKAGE macro suitably for your library: * |[ * #define GETTEXT_PACKAGE "gtk20" * #include diff --git a/glib/grand.c b/glib/grand.c index 0c1012491..9fd6e890c 100644 --- a/glib/grand.c +++ b/glib/grand.c @@ -208,8 +208,8 @@ g_rand_new_with_seed_array (const guint32 *seed, * g_rand_new: * * Creates a new random number generator initialized with a seed taken - * either from /dev/urandom (if existing) or from - * the current time (as a fallback). + * either from `/dev/urandom` (if existing) or from the current time + * (as a fallback). * * On Windows, the seed is taken from rand_s(). * diff --git a/glib/gstrfuncs.c b/glib/gstrfuncs.c index 5482ab627..5cb22c627 100644 --- a/glib/gstrfuncs.c +++ b/glib/gstrfuncs.c @@ -65,11 +65,9 @@ * * Note that the functions g_printf(), g_fprintf(), g_sprintf(), * g_snprintf(), g_vprintf(), g_vfprintf(), g_vsprintf() and g_vsnprintf() - * are declared in the header gprintf.h which is - * not included in glib.h - * (otherwise using glib.h would drag in - * stdio.h), so you'll have to explicitly include - * <glib/gprintf.h> in order to use the GLib + * are declared in the header `gprintf.h` which is not included in `glib.h` + * (otherwise using `glib.h` would drag in `stdio.h`), so you'll have to + * explicitly include `<glib/gprintf.h>` in order to use the GLib * printf() functions. * * diff --git a/glib/gtestutils.c b/glib/gtestutils.c index 1e144c037..c9c0a4ef9 100644 --- a/glib/gtestutils.c +++ b/glib/gtestutils.c @@ -188,16 +188,16 @@ /** * GTestTrapFlags: * @G_TEST_TRAP_SILENCE_STDOUT: Redirect stdout of the test child to - * /dev/null so it cannot be observed on the - * console during test runs. The actual output is still captured - * though to allow later tests with g_test_trap_assert_stdout(). + * `/dev/null` so it cannot be observed on the console during test + * runs. The actual output is still captured though to allow later + * tests with g_test_trap_assert_stdout(). * @G_TEST_TRAP_SILENCE_STDERR: Redirect stderr of the test child to - * /dev/null so it cannot be observed on the - * console during test runs. The actual output is still captured - * though to allow later tests with g_test_trap_assert_stderr(). + * `/dev/null` so it cannot be observed on the console during test + * runs. The actual output is still captured though to allow later + * tests with g_test_trap_assert_stderr(). * @G_TEST_TRAP_INHERIT_STDIN: If this flag is given, stdin of the * child process is shared with stdin of its parent process. - * It is redirected to /dev/null otherwise. + * It is redirected to `/dev/null` otherwise. * * Test traps are guards around forked tests. * These flags determine what traps to set. @@ -211,7 +211,7 @@ * GTestSubprocessFlags: * @G_TEST_SUBPROCESS_INHERIT_STDIN: If this flag is given, the child * process will inherit the parent's stdin. Otherwise, the child's - * stdin is redirected to /dev/null. + * stdin is redirected to `/dev/null`. * @G_TEST_SUBPROCESS_INHERIT_STDOUT: If this flag is given, the child * process will inherit the parent's stdout. Otherwise, the child's * stdout will not be visible, but it will be captured to allow diff --git a/glib/gtimezone.c b/glib/gtimezone.c index 49c4011c3..ef2f9e8d0 100644 --- a/glib/gtimezone.c +++ b/glib/gtimezone.c @@ -1316,7 +1316,7 @@ rules_from_identifier (const gchar *identifier, * time values to be added to Coordinated Universal Time (UTC) to get * the local time. * - * In Unix, the `TZ` environment variable typically corresponds + * In UNIX, the `TZ` environment variable typically corresponds * to the name of a file in the zoneinfo database, or string in * "std offset [dst [offset],start[/time],end[/time]]" (POSIX) format. * There are no spaces in the specification. The name of standard @@ -1340,11 +1340,10 @@ rules_from_identifier (const gchar *identifier, * * g_time_zone_new_local() calls this function with the value of the * `TZ` environment variable. This function itself is independent of - * the value of `TZ`, but if @identifier is %NULL then - * /etc/localtime will be consulted - * to discover the correct time zone on Unix and the registry will be - * consulted or GetTimeZoneInformation() will be used to get the local - * time zone on Windows. + * the value of `TZ`, but if @identifier is %NULL then `/etc/localtime` + * will be consulted to discover the correct time zone on UNIX and the + * registry will be consulted or GetTimeZoneInformation() will be used + * to get the local time zone on Windows. * * If intervals are not available, only time zone rules from `TZ` * environment variable or other means, then they will be computed diff --git a/glib/gunidecomp.c b/glib/gunidecomp.c index b8e33cb9b..2de3dd06c 100644 --- a/glib/gunidecomp.c +++ b/glib/gunidecomp.c @@ -26,12 +26,12 @@ * @See_also: g_locale_to_utf8(), g_locale_from_utf8() * * This section describes a number of functions for dealing with - * Unicode characters and strings. There are analogues of the - * traditional ctype.h character classification - * and case conversion functions, UTF-8 analogues of some string utility - * functions, functions to perform normalization, case conversion and - * collation on UTF-8 strings and finally functions to convert between - * the UTF-8, UTF-16 and UCS-4 encodings of Unicode. + * Unicode characters and strings. There are analogues of the + * traditional `ctype.h` character classification and case conversion + * functions, UTF-8 analogues of some string utility functions, + * functions to perform normalization, case conversion and collation + * on UTF-8 strings and finally functions to convert between the UTF-8, + * UTF-16 and UCS-4 encodings of Unicode. * * The implementations of the Unicode functions in GLib are based * on the Unicode Character Data tables, which are available from diff --git a/glib/gutils.c b/glib/gutils.c index a63bf650d..e60a2f10b 100644 --- a/glib/gutils.c +++ b/glib/gutils.c @@ -764,10 +764,10 @@ g_get_user_name (void) /** * g_get_real_name: * - * Gets the real name of the user. This usually comes from the user's entry - * in the passwd file. The encoding of the returned - * string is system-defined. (On Windows, it is, however, always UTF-8.) - * If the real user name cannot be determined, the string "Unknown" is + * Gets the real name of the user. This usually comes from the user's + * entry in the `passwd` file. The encoding of the returned string is + * system-defined. (On Windows, it is, however, always UTF-8.) If the + * real user name cannot be determined, the string "Unknown" is * returned. * * Returns: the user's real name. @@ -789,18 +789,16 @@ g_get_real_name (void) * * As with most UNIX tools, this function will return the value of the * `HOME` environment variable if it is set to an existing absolute path - * name, falling back to the passwd - * file in the case that it is unset. + * name, falling back to the `passwd` file in the case that it is unset. * * If the path given in `HOME` is non-absolute, does not exist, or is * not a directory, the result is undefined. * * Before version 2.36 this function would ignore the `HOME` environment - * variable, taking the value from the passwd - * database instead. This was changed to increase the compatibility - * of GLib with other programs (and the XDG basedir specification) - * and to increase testability of programs based on GLib (by making - * it easier to run them from test frameworks). + * variable, taking the value from the `passwd` database instead. This was + * changed to increase the compatibility of GLib with other programs (and + * the XDG basedir specification) and to increase testability of programs + * based on GLib (by making it easier to run them from test frameworks). * * If your program has a strong requirement for either the new or the * old behaviour (and if you don't wish to increase your GLib @@ -1696,10 +1694,10 @@ g_reload_user_special_dirs_cache (void) * * Returns the full path of a special directory using its logical id. * - * On Unix this is done using the XDG special user directories. + * On UNIX this is done using the XDG special user directories. * For compatibility with existing practise, %G_USER_DIRECTORY_DESKTOP - * falls back to $HOME/Desktop when XDG special - * user directories have not been set up. + * falls back to `$HOME/Desktop` when XDG special user directories have + * not been set up. * * Depending on the platform, the user might be able to change the path * of the special directory without requiring the session to restart; GLib diff --git a/gmodule/gmodule.c b/gmodule/gmodule.c index bacb2df5e..f6db3a53d 100644 --- a/gmodule/gmodule.c +++ b/gmodule/gmodule.c @@ -891,8 +891,8 @@ g_module_name (GModule *module) /** * g_module_build_path: - * @directory: (allow-none): the directory where the module is. This can be %NULL - * or the empty string to indicate that the standard platform-specific + * @directory: (allow-none): the directory where the module is. This can be + * %NULL or the empty string to indicate that the standard platform-specific * directories will be used, though that is not recommended * @module_name: the name of the module * @@ -906,10 +906,9 @@ g_module_name (GModule *module) * 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. + * @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`. * * Returns: the complete path of the module, including the standard library * prefix and suffix. This should be freed when no longer needed