[gtk+] Try to make the docs build again

[Matthias Clasen <matthiasc src gnome org>]

commit f7e927b93c83b3e1b8956a490f67a8820923db52
Author: Matthias Clasen <mclasen redhat com>
Date:   Fri Jul 22 21:54:08 2011 -0400

    Try to make the docs build again
    
    After some searching, it turns out that gtk-doc now interprets
    markdown, and can no longer accept '-' in the docs without making
    a mess. I hope that this does not affect more places in more
    subtle ways.

 gtk/gtkfilechooserdialog.c |   55 +++++++++++++++----------------------------
 1 files changed, 19 insertions(+), 36 deletions(-)
---
diff --git a/gtk/gtkfilechooserdialog.c b/gtk/gtkfilechooserdialog.c
index 6e7cdc1..de61afd 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>