summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBehdad Esfahbod <behdad@gnome.org>2007-05-24 20:57:23 +0000
committerBehdad Esfahbod <behdad@src.gnome.org>2007-05-24 20:57:23 +0000
commit843acf5e0c4452ef32099b4120ef965d83605a37 (patch)
tree66d53df1d58e4fb9e1e953109f08d6f866495e37
parent4bf96efe5913ead12b9a782d8eecbfcfde26e1b1 (diff)
downloadpango-843acf5e0c4452ef32099b4120ef965d83605a37.tar.gz
Add stability note.
2007-05-24 Behdad Esfahbod <behdad@gnome.org> * docs/tmpl/opentype.sgml: * docs/tmpl/pango-engine-lang.sgml: * docs/tmpl/pango-engine-shape.sgml: Add stability note. svn path=/trunk/; revision=2319
-rw-r--r--ChangeLog7
-rw-r--r--docs/tmpl/opentype.sgml2
-rw-r--r--docs/tmpl/pango-engine-lang.sgml2
-rw-r--r--docs/tmpl/pango-engine-shape.sgml2
-rw-r--r--docs/tmpl/vertical.sgml6
5 files changed, 14 insertions, 5 deletions
diff --git a/ChangeLog b/ChangeLog
index 50ef6488..ef96515c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,12 @@
2007-05-24 Behdad Esfahbod <behdad@gnome.org>
+ * docs/tmpl/opentype.sgml:
+ * docs/tmpl/pango-engine-lang.sgml:
+ * docs/tmpl/pango-engine-shape.sgml:
+ Add stability note.
+
+2007-05-24 Behdad Esfahbod <behdad@gnome.org>
+
* docs/tmpl/vertical.sgml: Document how Pango's vertical text support
works.
diff --git a/docs/tmpl/opentype.sgml b/docs/tmpl/opentype.sgml
index 3b6aa4df..45865df6 100644
--- a/docs/tmpl/opentype.sgml
+++ b/docs/tmpl/opentype.sgml
@@ -17,7 +17,7 @@ shaping engines
</para>
<!-- ##### SECTION Stability_Level ##### -->
-
+Part of Pango's engine API, but stable
<!-- ##### TYPEDEF PangoOTTag ##### -->
<para>
diff --git a/docs/tmpl/pango-engine-lang.sgml b/docs/tmpl/pango-engine-lang.sgml
index dff0fd42..4a30742a 100644
--- a/docs/tmpl/pango-engine-lang.sgml
+++ b/docs/tmpl/pango-engine-lang.sgml
@@ -17,7 +17,7 @@ These engines are used in pango_break().
</para>
<!-- ##### SECTION Stability_Level ##### -->
-
+Part of Pango's engine API, and may change between module version changes
<!-- ##### STRUCT PangoEngineLang ##### -->
<para>
diff --git a/docs/tmpl/pango-engine-shape.sgml b/docs/tmpl/pango-engine-shape.sgml
index 478d667f..6b2632fe 100644
--- a/docs/tmpl/pango-engine-shape.sgml
+++ b/docs/tmpl/pango-engine-shape.sgml
@@ -17,7 +17,7 @@ These engines are used in pango_shape().
</para>
<!-- ##### SECTION Stability_Level ##### -->
-
+Part of Pango's engine API, and may change between module version changes
<!-- ##### STRUCT PangoEngineShape ##### -->
<para>
diff --git a/docs/tmpl/vertical.sgml b/docs/tmpl/vertical.sgml
index de80afd3..5df8f4df 100644
--- a/docs/tmpl/vertical.sgml
+++ b/docs/tmpl/vertical.sgml
@@ -9,7 +9,8 @@ Laying text out in vertical directions
Since 1.16, Pango is able to correctly lay vertical text out. In fact, it can
set layouts of mixed vertical and non-vertical text. This section describes
the types used for setting vertical text parameters.
-
+</para>
+<para>
The way this is implemented is through the concept of
<firstterm>gravity</firstterm>. Gravity of normal Latin text is south. A
gravity value of east means that glyphs will be rotated ninety degrees
@@ -18,7 +19,8 @@ and rotate the layout using the matrix machinery already in place. This has
the huge advantage that most algorithms working on a #PangoLayout do not need
any change as the assumption that lines run in the X direction and stack in
the Y direction holds even for vertical text layouts.
-
+</para>
+<para>
Applications should only need to set base gravity on #PangoContext in use, and
let Pango decide the gravity assigned to each run of text. This automatically
handles text with mixed scripts. A very common use is to set the context base