Add a paragraph about shortcut terminology. (#166906, Sebastien Bacher)

2005-04-07  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkfilechooser.sgml: Add a paragraph about
	shortcut terminology.  (#166906, Sebastien Bacher)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index f58d68a525ac99a9fa25bb36bcaa2b48782e1a58..5f5b083cdb2ffdf52c0d57a766ff4a6618722d00 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,8 @@
 2005-04-07  Matthias Clasen  <mclasen@redhat.com>
 
+       * gtk/tmpl/gtkfilechooser.sgml: Add a paragraph about
+       shortcut terminology.  (#166906, Sebastien Bacher)
+
        * gtk/tmpl/gtkenums.sgml: Make the docs of GKT_SELECTION_MULTIPLE
        more accurate by making them more vague.  (#167088,
        Ken Siersma)

diff --git a/docs/reference/gtk/tmpl/gtkfilechooser.sgml b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
index 1602106a302a26f5b725955d1b2b2631b248a9f5..1be33e7e0482728588aa8beb28d623473d9d711c 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkfilechooser.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
@@ -15,6 +15,39 @@ File chooser interface used by GtkFileChooserWidget and GtkFileChooserDialog
       interface.
     </para>
 
+    <para>
+      #GtkFileChooser allows for shortcuts to various places in the filesystem.
+      In the default implementation these are displayed in the left pane. It
+      may be a bit confusing at first taht these shortcuts come from various 
+      sources and in various flavours, so lets explain the terminology here:
+    </para>
+      <variablelist>
+         <varlistentry>
+           <term>Bookmarks</term>
+           <listitem><para>
+             are created by the user, by dragging folders from the 
+             right pane to the left pane, or by using the "Add". Bookmarks
+             can be renamed and deleted by the user.
+           </para></listitem>
+         </varlistentry>
+         <varlistentry>
+           <term>Shortcuts</term>
+           <listitem><para> 
+             can be provided by the application or by the underlying filesystem
+             abstraction (e.g. both the gnome-vfs and the Windows filesystems 
+             provide "Desktop" shortcuts). Shortcuts cannot be modified by the 
+             user.
+           </para></listitem>
+         </varlistentry>
+         <varlistentry> 
+           <term>Volumes</term>
+           <listitem><para>
+             are provided by the underlying filesystem abstraction. They are
+             the "roots" of the filesystem. 
+           </para></listitem>
+         </varlistentry>
+      </variablelist>
+
     <refsect2 id="gtkfilechooser-encodings">
       <title>File Names and Encodings</title>