Index: core.php
===================================================================
RCS file: /cvs/drupal-contrib/contributions/docs/developer/hooks/core.php,v
retrieving revision 1.125.2.19
diff -u -r1.125.2.19 core.php
--- core.php	8 Oct 2008 17:32:24 -0000	1.125.2.19
+++ core.php	10 Oct 2008 10:39:22 -0000
@@ -1607,5 +1607,33 @@
 }
 
 /**
+ * Format the result page of a search query in a theme-independent way.
+ *
+ * Modules may implement this hook in order to override the default function
+ * theme_search_page() to display search results. In that case, it is expected
+ * they provide the rendering, because theme_search_page() will not be applied
+ * for the search type if an implementation of this hook exists for the same
+ * type.
+ *
+ * @see theme_search_page()
+ *
+ * @param $results
+ *   An array of results
+ * @return
+ *   An HTML string repres
+ */
+function hook_search_page($results) {
+  $output = '<dl class="search-results">';
+
+  foreach ($results as $entry) {
+    $output .= theme('search_item', $entry, $type);
+  }
+  $output .= '</dl>';
+  $output .= theme('pager', NULL, 10, 0);
+
+  return $output;
+}
+
+/**
  * @} End of "addtogroup hooks".
  */