Mercurial > p > roundup > code

changeset 3038:6fbc8633a4c8 maint-0.7

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
merge from HEAD
author Richard Jones <richard@users.sourceforge.net>
date Mon, 03 Jan 2005 23:02:27 +0000
parents 94053f8666c6
children 72399c7c9bcc
files CHANGES.txt doc/customizing.txt doc/user_guide.txt
diffstat 3 files changed, 60 insertions(+), 39 deletions(-) [+]
line wrap: on
line diff
--- a/CHANGES.txt	Mon Jan 03 03:24:48 2005 +0000
+++ b/CHANGES.txt	Mon Jan 03 23:02:27 2005 +0000
@@ -13,6 +13,7 @@
 - don't set the title to nothing from incoming mail (thanks Bruce Guenter)
 - fix py2.4 strftime() API change bug (sf bug 1087746)
 - fix indexer searching with no valid words (sf bug 1086787)
+- updated searching / indexing docs
 
 
 2004-10-26 0.7.9
--- a/doc/customizing.txt	Mon Jan 03 03:24:48 2005 +0000
+++ b/doc/customizing.txt	Mon Jan 03 23:02:27 2005 +0000
@@ -2098,12 +2098,12 @@
 An index view specifier (URL fragment) looks like this (whitespace has
 been added for clarity)::
 
-     /issue?status=unread,in-progress,resolved&
-            topic=security,ui&
-            :group=+priority&
-            :sort==activity&
-            :filters=status,topic&
-            :columns=title,status,fixer
+    /issue?status=unread,in-progress,resolved&
+        topic=security,ui&
+        @group=priority&
+        @sort=-activity&
+        @filters=status,topic&
+        @columns=title,status,fixer
 
 The index view is determined by two parts of the specifier: the layout
 part and the filter part. The layout part consists of the query
@@ -2128,11 +2128,29 @@
 "topic" properties, and the table includes columns for the "title",
 "status", and "fixer" properties.
 
+============ =============================================================
+Argument     Description
+============ =============================================================
+@sort        sort by prop name, optionally preceeded with '-' to give
+             descending or nothing for ascending sorting.
+@group       group by prop name, optionally preceeded with '-' or to sort
+             in descending or nothing for ascending order.
+@columns     selects the columns that should be displayed. Default is
+             all.                     
+@filter      indicates which properties are being used in filtering.
+             Default is none.
+propname     selects the values the item properties given by propname must
+             have (very basic search/filter).
+@search_text if supplied, performs a full-text search (message bodies,
+             issue titles, etc)
+============ =============================================================
+
+
 Searching Views
 ---------------
 
 .. note::
-   If you add a new column to the ``:columns`` form variable
+   If you add a new column to the ``@columns`` form variable
    potentials then you will need to add the column to the appropriate
    `index views`_ template so that it is actually displayed.
 
@@ -2142,8 +2160,8 @@
 
 - sets up additional filtering, as well as performing indexed text
   searching
-- sets the ``:filter`` variable correctly
-- saves the query off if ``:query_name`` is set.
+- sets the ``@filter`` variable correctly
+- saves the query off if ``@query_name`` is set.
 
 The search page should lay out any fields that you wish to allow the
 user to search on. If your schema contains a large number of properties,
@@ -2153,18 +2171,18 @@
 searchable using the full text indexed search. This is both faster, and
 more useful for the end user.
 
-The two special form values on search pages which are handled by the
-"search" action are:
-
-:search_text
-  Text with which to perform a search of the text index. Results from
-  that search will be used to limit the results of other filters (using
-  an intersection operation)
-:query_name
-  If supplied, the search parameters (including :search_text) will be
-  saved off as a the query item and registered against the user's
-  queries property. The *classic* template schema has this ability, but
-  the *minimal* template schema does not.
+If the search view does specify the "search" ``@action``, then it may also
+provide an additional argument:
+
+============ =============================================================
+Argument     Description
+============ =============================================================
+@query_name  if supplied, the index parameters (including @search_text)
+             will be saved off as a the query item and registered against
+             the user's queries property. Note that the *classic* template
+             schema has this ability, but the *minimal* template schema
+             does not.
+============ =============================================================
 
 
 Item Views
--- a/doc/user_guide.txt	Mon Jan 03 03:24:48 2005 +0000
+++ b/doc/user_guide.txt	Mon Jan 03 23:02:27 2005 +0000
@@ -309,30 +309,32 @@
 The searching page converts your selections into the following
 arguments:
 
-========== =============================================================
-Argument   Description
-========== =============================================================
-:sort      sort by prop name, optionally preceeded with '-' to give
-           descending or nothing for ascending sorting.
-:group     group by prop name, optionally preceeded with '-' or to sort
-           in descending or nothing for ascending order.
-:filter    selects which props should be displayed in the filter
-           section. Default is all.           
-:columns   selects the columns that should be displayed. Default is
-           all.                     
-propname   selects the values the item properties given by propname must
-           have (very basic search/filter).
-========== =============================================================
+============ =============================================================
+Argument     Description
+============ =============================================================
+@sort        sort by prop name, optionally preceeded with '-' to give
+             descending or nothing for ascending sorting.
+@group       group by prop name, optionally preceeded with '-' or to sort
+             in descending or nothing for ascending order.
+@columns     selects the columns that should be displayed. Default is
+             all.                     
+@filter      indicates which properties are being used in filtering.
+             Default is none.
+propname     selects the values the item properties given by propname must
+             have (very basic search/filter).
+@search_text performs a full-text search (message bodies, issue titles,
+             etc)
+============ =============================================================
 
 You may manually write URLS that contain these arguments, like so
 (whitespace has been added for clarity)::
 
     /issue?status=unread,in-progress,resolved&
         topic=security,ui&
-        :group=priority&
-        :sort=-activity&
-        :filters=status,topic&
-        :columns=title,status,fixer
+        @group=priority&
+        @sort=-activity&
+        @filters=status,topic&
+        @columns=title,status,fixer
 
 
 Access Controls
Roundup Issue Tracker: http://roundup-tracker.org/