Commit f7e927b9 authored by Matthias Clasen's avatar Matthias Clasen

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.
parent b555a979
......@@ -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>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment