filechooser: Cosmetic doc changes

This commit is contained in:
Matthias Clasen 2020-04-17 20:08:21 -04:00
parent e880abfaf3
commit d53f3a54b1
3 changed files with 12 additions and 9 deletions

View File

@ -65,7 +65,7 @@
/**
* SECTION:gtkfilechooserbutton
* @Short_description: A button to launch a file selection dialog
* @Short_description: A button to launch a file chooser dialog
* @Title: GtkFileChooserButton
* @See_also:#GtkFileChooserDialog
*

View File

@ -43,12 +43,12 @@
/**
* SECTION:gtkfilechooserdialog
* @Short_description: A file chooser dialog, suitable for File/Open or File/Save commands
* @Short_description: A file chooser dialog, suitable for File Open or File Save commands
* @Title: GtkFileChooserDialog
* @See_also: #GtkFileChooser, #GtkDialog, #GtkFileChooserNative
*
* #GtkFileChooserDialog is a dialog box suitable for use with
* File/Open or File/Save as commands. This widget works by
* File Open or File Save commands. This widget works by
* putting a #GtkFileChooserWidget inside a #GtkDialog. It exposes
* the #GtkFileChooser interface, so you can use all of the
* #GtkFileChooser functions on the file chooser dialog as well as

View File

@ -43,12 +43,12 @@
/**
* SECTION:gtkfilechoosernative
* @Short_description: A native file chooser dialog, suitable for File/Open or File/Save commands
* @Short_description: A native file chooser dialog, suitable for File Open or File Save commands
* @Title: GtkFileChooserNative
* @See_also: #GtkFileChooser, #GtkNativeDialog, #GtkFileChooserDialog
*
* #GtkFileChooserNative is an abstraction of a dialog box suitable
* for use with File/Open or File/Save as commands. By default, this
* for use with File Open or File Save as commands. By default, this
* just uses a #GtkFileChooserDialog to implement the actual dialog.
* However, on certain platforms, such as Windows and macOS, the native platform
* file chooser is used instead. When the application is running in a
@ -56,10 +56,13 @@
* #GtkFileChooserNative may call the proper APIs (portals) to let the user
* choose a file and make it available to the application.
*
* While the API of #GtkFileChooserNative closely mirrors #GtkFileChooserDialog, the main
* difference is that there is no access to any #GtkWindow or #GtkWidget for the dialog.
* This is required, as there may not be one in the case of a platform native dialog.
* Showing, hiding and running the dialog is handled by the #GtkNativeDialog functions.
* While the API of #GtkFileChooserNative closely mirrors #GtkFileChooserDialog,
* the main difference is that there is no access to any #GtkWindow or #GtkWidget
* for the dialog. This is required, as there may not be one in the case of a
* platform native dialog.
*
* Showing, hiding and running the dialog is handled by the #GtkNativeDialog
* functions.
*
* ## Typical usage ## {#gtkfilechoosernative-typical-usage}
*