From e28adbacc73f8dfff98bce45821374e31b7a0f8e Mon Sep 17 00:00:00 2001
From: Federico Mena Quintero <federico@ximian.com>
Date: Thu, 29 Apr 2004 21:13:12 +0000
Subject: Added an .gtkrc-2.0 example of how to actually change the key
 bindings.

2004-04-29  Federico Mena Quintero  <federico@ximian.com>

	* gtk/tmpl/gtkfilechooser.sgml: Added an .gtkrc-2.0 example of how
	to actually change the key bindings.
---
 docs/reference/ChangeLog                          |  5 ++
 docs/reference/gtk/tmpl/gtkfilechooser.sgml       | 62 +++++++++++++++++++++++
 docs/reference/gtk/tmpl/gtkfilechooserdialog.sgml |  3 +-
 3 files changed, 69 insertions(+), 1 deletion(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index e57060321..4fa9a4822 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,8 @@
+2004-04-29  Federico Mena Quintero  <federico@ximian.com>
+
+	* gtk/tmpl/gtkfilechooser.sgml: Added an .gtkrc-2.0 example of how
+	to actually change the key bindings.
+
 2004-04-23  Matthias Clasen  <mclasen@redhat.com>
 
 	* gtk/tmpl/gtkdialog.sgml: 
diff --git a/docs/reference/gtk/tmpl/gtkfilechooser.sgml b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
index f8a003f9c..177e91aea 100644
--- a/docs/reference/gtk/tmpl/gtkfilechooser.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
@@ -157,6 +157,68 @@ update_preview_cb (GtkFileChooser *file_chooser, gpointer data)
 	describes the available key binding signals.
       </para>
 
+      <example id="gtkfilechooser-key-binding-example">
+	<title>GtkFileChooser key binding example</title>
+
+	<para>
+	  The default keys that activate the key-binding signals in
+	  <classname>GtkFileChooserDefaultClass</classname> are as
+	  follows:
+	</para>
+
+	<informaltable>
+	  <tgroup cols="2">
+	    <tbody>
+	      <row>
+		<entry>Signal name</entry>
+		<entry>Key</entry>
+	      </row>
+	      <row>
+		<entry>location-popup</entry>
+		<entry><keycombo><keycap>Control</keycap><keycap>L</keycap></keycombo></entry>
+	      </row>
+	      <row>
+		<entry>up-folder</entry>
+		<entry><keycombo><keycap>Alt</keycap><keycap>Up</keycap></keycombo></entry>
+	      </row>
+	      <row>
+		<entry>down-folder</entry>
+		<entry><keycombo><keycap>Alt</keycap><keycap>Down</keycap></keycombo></entry>
+	      </row>
+	      <row>
+		<entry>home-folder</entry>
+		<entry><keycombo><keycap>Alt</keycap><keycap>Home</keycap></keycombo></entry>
+	      </row>
+	    </tbody>
+	  </tgroup>
+	</informaltable>
+
+	<para>
+	  To change these defaults to something else, you could
+	  include the following fragment in your
+	  <filename>.gtkrc-2.0</filename> file:
+	</para>
+
+	<programlisting>
+binding "my-own-gtkfilechooser-bindings" {
+	bind "&lt;Alt&gt;&lt;Shift&gt;l" {
+		"location-popup" ()
+	}
+	bind "&lt;Alt&gt;&lt;Shift&gt;Up" {
+		"up-folder" ()
+	}
+	bind "&lt;Alt&gt;&lt;Shift&gt;Down" {
+		"down-folder" ()
+	}
+	bind "&lt;Alt&gt;&lt;Shift&gt;Home" {
+		"home-folder-folder" ()
+	}
+}
+
+class "GtkFileChooserDefault" binding "my-own-gtkfilechooser-bindings"
+	</programlisting>
+      </example>
+
       <refsect3 id="GtkFileChooserDefault-location-popup">
 	<title>The &quot;GtkFileChooserDefault::location-popup&quot; signal</title>
 
diff --git a/docs/reference/gtk/tmpl/gtkfilechooserdialog.sgml b/docs/reference/gtk/tmpl/gtkfilechooserdialog.sgml
index 0fd748a7b..dac3203e9 100644
--- a/docs/reference/gtk/tmpl/gtkfilechooserdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooserdialog.sgml
@@ -130,7 +130,6 @@ dialog = gtk_file_chooser_dialog_new ("Open File",
 @Returns: 
 
 
-
 <!-- ##### FUNCTION gtk_file_chooser_dialog_new_with_backend ##### -->
 <para>
 
@@ -151,3 +150,5 @@ mode: sgml
 sgml-parent-document: ("../gtk-docs.sgml" "book" "refsect1")
 End:
 -->
+
+
-- 
cgit v1.2.1