docs: Replace lots of vestigial xml markup

We want to use pure markdown, since docbook
is going away as the intermediate format.

1 files changed, 21 insertions, 27 deletions

diff --git a/pango/pango-color.c b/pango/pango-color.c
index a530719f..7f939030 100644
--- a/pango/pango-color.c
+++ b/pango/pango-color.c
@@ -80,8 +80,7 @@ pango_color_free (PangoColor *color)
  * @color: a #PangoColor
  *
  * Returns a textual specification of @color in the hexadecimal form
- * <literal>&num;rrrrggggbbbb</literal>, where <literal>r</literal>,
- * <literal>g</literal> and <literal>b</literal> are hex digits representing
+ * `#rrrrggggbbbb`, where `r`, `g` and `b` are hex digits representing
  * the red, green, and blue components respectively.
  *
  * Return value: a newly-allocated text string that must be freed with g_free().
@@ -214,23 +213,20 @@ hex (const char *spec,
  * @alpha: (out) (optional): return location for alpha, or %NULL
  * @spec: a string specifying the new color
  *
- * Fill in the fields of a color from a string specification. The
- * string can either one of a large set of standard names. (Taken
- * from the CSS <ulink url="http://dev.w3.org/csswg/css-color/#named-colors">specification</ulink>), or it can be a hexadecimal
- * value in the
- * form '&num;rgb' '&num;rrggbb' '&num;rrrgggbbb' or '&num;rrrrggggbbbb' where
- * 'r', 'g' and 'b' are hex digits of the red, green, and blue
- * components of the color, respectively. (White in the four
- * forms is '&num;fff' '&num;ffffff' '&num;fffffffff' and '&num;ffffffffffff')
+ * Fill in the fields of a color from a string specification. The string can
+ * either one of a large set of standard names. (Taken from the CSS Color
+ * [specification](https://www.w3.org/TR/css-color-4/#named-colors),
+ * or it can be a hexadecimal value in the form `#rgb`, `#rrggbb`, `#rrrgggbbb`
+ * or `#rrrrggggbbbb` where `r`, `g` and `b` are hex digits of the red, green,
+ * and blue components of the color, respectively. (White in the four
+ * forms is `#fff`, `#ffffff`, `#fffffffff` and `#ffffffffffff`.)
  *
- * Additionally, parse strings of the form
- * '&num;rgba', '&num;rrggbbaa', '&num;rrrrggggbbbbaaaa',
- * if @alpha is not %NULL, and set @alpha to the value specified
- * by the hex digits for 'a'. If no alpha component is found
+ * Additionally, parse strings of the form `#rgba`, `#rrggbbaa`,
+ * `#rrrrggggbbbbaaaa`, if @alpha is not %NULL, and set @alpha to the value
+ * specified by the hex digits for `a`. If no alpha component is found
  * in @spec, @alpha is set to 0xffff (for a solid color).
  *
- * Return value: %TRUE if parsing of the specifier succeeded,
- *   otherwise false.
+ * Return value: %TRUE if parsing of the specifier succeeded, otherwise false.
  *
  * Since: 1.46
  */
@@ -323,21 +319,19 @@ pango_color_parse_with_alpha (PangoColor *color,
  *   result, or %NULL
  * @spec: a string specifying the new color
  *
- * Fill in the fields of a color from a string specification. The
- * string can either one of a large set of standard names. (Taken
- * from the CSS <ulink url="http://dev.w3.org/csswg/css-color/#named-colors">specification</ulink>), or it can be a hexadecimal
- * value in the
- * form '&num;rgb' '&num;rrggbb' '&num;rrrgggbbb' or '&num;rrrrggggbbbb' where
- * 'r', 'g' and 'b' are hex digits of the red, green, and blue
- * components of the color, respectively. (White in the four
- * forms is '&num;fff' '&num;ffffff' '&num;fffffffff' and '&num;ffffffffffff')
+ * Fill in the fields of a color from a string specification. The string can either
+ * one of a large set of standard names. (Taken from the CSS Color
+ * [specification](https://www.w3.org/TR/css-color-4/#named-colors), or it can be
+ * a value in the form `#rgb`, `#rrggbb`, `#rrrgggbbb` or `#rrrrggggbbbb`, where
+ * `r`, `g` and `b` are hex digits of the red, green, and blue components of the
+ * color, respectively. (White in the four forms is `#fff`, `#ffffff`, `#fffffffff`
+ * and `#ffffffffffff`.)
  *
- * Return value: %TRUE if parsing of the specifier succeeded,
- *   otherwise false.
+ * Return value: %TRUE if parsing of the specifier succeeded, otherwise false.
  **/
 gboolean
 pango_color_parse (PangoColor *color,
-		   const char *spec)
+                   const char *spec)
 {
   return pango_color_parse_with_alpha (color, NULL, spec);
 }