AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity

Try to make the docs build again

Browse Source 
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.
This commit is contained in:
Matthias Clasen 2011-07-22 21:54:08 -04:00
parent b555a979a4
commit f7e927b93c
1 changed files with 19 additions and 36 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
gtk/gtkfilechooserdialog.c
View File

@ -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>