GNOME.org
 

[pango/gi-docs: 47/47] Remove vestigial xml markup


commit d0bc28537e9daa02f7652dd830237a9b50935749
Author: Matthias Clasen <mclasen redhat com>
Date:   Wed Feb 17 00:22:34 2021 -0500

    Remove vestigial xml markup

 pango/pango-break.h       | 63 +++++++++++++++++++++--------------------------
 pango/pango-script.h      | 11 ++++-----
 pango/pangocairo-render.c | 18 +++++++-------
 3 files changed, 42 insertions(+), 50 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
 {
diff --git a/pango/pango-script.h b/pango/pango-script.h
index a7ec3246..66cca15a 100644
--- a/pango/pango-script.h
+++ b/pango/pango-script.h
@@ -156,16 +156,15 @@ typedef struct _PangoScriptIter PangoScriptIter;
  * @PANGO_SCRIPT_OLD_HUNGARIAN:        Old Hungarian. Since: 1.40
  * @PANGO_SCRIPT_SIGNWRITING:          Signwriting. Since: 1.40
  *
- * The #PangoScript enumeration identifies different writing
+ * The `PangoScript` enumeration identifies different writing
  * systems. The values correspond to the names as defined in the
- * Unicode standard. See <ulink
- * url="http://www.unicode.org/reports/tr24/";>Unicode Standard Annex
- * #24: Script names</ulink>.
+ * Unicode standard. See
+ * [Unicode Standard Annex 24: Script names](http://www.unicode.org/reports/tr24/)
  *
  * Note that this enumeration is deprecated and will not be updated
  * to include values in newer versions of the Unicode standard.
- * Applications should use the GUnicodeScript enumeration instead,
- * whose values are interchangeable with PangoScript.
+ * Applications should use the `GUnicodeScript` enumeration instead,
+ * whose values are interchangeable with `PangoScript`.
  */
 typedef enum {                         /* ISO 15924 code */
       PANGO_SCRIPT_INVALID_CODE = -1,
diff --git a/pango/pangocairo-render.c b/pango/pangocairo-render.c
index e5297953..0426e9b4 100644
--- a/pango/pangocairo-render.c
+++ b/pango/pangocairo-render.c
@@ -69,11 +69,11 @@
  *   PangoFontDescription *desc;
  *   int i;
  *
- *   /&ast; Center coordinates on the middle of the region we are drawing
- *    &ast;/
+ *   /* Center coordinates on the middle of the region we are drawing
+ *    */
  *   cairo_translate (cr, RADIUS, RADIUS);
  *
- *   /&ast; Create a PangoLayout, set the font and text &ast;/
+ *   /* Create a PangoLayout, set the font and text */
  *   layout = pango_cairo_create_layout (cr);
  *
  *   pango_layout_set_text (layout, "Text", -1);
@@ -81,8 +81,8 @@
  *   pango_layout_set_font_description (layout, desc);
  *   pango_font_description_free (desc);
  *
- *   /&ast; Draw the layout N_WORDS times in a circle &ast;/
- *   for (i = 0; i &lt; N_WORDS; i++)
+ *   /* Draw the layout N_WORDS times in a circle */
+ *   for (i = 0; i < N_WORDS; i++)
  *     {
  *       int width, height;
  *       double angle = (360. * i) / N_WORDS;
@@ -90,23 +90,23 @@
  *
  *       cairo_save (cr);
  *
- *       /&ast; Gradient from red at angle == 60 to blue at angle == 240 &ast;/
+ *       /* Gradient from red at angle == 60 to blue at angle == 240 */
  *       red   = (1 + cos ((angle - 60) * G_PI / 180.)) / 2;
  *       cairo_set_source_rgb (cr, red, 0, 1.0 - red);
  *
  *       cairo_rotate (cr, angle * G_PI / 180.);
  *
- *       /&ast; Inform Pango to re-layout the text with the new transformation &ast;/
+ *       /* Inform Pango to re-layout the text with the new transformation */
  *       pango_cairo_update_layout (cr, layout);
  *
- *       pango_layout_get_size (layout, &amp;width, &amp;height);
+ *       pango_layout_get_size (layout, &width, &height);
  *       cairo_move_to (cr, - ((double)width / PANGO_SCALE) / 2, - RADIUS);
  *       pango_cairo_show_layout (cr, layout);
  *
  *       cairo_restore (cr);
  *     }
  *
- *   /&ast; free the layout object &ast;/
+ *   /* free the layout object */
  *   g_object_unref (layout);
  * }
  *
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]