2008-09-04 Reinout van Schouwen <reinouts@gnome.org>

* 2008-09-04  Reinout van Schouwen <reinouts@gnome.org>

	- C/epiphany.xml: Update documentation to reflect topic chooser. 
	  Fixes bug #448613.


svn path=/branches/gnome-2-24/; revision=8454

1 files changed, 23 insertions, 7 deletions

diff --git a/help/C/epiphany.xml b/help/C/epiphany.xml
index 988b9f7be..b8de0de73 100644
--- a/help/C/epiphany.xml
+++ b/help/C/epiphany.xml
@@ -1047,14 +1047,25 @@ GNOME -> GNOME developers home page</programlisting>
 			topic. The topics will appear as submenus in the <guimenu>Bookmarks
 			</guimenu> menu.
 		  </para>
+                  <para>
+                        Alternatively, you can create a new topic on-the-fly when you add a 
+                        bookmark. See section <xref linkend="to-add-bookmark-to-topic"/>.
+                  </para>
 		</sect2>
 	<sect2 id="to-add-bookmark-to-topic">
 		  <title>To Add a Bookmark to a Topic</title>
 		  <para>
-			To add a bookmark to a topic, choose <guimenuitem>Properties
-			</guimenuitem> from the bookmarks context menu in the bookmarks 
-			window. From the <guilabel>Topics</guilabel> list, select each 
-			topic to add this bookmark to, and press <guibutton>Close</guibutton>.
+			To add a bookmark to a topic, choose <guimenuitem>Properties</guimenuitem> 
+                        from the bookmarks context menu in the bookmarks window. Type each topic you
+                        want to add this bookmark to in the <guilabel>Topics</guilabel> entry.
+                        You can create a new topic on-the-fly by typing its name and selecting 
+                        <guilabel>Create topic “(name)”</guilabel> from the autocompletion menu.</para>
+                  <para>
+                        Alternatively, you may click the <guilabel>Show all Topics</guilabel> expander
+                        arrow to show all currently available topics. The list of topics is sorted by
+                        relevance, with the most relevant topics on top. Choose the topic(s) to add
+                        this bookmark to simply by selecting them. Press <guibutton>Close</guibutton>
+                        when you have finished.
 		  </para>
 		</sect2>
 	<sect2 id="to-remove-bookmark-from-topic">
@@ -1062,9 +1073,14 @@ GNOME -> GNOME developers home page</programlisting>
 		  <para>
 			To remove a bookmark from a topic, choose <guimenuitem>Properties
 			</guimenuitem> from the bookmarks context menu in the bookmarks 
-			window. From the 
-			<guilabel>Topics</guilabel> list, remove each topic from which you 
-			wish to remove this bookmark, then press <guibutton>Close</guibutton>.
+			window. By editing the <guilabel>Topics</guilabel> entry,
+                        remove each topic from which you wish to remove this bookmark.</para>
+                  <para>
+                        Alternatively, you may click the <guilabel>Show all Topics</guilabel> expander
+                        arrow to review all currently selected topics. The list of topics is sorted 
+                        so that the currently selected topics come first.
+                        Choose each topic from which you wish to remove this bookmark, simply by
+                        selecting it, and press <guibutton>Close</guibutton> when you have finished.
 		  </para>
 		</sect2>
 	<sect2 id="to-rename-bookmark-or-topic">