diff options
Diffstat (limited to 'gtk/gtkfilechooserdialog.c')
-rw-r--r-- | gtk/gtkfilechooserdialog.c | 55 |
1 files changed, 19 insertions, 36 deletions
diff --git a/gtk/gtkfilechooserdialog.c b/gtk/gtkfilechooserdialog.c index 6e7cdc105a..de61afdc2d 100644 --- a/gtk/gtkfilechooserdialog.c +++ b/gtk/gtkfilechooserdialog.c @@ -113,40 +113,23 @@ * <section id="gtkfilechooserdialog-setting-up"> * <title>Setting up a file chooser dialog</title> * There are various cases in which you may need to use a #GtkFileChooserDialog: - * <itemizedlist> - * <listitem> - * <para> - * To select a file for opening, as for a - * <guimenuitem>File/Open</guimenuitem> command. Use - * #GTK_FILE_CHOOSER_ACTION_OPEN. - * </para> - * </listitem> - * - * <listitem> - * <para> - * To save a file for the first time, as for a - * <guimenuitem>File/Save</guimenuitem> command. Use - * #GTK_FILE_CHOOSER_ACTION_SAVE, and suggest a name such as - * "Untitled" with gtk_file_chooser_set_current_name(). - * </para> - * </listitem> - * - * <listitem> - * <para> - * To save a file under a different name, as for a - * <guimenuitem>File/Save As</guimenuitem> command. Use - * #GTK_FILE_CHOOSER_ACTION_SAVE, and set the existing filename - * with gtk_file_chooser_set_filename(). - * </para> - * </listitem> - * - * <listitem> - * <para> - * To choose a folder instead of a file. Use - * #GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER. - * </para> - * </listitem> - * </itemizedlist> + * <itemizedlist><listitem>To select a file for opening, as for a + * <guimenuitem>File/Open</guimenuitem> command. Use + * #GTK_FILE_CHOOSER_ACTION_OPEN. + * </listitem> + * <listitem>To save a file for the first time, as for a + * <guimenuitem>File/Save</guimenuitem> command. Use + * #GTK_FILE_CHOOSER_ACTION_SAVE, and suggest a name such as + * "Untitled" with gtk_file_chooser_set_current_name(). + * </listitem> + * <listitem>To save a file under a different name, as for a + * <guimenuitem>File/Save As</guimenuitem> command. Use + * #GTK_FILE_CHOOSER_ACTION_SAVE, and set the existing filename + * with gtk_file_chooser_set_filename(). + * </listitem> + * <listitem>To choose a folder instead of a file. Use + * #GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER. + * </listitem></itemizedlist> * <note> * <para> * Old versions of the file chooser's documentation suggested @@ -156,8 +139,8 @@ * considered to be a good policy, as now the file chooser is * able to make good suggestions on its own. In general, you * should only cause the file chooser to show a specific folder - * when it is appropriate to use gtk_file_chooser_set_filename() - * - i.e. when you are doing a <guimenuitem>File/Save + * when it is appropriate to use gtk_file_chooser_set_filename(), + * i.e. when you are doing a <guimenuitem>File/Save * As</guimenuitem> command <emphasis>and</emphasis> you already * have a file saved somewhere. * </para> |