]> Pileus Git - ~andy/gtk/blobdiff - gtk/gtkfilechooserdialog.c
Try to make the docs build again
[~andy/gtk] / gtk / gtkfilechooserdialog.c
index 6e7cdc105afac0144a533376607ae76059a22095..de61afdc2d1dafdd7047cdb2128ed6bbba0331f0 100644 (file)
  * <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
  * 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>