docs: Use markdown for ulinks

2014-02-03 16:56:15 -05:00 · 2014-02-03 16:56:15 -05:00 · 8d6717097c
commit 8d6717097c
parent 50e06e11ee
9 changed files with 32 additions and 42 deletions
--- a/gdk/gdkapplaunchcontext.c
+++ b/gdk/gdkapplaunchcontext.c
@ -236,8 +236,7 @@ gdk_app_launch_context_set_screen (GdkAppLaunchContext *context,
 * Sets the workspace on which applications will be launched when
 * using this context when running under a window manager that
 * supports multiple workspaces, as described in the
- * <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
- * Window Manager Hints</ulink>.
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec).
 *
 * When the workspace is not specified or @desktop is set to -1,
 * it is up to the window manager to pick one, typically it will
--- a/gdk/gdkdisplay.c
+++ b/gdk/gdkdisplay.c
@ -1644,8 +1644,7 @@ gdk_display_supports_clipboard_persistence (GdkDisplay *display)
 * Issues a request to the clipboard manager to store the
 * clipboard data. On X11, this is a special program that works
 * according to the freedesktop clipboard specification, available at
- * <ulink url="http://www.freedesktop.org/Standards/clipboard-manager-spec">
- * http://www.freedesktop.org/Standards/clipboard-manager-spec</ulink>.
+ * [http://www.freedesktop.org/Standards/clipboard-manager-spec](http://www.freedesktop.org/Standards/clipboard-manager-spec).
 *
 * Since: 2.6
 */
--- a/gdk/gdkscreen.c
+++ b/gdk/gdkscreen.c
@ -992,9 +992,9 @@ gdk_screen_make_display_name (GdkScreen *screen)
 * Returns the screen's currently active window.
 *
 * On X11, this is done by inspecting the _NET_ACTIVE_WINDOW property
- * on the root window, as described in the <ulink
- * url="http://www.freedesktop.org/Standards/wm-spec">Extended Window
- * Manager Hints</ulink>. If there is no currently currently active
+ * on the root window, as described in the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec).
+ * If there is no currently currently active
 * window, or the window manager does not support the
 * _NET_ACTIVE_WINDOW hint, this function returns %NULL.
 *
@ -1024,9 +1024,9 @@ gdk_screen_get_active_window (GdkScreen *screen)
 * window stack.
 *
 * On X11, this is done by inspecting the _NET_CLIENT_LIST_STACKING
- * property on the root window, as described in the <ulink
- * url="http://www.freedesktop.org/Standards/wm-spec">Extended Window
- * Manager Hints</ulink>. If the window manager does not support the
+ * property on the root window, as described in the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec).
+ * If the window manager does not support the
 * _NET_CLIENT_LIST_STACKING hint, this function returns %NULL.
 *
 * On other platforms, this function may return %NULL, depending on whether
