document new api

svn path=/trunk/; revision=17931
This commit is contained in:
Matthias Clasen 2007-05-26 18:56:07 +00:00
parent f4174cfb2a
commit 8667f45fd7
2 changed files with 14 additions and 11 deletions

View File

@ -1,5 +1,6 @@
2007-05-26 Matthias Clasen <mclasen@redhat.com> 2007-05-26 Matthias Clasen <mclasen@redhat.com>
* gtk/gtkpapersize.c:
* gtk/gtkpagesetup.c: * gtk/gtkpagesetup.c:
* gtk/gtknotebook.c: * gtk/gtknotebook.c:
* gtk/gtkentrycompletion.c: Document new api * gtk/gtkentrycompletion.c: Document new api

View File

@ -795,8 +795,10 @@ gtk_paper_size_get_default_right_margin (GtkPaperSize *size,
* @error: return location for an error, or %NULL * @error: return location for an error, or %NULL
* *
* Reads a paper size from the group @group_name in the key file * Reads a paper size from the group @group_name in the key file
* @key_file. Returns a new #GtkPaperSize object with the restored * @key_file.
* paper size, or %NULL if an error occurred. *
* Returns: a new #GtkPaperSize object with the restored
* paper size, or %NULL if an error occurred.
* *
* Since: 2.12 * Since: 2.12
*/ */
@ -877,27 +879,27 @@ out:
/** /**
* gtk_paper_size_to_key_file: * gtk_paper_size_to_key_file:
* @paper_size: a #GtkPaperSize * @size: a #GtkPaperSize
* @key_file: the #GKeyFile to save the paper size to * @key_file: the #GKeyFile to save the paper size to
* @group_name: the group to add the settings to in @key_file * @group_name: the group to add the settings to in @key_file
* *
* This function adds the paper size from @paper_size to @key_file. * This function adds the paper size from @size to @key_file.
* *
* Since: 2.12 * Since: 2.12
*/ */
void void
gtk_paper_size_to_key_file (GtkPaperSize *paper_size, gtk_paper_size_to_key_file (GtkPaperSize *size,
GKeyFile *key_file, GKeyFile *key_file,
const gchar *group_name) const gchar *group_name)
{ {
const char *name, *ppd_name, *display_name; const char *name, *ppd_name, *display_name;
g_return_if_fail (paper_size != NULL); g_return_if_fail (size != NULL);
g_return_if_fail (key_file != NULL); g_return_if_fail (key_file != NULL);
name = gtk_paper_size_get_name (paper_size); name = gtk_paper_size_get_name (size);
display_name = gtk_paper_size_get_display_name (paper_size); display_name = gtk_paper_size_get_display_name (size);
ppd_name = gtk_paper_size_get_ppd_name (paper_size); ppd_name = gtk_paper_size_get_ppd_name (size);
if (ppd_name != NULL) if (ppd_name != NULL)
g_key_file_set_string (key_file, group_name, g_key_file_set_string (key_file, group_name,
@ -911,9 +913,9 @@ gtk_paper_size_to_key_file (GtkPaperSize *paper_size,
"DisplayName", display_name); "DisplayName", display_name);
g_key_file_set_double (key_file, group_name, g_key_file_set_double (key_file, group_name,
"Width", gtk_paper_size_get_width (paper_size, GTK_UNIT_MM)); "Width", gtk_paper_size_get_width (size, GTK_UNIT_MM));
g_key_file_set_double (key_file, group_name, g_key_file_set_double (key_file, group_name,
"Height", gtk_paper_size_get_height (paper_size, GTK_UNIT_MM)); "Height", gtk_paper_size_get_height (size, GTK_UNIT_MM));
} }