Index: core.php
===================================================================
RCS file: /cvs/drupal/contributions/docs/developer/hooks/Attic/core.php,v
retrieving revision 1.168.2.49
diff -u -p -r1.168.2.49 core.php
--- core.php	30 Mar 2009 09:52:32 -0000	1.168.2.49
+++ core.php	31 Mar 2009 06:05:29 -0000
@@ -1452,6 +1452,8 @@ function hook_ping($name = '', $url = ''
  *
  * @param $op
  *   A string defining which operation to perform:
+ *   - 'admin': The hook should return a form array, containing any fieldsets
+ *     the module wants to add to the Search settings page at admin/settings/search.
  *   - 'name': the hook should return a translated name defining the type of
  *     items that are searched for with this module ('content', 'users', ...)
  *   - 'reset': the search index is going to be rebuilt. Modules which use
@@ -1467,21 +1469,21 @@ function hook_ping($name = '', $url = ''
  *   The search keywords as entered by the user.
  *
  * @return
- *   An array of search results.
- *   Each item in the result set array may contain whatever information
- *   the module wishes to display as a search result.
- *   To use the default search result display, each item should be an
- *   array which can have the following keys:
- *   - link: the URL of the found item
- *   - type: the type of item
- *   - title: the name of the item
- *   - user: the author of the item
- *   - date: a timestamp when the item was last modified
- *   - extra: an array of optional extra information items
- *   - snippet: an excerpt or preview to show with the result
- *     (can be generated with search_excerpt())
- *   Only 'link' and 'title' are required, but it is advised to fill in
- *   as many of these fields as possible.
+ *   This varies depending on the operation.
+ *   - 'admin': The form array for the Search settings page at admin/settings/search.
+ *   - 'name': The translated string of 'Content'.
+ *   - 'reset': None.
+ *   - 'search': An array of search results. To use the default search result display, each item should have the following keys':
+ *     - 'link (required)': the URL of the found item
+ *     - 'type': the type of item
+ *     - 'title (required)': the name of the item
+ *     - 'user': the author of the item
+ *     - 'date': a timestamp when the item was last modified
+ *     - 'extra': an array of optional extra information items
+ *     - 'snippet': an excerpt or preview to show with the result (can be generated with search_excerpt())
+ *   - 'status': An associative array with the key-value pairs:
+ *     - 'remaining': The number of items left to index.
+ *     - 'total': The total number of items to index.
  *
  * The example given here is for node.module, which uses the indexed search
  * capabilities. To do this, node module also implements hook_update_index()