summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog6
-rw-r--r--ChangeLog.pre-1-106
-rw-r--r--ChangeLog.pre-1-46
-rw-r--r--ChangeLog.pre-1-66
-rw-r--r--ChangeLog.pre-1-86
-rw-r--r--pango/pango-context.c14
6 files changed, 44 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index 8b06b7a0..44d71298 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2003-09-12 Matthias Clasen <maclas@gmx.de>
+
+ * pango/pango-context.c (pango_context_set_font_map)
+ (pango_context_new): Document these funcions as backends-only, and
+ explain how to obtain initialized contexts. (#121881, Martin Pool)
+
Tue Sep 9 12:17:07 2003 Owen Taylor <otaylor@redhat.com>
* tools/Makefile.am (EXTRA_DIST): Remove reference
diff --git a/ChangeLog.pre-1-10 b/ChangeLog.pre-1-10
index 8b06b7a0..44d71298 100644
--- a/ChangeLog.pre-1-10
+++ b/ChangeLog.pre-1-10
@@ -1,3 +1,9 @@
+2003-09-12 Matthias Clasen <maclas@gmx.de>
+
+ * pango/pango-context.c (pango_context_set_font_map)
+ (pango_context_new): Document these funcions as backends-only, and
+ explain how to obtain initialized contexts. (#121881, Martin Pool)
+
Tue Sep 9 12:17:07 2003 Owen Taylor <otaylor@redhat.com>
* tools/Makefile.am (EXTRA_DIST): Remove reference
diff --git a/ChangeLog.pre-1-4 b/ChangeLog.pre-1-4
index 8b06b7a0..44d71298 100644
--- a/ChangeLog.pre-1-4
+++ b/ChangeLog.pre-1-4
@@ -1,3 +1,9 @@
+2003-09-12 Matthias Clasen <maclas@gmx.de>
+
+ * pango/pango-context.c (pango_context_set_font_map)
+ (pango_context_new): Document these funcions as backends-only, and
+ explain how to obtain initialized contexts. (#121881, Martin Pool)
+
Tue Sep 9 12:17:07 2003 Owen Taylor <otaylor@redhat.com>
* tools/Makefile.am (EXTRA_DIST): Remove reference
diff --git a/ChangeLog.pre-1-6 b/ChangeLog.pre-1-6
index 8b06b7a0..44d71298 100644
--- a/ChangeLog.pre-1-6
+++ b/ChangeLog.pre-1-6
@@ -1,3 +1,9 @@
+2003-09-12 Matthias Clasen <maclas@gmx.de>
+
+ * pango/pango-context.c (pango_context_set_font_map)
+ (pango_context_new): Document these funcions as backends-only, and
+ explain how to obtain initialized contexts. (#121881, Martin Pool)
+
Tue Sep 9 12:17:07 2003 Owen Taylor <otaylor@redhat.com>
* tools/Makefile.am (EXTRA_DIST): Remove reference
diff --git a/ChangeLog.pre-1-8 b/ChangeLog.pre-1-8
index 8b06b7a0..44d71298 100644
--- a/ChangeLog.pre-1-8
+++ b/ChangeLog.pre-1-8
@@ -1,3 +1,9 @@
+2003-09-12 Matthias Clasen <maclas@gmx.de>
+
+ * pango/pango-context.c (pango_context_set_font_map)
+ (pango_context_new): Document these funcions as backends-only, and
+ explain how to obtain initialized contexts. (#121881, Martin Pool)
+
Tue Sep 9 12:17:07 2003 Owen Taylor <otaylor@redhat.com>
* tools/Makefile.am (EXTRA_DIST): Remove reference
diff --git a/pango/pango-context.c b/pango/pango-context.c
index ce11daa4..5c19adb9 100644
--- a/pango/pango-context.c
+++ b/pango/pango-context.c
@@ -135,6 +135,18 @@ pango_context_finalize (GObject *object)
* pango_context_new:
*
* Creates a new #PangoContext initialized to default value.
+ *
+ * This function is only useful when implementing a new backend
+ * for Pango, something applications won't do. You should use
+ * the context creation function for the backend you are using,
+ * for example, pango_xft_get_context(), pango_win32_get_context()
+ * or, pango_ft2_font_map_create_context().
+ *
+ * If you are using Pango as part of a higher-level system,
+ * that system may have it's own ways of create a #PangoContext.
+ * For instance, the GTK+ toolkit has, among others,
+ * gdk_pango_context_get_for_screen(), and
+ * gtk_widget_get_pango_context().
*
* Return value: the new #PangoContext
**/
@@ -154,6 +166,8 @@ pango_context_new (void)
* @font_map: the #PangoFontMap to set.
*
* Sets the font map to be searched when fonts are looked-up in this context.
+ * This is only for internal use by Pango backends, a #PangoContext obtained
+ * via one of the recommended methods should already have a suitable font map.
**/
void
pango_context_set_font_map (PangoContext *context,