[pango] Mention GMarkup and character entities
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [pango] Mention GMarkup and character entities
- Date: Mon, 5 Sep 2011 14:13:42 +0000 (UTC)
commit a1f4357d98d072761fe085197de53e01da46f2fc
Author: Matthias Clasen <mclasen redhat com>
Date: Mon Sep 5 10:11:28 2011 -0400
Mention GMarkup and character entities
As requested in bug 403499.
docs/pango_markup.sgml | 12 +++++++++---
1 files changed, 9 insertions(+), 3 deletions(-)
---
diff --git a/docs/pango_markup.sgml b/docs/pango_markup.sgml
index 0460ccb..68d2901 100644
--- a/docs/pango_markup.sgml
+++ b/docs/pango_markup.sgml
@@ -29,7 +29,7 @@ position.
The solution is to include the text attributes in the string to be
translated. Pango provides this feature with a small markup language.
You can parse a marked-up string into the string text plus a
-<link linkend="PangoAttrList">PangoAttrList</link> using the function
+<link linkend="PangoAttrList">PangoAttrList</link> using the function
<link linkend="pango-parse-markup">pango_parse_markup()</link>.
</para>
@@ -39,6 +39,12 @@ A simple example of a marked-up string might be:
</para>
<para>
+Pango uses #GMarkup to parse this language, which means that XML features
+such as numeric character entities such as &#169; for © can
+be used too.
+</para>
+
+<para>
The root tag of a marked-up document is <markup>, but <link
linkend="pango-parse-markup">pango_parse_markup()</link> allows you to
omit this tag, so you will most likely never need to use it. The most
@@ -50,8 +56,8 @@ tags. <span> has the following attributes:
<term>font<footnote id='since_1_21'><para>Since 1.21</para></footnote></term>
<term>font_desc</term>
<listitem><para>
-A font description string, such as "Sans Italic 12". See
-<link linkend="pango-font-description-from-string">pango_font_description_from_string()</link>
+A font description string, such as "Sans Italic 12". See
+<link linkend="pango-font-description-from-string">pango_font_description_from_string()</link>
for a description of the format of the string representation . Note that any
other span attributes will override this description. So if you have
"Sans Italic" and also a style="normal" attribute, you will get Sans normal,
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]