--- a/gdk/gdkwindow.c
+++ b/gdk/gdkwindow.c
@ -10208,8 +10208,9 @@ gdk_window_set_functions (GdkWindow    *window,
 * Begins a window resize operation (for a toplevel window).
 * You might use this function to implement a "window resize grip," for
 * example; in fact #GtkStatusbar uses it. The function works best
- * with window managers that support the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended Window Manager Hints</ulink>, but has a
- * fallback implementation for other window managers.
+ * with window managers that support the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
+ * but has a fallback implementation for other window managers.
 *
 * Since: 3.4
 */
@ -10268,10 +10269,9 @@ gdk_window_begin_resize_drag (GdkWindow     *window,
 *
 * Begins a window move operation (for a toplevel window).
 * You might use this function to implement a "window move grip," for
- * example. The function works best with window managers that support
- * the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
- * Window Manager Hints</ulink>, but has a fallback implementation for
- * other window managers.
+ * example. The function works best with window managers that support the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
+ * but has a fallback implementation for other window managers.
 *
 * Since: 3.4
 */
--- a/gdk/gdkwindow.h
+++ b/gdk/gdkwindow.h
@ -177,10 +177,8 @@ typedef enum
 * the window has. The window manager can use this when determining decoration
 * and behaviour of the window. The hint must be set before mapping the window.
 *
- * See the
- * <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
- * Window Manager Hints</ulink> specification for more details about
- * window types.
+ * See the [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
+ * specification for more details about window types.
 */
 typedef enum
 {
@ -274,8 +272,8 @@ typedef enum
 * Defines the reference point of a window and the meaning of coordinates
 * passed to gtk_window_move(). See gtk_window_move() and the "implementation
 * notes" section of the
- * <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended
- * Window Manager Hints</ulink> specification for more details.
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec)
+ * specification for more details.
 */
 typedef enum
 {
--- a/gdk/wayland/gdkdisplay-wayland.c
+++ b/gdk/wayland/gdkdisplay-wayland.c
@ -443,10 +443,9 @@ gdk_wayland_display_get_next_serial (GdkDisplay *display)
 *
 * This is a convenience function for use by code that implements the
 * freedesktop startup notification specification. Applications should
- * not normally need to call it directly. See the <ulink
- * url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">Startup
- * Notification Protocol specification</ulink> for
- * definitions of the message types and keys that can be used.
+ * not normally need to call it directly. See the 
+ * [Startup Notification Protocol specification](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt)
+ * for definitions of the message types and keys that can be used.
 *
 * Since: 2.12
 **/
--- a/gdk/x11/gdkdisplay-x11.c
+++ b/gdk/x11/gdkdisplay-x11.c
@ -2147,10 +2147,9 @@ broadcast_xmessage (GdkDisplay *display,
 *
 * This is a convenience function for use by code that implements the
 * freedesktop startup notification specification. Applications should
- * not normally need to call it directly. See the <ulink
- * url="http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt">Startup
- * Notification Protocol specification</ulink> for
- * definitions of the message types and keys that can be used.
+ * not normally need to call it directly. See the
+ * [Startup Notification Protocol specification](http://standards.freedesktop.org/startup-notification-spec/startup-notification-latest.txt)
+ * for definitions of the message types and keys that can be used.
 *
 * Since: 2.12
 **/
--- a/gdk/x11/gdkscreen-x11.c
+++ b/gdk/x11/gdkscreen-x11.c
@ -1543,9 +1543,7 @@ fetch_net_wm_check_window (GdkScreen *screen)
 *
 * This function is specific to the X11 backend of GDK, and indicates
 * whether the window manager supports a certain hint from the
- * Extended Window Manager Hints Specification. You can find this
- * specification on
- * <ulink url="http://www.freedesktop.org">http://www.freedesktop.org</ulink>.
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec) specification.
 *
 * When using this function, keep in mind that the window manager
 * can change over time; so you shouldn't use this function in
@ -1793,8 +1791,8 @@ get_netwm_cardinal_property (GdkScreen   *screen,
 *
 * Returns the number of workspaces for @screen when running under a
 * window manager that supports multiple workspaces, as described
- * in the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended 
- * Window Manager Hints</ulink>.
+ * in the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec) specification.
 *
 * Returns: the number of workspaces, or 0 if workspaces are not supported
 *
@ -1812,8 +1810,8 @@ gdk_x11_screen_get_number_of_desktops (GdkScreen *screen)
 *
 * Returns the current workspace for @screen when running under a
 * window manager that supports multiple workspaces, as described
- * in the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended 
- * Window Manager Hints</ulink>.
+ * in the
+ * [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec) specification.
 *
 * Returns: the current workspace, or 0 if workspaces are not supported
 *
--- a/gdk/x11/gdkwindow-x11.c
+++ b/gdk/x11/gdkwindow-x11.c
@ -2103,9 +2103,8 @@ gdk_window_x11_lower (GdkWindow *window)
 * 
 * Moves the window to the correct workspace when running under a 
 * window manager that supports multiple workspaces, as described
- * in the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended 
- * Window Manager Hints</ulink>.  Will not do anything if the
- * window is already on all workspaces.
+ * in the [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec) specification.
+ * Will not do anything if the window is already on all workspaces.
 * 
 * Since: 2.8
 */
@ -2193,8 +2192,7 @@ gdk_x11_window_get_desktop (GdkWindow *window)
 *
 * Moves the window to the given workspace when running unde a
 * window manager that supports multiple workspaces, as described
- * in the <ulink url="http://www.freedesktop.org/Standards/wm-spec">Extended 
- * Window Manager Hints</ulink>.
+ * in the [Extended Window Manager Hints](http://www.freedesktop.org/Standards/wm-spec) specification.
 *
 * Since: 3.10
 */