Refactor the EShell search API.

Move the search interface to a new widget: EShellSearchbar

The current search rule is now stored in EShellView, and the search
context in EShellViewClass similar to GalViewCollection (since it's
class-specific, not instance-specific).

Also add a couple new signals to EShellView: "clear-search" and
"custom-search" ("custom" refers to an advanced search or a saved
search -- something more complex than a quick search).

Still working out a few kinks.  The search entry is clearly trying to
be too many things.  We need a different way of indicating that you're
looking at search results.  Perhaps a search results banner similar to
Nautilus.

1 files changed, 84 insertions, 0 deletions

diff --git a/doc/reference/shell/tmpl/e-shell-view.sgml b/doc/reference/shell/tmpl/e-shell-view.sgml
index 0508608faf..03d8830fdb 100644
--- a/doc/reference/shell/tmpl/e-shell-view.sgml
+++ b/doc/reference/shell/tmpl/e-shell-view.sgml
@@ -23,6 +23,21 @@ EShellView
 </para>
 
 
+<!-- ##### SIGNAL EShellView::clear-search ##### -->
+<para>
+
+</para>
+
+@eshellview: the object which received the signal.
+
+<!-- ##### SIGNAL EShellView::custom-search ##### -->
+<para>
+
+</para>
+
+@eshellview: the object which received the signal.
+@arg1: 
+
 <!-- ##### SIGNAL EShellView::execute-search ##### -->
 <para>
 
@@ -54,6 +69,11 @@ EShellView
 
 </para>
 
+<!-- ##### ARG EShellView:search-rule ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG EShellView:shell-backend ##### -->
 <para>
 
@@ -104,6 +124,8 @@ EShellView
 @icon_name: 
 @ui_definition: 
 @ui_manager_id: 
+@search_context_type: 
+@search_context: 
 @search_options: 
 @search_rules: 
 @view_collection: 
@@ -112,6 +134,8 @@ EShellView
 @new_shell_sidebar: 
 @new_shell_taskbar: 
 @toggled: 
+@clear_search: 
+@custom_search: 
 @execute_search: 
 @update_actions: 
 
@@ -196,6 +220,33 @@ EShellView
 @page_num: 
 
 
+<!-- ##### FUNCTION e_shell_view_get_search_rule ##### -->
+<para>
+
+</para>
+
+@shell_view: 
+@Returns: 
+
+
+<!-- ##### FUNCTION e_shell_view_set_search_rule ##### -->
+<para>
+
+</para>
+
+@shell_view: 
+@search_rule: 
+
+
+<!-- ##### FUNCTION e_shell_view_get_search_query ##### -->
+<para>
+
+</para>
+
+@shell_view: 
+@Returns: 
+
+
 <!-- ##### FUNCTION e_shell_view_get_size_group ##### -->
 <para>
 
@@ -267,6 +318,23 @@ EShellView
 @shell_view: 
 
 
+<!-- ##### FUNCTION e_shell_view_clear_search ##### -->
+<para>
+
+</para>
+
+@shell_view: 
+
+
+<!-- ##### FUNCTION e_shell_view_custom_search ##### -->
+<para>
+
+</para>
+
+@shell_view: 
+@custom_rule: 
+
+
 <!-- ##### FUNCTION e_shell_view_execute_search ##### -->
 <para>
 
@@ -275,6 +343,22 @@ EShellView
 @shell_view: 
 
 
+<!-- ##### FUNCTION e_shell_view_block_execute_search ##### -->
+<para>
+
+</para>
+
+@shell_view: 
+
+
+<!-- ##### FUNCTION e_shell_view_unblock_execute_search ##### -->
+<para>
+
+</para>
+
+@shell_view: 
+
+
 <!-- ##### FUNCTION e_shell_view_update_actions ##### -->
 <para>