From eceeb8c2a3100ec29a3a3a586b6f687c680beb1e Mon Sep 17 00:00:00 2001 From: Behdad Esfahbod Date: Tue, 31 Jan 2006 19:50:27 +0000 Subject: Improve documentation for functions allocating memory, on how the object 2006-01-31 Behdad Esfahbod * pango/fonts.c, pango/glyphstring.c pango/pango-attributes.c pango/pango-color.c, pango/pango-context.c pango/pango-coverage.c, pango/pango-fontset.c pango/pango-glyph-item.c, pango/pango-item.c pango/pango-layout.c, pango/pango-ot-buffer.c pango/pango-ot-info.c, pango/pango-ot-ruleset.c pango/pango-script.c, pango/pango-tabs.c pango/pango-utils.c pango/pangocairo-fcfontmap.c, pango/pangocairo-fontmap.c pango/pangox-fontcache.c, pango/pangoxft-render.c: Improve documentation for functions allocating memory, on how the object should be freed. --- pango/fonts.c | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) (limited to 'pango/fonts.c') diff --git a/pango/fonts.c b/pango/fonts.c index 4835a198..98d1fae1 100644 --- a/pango/fonts.c +++ b/pango/fonts.c @@ -80,8 +80,8 @@ static const PangoFontDescription pfd_defaults = { * * Creates a new font description structure with all fields unset. * - * Return value: the newly-created #PangoFontDescription. Use - * pango_font_description_free() to free the result. + * Return value: the newly allocated #PangoFontDescription, which + * should be freed using pango_font_description_free(). **/ PangoFontDescription * pango_font_description_new (void) @@ -591,8 +591,8 @@ pango_font_description_better_match (const PangoFontDescription *desc, * * Make a copy of a #PangoFontDescription. * - * Return value: a newly-allocated #PangoFontDescription. This value - * must be freed using pango_font_description_free(). + * Return value: the newly allocated #PangoFontDescription, which should + * be freed with pango_font_description_free(). **/ PangoFontDescription * pango_font_description_copy (const PangoFontDescription *desc) @@ -619,8 +619,8 @@ pango_font_description_copy (const PangoFontDescription *desc) * be used until @desc is modififed or freed. This is meant to be used * when the copy is only needed temporarily. * - * Return value: a newly-allocated #PangoFontDescription. This value - * must be freed using pango_font_description_free(). + * Return value: the newly allocated #PangoFontDescription, which should + * be freed with pango_font_description_free(). **/ PangoFontDescription * pango_font_description_copy_static (const PangoFontDescription *desc) -- cgit v1.2.1