2.9.0

[~andy/gtk] / docs / reference / gtk / tmpl / gtkfilechooser.sgml

diff --git a/docs/reference/gtk/tmpl/gtkfilechooser.sgml b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
index 93df72ab1c4a8197b8f8568499a7034c5347ca4c..3fb662fcad73678fcdf2e0cba7248327fce17d2d 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkfilechooser.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
@@ -209,8 +209,14 @@ update_preview_cb (GtkFileChooser *file_chooser, gpointer data)
              <row>
                <entry>location-popup</entry>
                <entry>
-                 <keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo>;
-                 <keycap>/</keycap>
+                 <keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo> (empty path);
+                 <keycap>/</keycap> (path of "/")<footnote>
+                   <para>
+                     Both the individual <keycap>/</keycap> key and the
+                     numeric keypad's "divide" key are supported.
+                   </para>
+                 </footnote>;
+                 <keycap>~</keycap> (path of "~")
                </entry>
              </row>
              <row>
@@ -287,10 +293,12 @@ class "GtkFileChooserDefault" binding "my-own-gtkfilechooser-bindings"
          put in the text entry for the file name.  By default this is bound to
          <keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo>
          with a <parameter>path</parameter> string of "" (the empty
-         string); it is also bound to <keycap>/</keycap> with a
+         string).  It is also bound to <keycap>/</keycap> with a
          <parameter>path</parameter> string of "<literal>/</literal>"
          (a slash):  this lets you type <keycap>/</keycap> and
-         immediately type a path name.
+         immediately type a path name.  On Unix systems, this is bound to
+         <keycap>~</keycap> (tilde) with a <parameter>path</parameter> string
+         of "~" itself for access to home directories.
        </para>
 
        <variablelist role="params">
@@ -773,14 +781,7 @@ gtk_widget_destroy (chooser);
 
 @GTK_FILE_CHOOSER_ERROR_NONEXISTENT: Indicates that a file does not exist.
 @GTK_FILE_CHOOSER_ERROR_BAD_FILENAME: Indicates a malformed filename.
-
-<!-- ##### FUNCTION gtk_file_chooser_error_quark ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
+@GTK_FILE_CHOOSER_ERROR_ALREADY_EXISTS: 
 
 <!-- ##### FUNCTION gtk_file_chooser_set_action ##### -->
 <para>
@@ -807,8 +808,6 @@ gtk_widget_destroy (chooser);
 
 @chooser: 
 @local_only: 
-<!-- # Unused Parameters # -->
-@files_only: 
 
 
 <!-- ##### FUNCTION gtk_file_chooser_get_local_only ##### -->
@@ -1092,8 +1091,6 @@ gtk_widget_destroy (chooser);
 
 @chooser: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@file_chooser: 
 
 
 <!-- ##### FUNCTION gtk_file_chooser_get_preview_uri ##### -->
@@ -1103,8 +1100,6 @@ gtk_widget_destroy (chooser);
 
 @chooser: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@file_chooser: 
 
 
 <!-- ##### FUNCTION gtk_file_chooser_set_extra_widget ##### -->
@@ -1210,8 +1205,6 @@ gtk_widget_destroy (chooser);
 @uri: 
 @error: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@folder: 
 
 
 <!-- ##### FUNCTION gtk_file_chooser_remove_shortcut_folder_uri ##### -->
@@ -1223,8 +1216,6 @@ gtk_widget_destroy (chooser);
 @uri: 
 @error: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@folder: 
 
 
 <!-- ##### FUNCTION gtk_file_chooser_list_shortcut_folder_uris ##### -->