summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorBehdad Esfahbod <behdad@gnome.org>2007-06-12 00:07:24 +0000
committerBehdad Esfahbod <behdad@src.gnome.org>2007-06-12 00:07:24 +0000
commit19290cba0704aec45d7cceb81c283f80a79db933 (patch)
tree9c2adc8f2b8ad1942269e0018fd79e67be52f2d4 /docs
parent238cd14f991b00a9499e1bd4b6a1d9a27113e16d (diff)
downloadpango-19290cba0704aec45d7cceb81c283f80a79db933.tar.gz
New engine public macros:
2007-06-11 Behdad Esfahbod <behdad@gnome.org> * pango/pango-ot.h: New engine public macros: PANGO_OT_TAG_MAKE() PANGO_OT_TAG_MAKE_FROM_STRING() * docs/pango-sections.txt: * docs/tmpl/opentype.sgml: Update. 2007-06-11 Behdad Esfahbod <behdad@gnome.org> Bug 446018 – Bus error in the pango_ot_tag_from_language() * pango/pango-ot-tag.c (pango_ot_tag_from_script), (pango_ot_tag_to_script), (pango_ot_tag_from_language), (pango_ot_tag_to_language): Make sure int access is aligned. svn path=/trunk/; revision=2344
Diffstat (limited to 'docs')
-rw-r--r--docs/pango-sections.txt2
-rw-r--r--docs/tmpl/opentype.sgml30
2 files changed, 29 insertions, 3 deletions
diff --git a/docs/pango-sections.txt b/docs/pango-sections.txt
index e4247991..6b07e8c8 100644
--- a/docs/pango-sections.txt
+++ b/docs/pango-sections.txt
@@ -947,6 +947,8 @@ PangoOTRuleset
PangoOTRulesetDescription
PangoOTTableType
PangoOTFeatureMap
+PANGO_OT_TAG_MAKE
+PANGO_OT_TAG_MAKE_FROM_STRING
PANGO_OT_ALL_GLYPHS
PANGO_OT_NO_FEATURE
PANGO_OT_NO_SCRIPT
diff --git a/docs/tmpl/opentype.sgml b/docs/tmpl/opentype.sgml
index 20910f82..dd049964 100644
--- a/docs/tmpl/opentype.sgml
+++ b/docs/tmpl/opentype.sgml
@@ -22,9 +22,8 @@ Part of Pango's engine API, but stable
<!-- ##### TYPEDEF PangoOTTag ##### -->
<para>
The <type>PangoOTTag</type> typedef is used to represent TrueType and OpenType
-four letter tags inside Pango. Use the <function>FT_MAKE_TAG()</function> macro
-defined in the FreeType2 header <filename>freetype/freetype.h</filename> to
-create <type>PangoOTTag</type>s manually.
+four letter tags inside Pango. Use PANGO_OT_TAG_MAKE()
+or PANGO_OT_TAG_MAKE_FROM_STRING() macros to create <type>PangoOTTag</type>s manually.
</para>
@@ -120,6 +119,31 @@ represented as a char array instead of a #PangoOTTag for convenience.
pango_ot_ruleset_add_feature() for details.
@Since: 1.18
+<!-- ##### MACRO PANGO_OT_TAG_MAKE ##### -->
+<para>
+Creates a #PangoOTTag from four characters. This is similar and
+compatible with the <function>FT_MAKE_TAG()</function> macro from
+FreeType.
+</para>
+
+@c1: First character.
+@c2: Second character.
+@c3: Third character.
+@c4: Fourth character.
+
+
+<!-- ##### MACRO PANGO_OT_TAG_MAKE_FROM_STRING ##### -->
+<para>
+Creates a #PangoOTTag from a string. The string should be at least
+four characters long (pad with space characters if needed), and need
+not be nul-terminated. This is a convenience wrapper around
+PANGO_OT_TAG_MAKE(), but cannot be used in certain situations, for
+example, as a switch expression, as it dereferences pointers.
+</para>
+
+@s: The string representation of the tag.
+
+
<!-- ##### MACRO PANGO_OT_ALL_GLYPHS ##### -->
<para>
This is used as the property bit in pango_ot_ruleset_add_feature() when a