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, 28 insertions, 35 deletions

diff --git a/pango/pango-break.h b/pango/pango-break.h
index 9209ee15..ae7d953a 100644
--- a/pango/pango-break.h
+++ b/pango/pango-break.h
@@ -37,51 +37,44 @@ G_BEGIN_DECLS
  * @is_char_break: if set, can break here when doing character wrapping
  * @is_white: is whitespace character
  * @is_cursor_position: if set, cursor can appear in front of character.
- * i.e. this is a grapheme boundary, or the first character
- * in the text.
- * This flag implements Unicode's
- * <ulink url="http://www.unicode.org/reports/tr29/">Grapheme
- * Cluster Boundaries</ulink> semantics.
+ *   i.e. this is a grapheme boundary, or the first character in the text.
+ *   This flag implements Unicode's
+ *   [Grapheme Cluster Boundaries](http://www.unicode.org/reports/tr29/)
+ *   semantics.
  * @is_word_start: is first character in a word
  * @is_word_end: is first non-word char after a word
- * Note that in degenerate cases, you could have both @is_word_start
- * and @is_word_end set for some character.
+ *   Note that in degenerate cases, you could have both @is_word_start
+ *   and @is_word_end set for some character.
  * @is_sentence_boundary: is a sentence boundary.
- * There are two ways to divide sentences. The first assigns all
- * inter-sentence whitespace/control/format chars to some sentence,
- * so all chars are in some sentence; @is_sentence_boundary denotes
- * the boundaries there. The second way doesn't assign
- * between-sentence spaces, etc. to any sentence, so
+ *   There are two ways to divide sentences. The first assigns all
+ *   inter-sentence whitespace/control/format chars to some sentence,
+ *   so all chars are in some sentence; @is_sentence_boundary denotes
+ *   the boundaries there. The second way doesn't assign
+ *   between-sentence spaces, etc. to any sentence, so
  * @is_sentence_start/@is_sentence_end mark the boundaries of those sentences.
  * @is_sentence_start: is first character in a sentence
  * @is_sentence_end: is first char after a sentence.
- * Note that in degenerate cases, you could have both @is_sentence_start
- * and @is_sentence_end set for some character. (e.g. no space after a
- * period, so the next sentence starts right away)
+ *   Note that in degenerate cases, you could have both @is_sentence_start
+ *   and @is_sentence_end set for some character. (e.g. no space after a
+ *   period, so the next sentence starts right away)
  * @backspace_deletes_character: if set, backspace deletes one character
- * rather than the entire grapheme cluster. This
- * field is only meaningful on grapheme
- * boundaries (where @is_cursor_position is
- * set).  In some languages, the full grapheme
- * (e.g.  letter + diacritics) is considered a
- * unit, while in others, each decomposed
- * character in the grapheme is a unit. In the
- * default implementation of pango_break(), this
- * bit is set on all grapheme boundaries except
- * those following Latin, Cyrillic or Greek base characters.
+ *   rather than the entire grapheme cluster. This field is only meaningful
+ *   on grapheme boundaries (where @is_cursor_position is set). In some languages,
+ *   the full grapheme (e.g. letter + diacritics) is considered a unit, while in
+ *   others, each decomposed character in the grapheme is a unit. In the default
+ *   implementation of [func@break], this bit is set on all grapheme boundaries
+ *   except those following Latin, Cyrillic or Greek base characters.
  * @is_expandable_space: is a whitespace character that can possibly be
- * expanded for justification purposes. (Since: 1.18)
+ *   expanded for justification purposes. (Since: 1.18)
  * @is_word_boundary: is a word boundary, as defined by UAX#29.
- * More specifically, means that this is not a position in the middle
- * of a word.  For example, both sides of a punctuation mark are
- * considered word boundaries.  This flag is particularly useful when
- * selecting text word-by-word.
- * This flag implements Unicode's
- * <ulink url="http://www.unicode.org/reports/tr29/">Word
- * Boundaries</ulink> semantics. (Since: 1.22)
+ *   More specifically, means that this is not a position in the middle of a word.
+ *   For example, both sides of a punctuation mark are considered word boundaries.
+ *   This flag is particularly useful when selecting text word-by-word. This flag
+ *   implements Unicode's [Word Boundaries](http://www.unicode.org/reports/tr29/)
+ *   semantics. (Since: 1.22)
  *
- * The #PangoLogAttr structure stores information
- * about the attributes of a single character.
+ * The `PangoLogAttr` structure stores information about the attributes of a
+ * single character.
  */
 struct _PangoLogAttr
 {