diff options
| author | Matthias Clasen <maclas@gmx.de> | 2003-09-11 22:30:23 +0000 |
|---|---|---|
| committer | Matthias Clasen <matthiasc@src.gnome.org> | 2003-09-11 22:30:23 +0000 |
| commit | 48254364ad24eaa6d34f4f58a2f960695a80b8d0 (patch) | |
| tree | 3495ab9117610574782d6cfb34e7ffcdfbf893ce | |
| parent | b1f542c72ac90fb38259df01304df2a0ba26aacc (diff) | |
| download | pango-48254364ad24eaa6d34f4f58a2f960695a80b8d0.tar.gz | |
Document these funcions as backends-only, and explain how to obtain
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)
| -rw-r--r-- | ChangeLog | 6 | ||||
| -rw-r--r-- | ChangeLog.pre-1-10 | 6 | ||||
| -rw-r--r-- | ChangeLog.pre-1-4 | 6 | ||||
| -rw-r--r-- | ChangeLog.pre-1-6 | 6 | ||||
| -rw-r--r-- | ChangeLog.pre-1-8 | 6 | ||||
| -rw-r--r-- | pango/pango-context.c | 14 |
6 files changed, 44 insertions, 0 deletions
@@ -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, |