diff options
author | Behdad Esfahbod <behdad@gnome.org> | 2008-08-06 08:39:01 +0000 |
---|---|---|
committer | Behdad Esfahbod <behdad@src.gnome.org> | 2008-08-06 08:39:01 +0000 |
commit | 6a84b56502ed11b4d52d7be387be4ce26c7e4c61 (patch) | |
tree | 629d4e9791a14c27ecfd4ec4cb0fcfb39c12a168 /pango/pango-context.c | |
parent | fb5d6ad85ca10e67db70575b0604894fa8c484f5 (diff) | |
download | pango-6a84b56502ed11b4d52d7be387be4ce26c7e4c61.tar.gz |
Make the following API public:
2008-08-05 Behdad Esfahbod <behdad@gnome.org>
* pango/pango-context.c:
* pango/pango-context.h:
Make the following API public:
pango_context_new()
pango_context_set_font_map()
* pango/pango-fontmap.c (pango_font_map_create_context):
* pango/pango-fontmap.h:
New public API:
pango_font_map_create_context()
* pango/pangocairo-context.c (pango_cairo_create_context):
* pango/pangocairo-font.c (_pango_cairo_font_get_metrics),
(_pango_cairo_font_private_get_hex_box_info):
* pango/pangocairo-fontmap.c (pango_cairo_font_map_create_context):
* pango/pangocairo.h:
Deprecate pango_cairo_font_map_create_context().
* pango/pangofc-font.c (pango_fc_font_get_metrics):
* pango/pangofc-fontmap.c (pango_fc_font_map_create_context):
* pango/pangofc-fontmap.h:
Deprecate pango_fc_font_map_create_context().
* pango/pangoft2-fontmap.c (pango_ft2_font_map_create_context),
(pango_ft2_get_context):
* pango/pangoft2.h:
Deprecate pango_ft2_font_map_create_context().
* pango/pangowin32.c (pango_win32_get_context),
(pango_win32_font_get_metrics):
* pango/pangowin32.h:
Deprecate pango_win32_get_context().
* pango/pangoxft-font.c (_pango_xft_font_get_mini_font):
* pango/pangoxft-fontmap.c (pango_xft_get_context):
* pango/pangoxft.h:
Deprecate pango_xft_get_context().
* pango/pangox-fontmap.c (pango_x_font_map_for_display):
* pango/pangox.c (get_context_info), (pango_x_get_context),
(pango_x_context_set_funcs), (pango_x_render_layout_line):
Deprecate pango_x_get_context(), again.
* docs/pango-sections.txt:
* docs/tmpl/fonts.sgml:
* pango-view/viewer-pangocairo.c (pangocairo_view_get_context):
* pango-view/viewer-pangoft2.c (pangoft2_view_get_context):
* pango-view/viewer-pangox.c (pangox_view_get_context):
* pango-view/viewer-pangoxft.c (pangoxft_view_get_context):
* pango/check.defs:
* pango/pango.def:
Update.
svn path=/trunk/; revision=2675
Diffstat (limited to 'pango/pango-context.c')
-rw-r--r-- | pango/pango-context.c | 15 |
1 files changed, 7 insertions, 8 deletions
diff --git a/pango/pango-context.c b/pango/pango-context.c index 35e5e71e..1aa2fee9 100644 --- a/pango/pango-context.c +++ b/pango/pango-context.c @@ -107,19 +107,18 @@ pango_context_finalize (GObject *object) /** * pango_context_new: * - * Creates a new #PangoContext initialized to default value. + * Creates a new #PangoContext initialized to default values. * - * 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_cairo_font_map_create_context(), pango_xft_get_context(), - * pango_win32_get_context() or, pango_ft2_font_map_create_context(). + * This function is not particularly useful as it should always + * be followed by a pango_context_set_font_map() call, and the + * function pango_font_map_create_context() does these two steps + * together and hence users are recommended to use that. * * If you are using Pango as part of a higher-level system, - * that system may have it's own ways of create a #PangoContext. + * that system may have it's own way of create a #PangoContext. * For instance, the GTK+ toolkit has, among others, * gdk_pango_context_get_for_screen(), and - * gtk_widget_get_pango_context(). + * gtk_widget_get_pango_context(). Use those instead. * * Return value: the newly allocated #PangoContext, which should * be freed with g_object_unref(). |