Changes between Version 1 and Version 2 of Trac Search

Timestamp:

Jul 4, 2008, 2:09:43 PM (16 years ago)

Author:

trac

Comment:

--

Trac Search

@@ -1 +1 @@
 = Using Search =
 
-Trac has a built-in search engine to allow finding occurrances of keywords and substrings in wiki pages, tickets and changeset descriptions.
+Trac has a built-in search engine to allow finding occurrences of keywords and substrings in wiki pages, tickets and changeset descriptions.
 
-Using the Trac search facility is straightforward and its interface should be familiar to most www users.
+Using the Trac search facility is straightforward and its interface should be familiar to most users.
 
-Apart from the [search: Search module], you will also find a small search field above the navigation bar at all time. There is no 
+Apart from the [search: Search module], you will also find a small search field above the navigation bar at all time. It provides convenient access to the search module from all pages.
 
-== Quickjumps ==
-However, for intermediate and advanced use, Trac has a useful way to quickly navigate to a given module and information item, called '''quickjumps'''.
+== "Quickjump" searches ==
+For quick access to various project resources, the quick-search field at the top of every page can be used to enter a [TracLinks wiki link], which will take you directly to the resource identified by that link.
 
-If you enter a [wiki:TracLinks TracLink] in the search field above the navigation bar, Trac will recognize this and assume you know where you're going. 
+For example:
 
-'''Note:''' ''This is a particularly useful feature to quickly navigate to a specific issue ticket or changeset.''
+ * ![42] -- Opens change set 42
+ * !#42 -- Opens ticket number 42
+ * !{1} -- Opens report 1
+ * /trunk -- Opens the browser for the `trunk` directory
 
-=== Advanced: Disabling quickjumps ===
-To disable the quickjump feature in a search - to for example search for all occurences of !TracGuide - begin the query with an exclamation mark (!).
+== Advanced ==
+
+=== Disabling Quickjumps ===
+To disable the quickjump feature for a search keyword - for example when searching for occurences of the literal word !TracGuide - begin the query with an exclamation mark (!).
+
+=== Search Links ===
+From the Wiki, it is possible to link to a specific search, using
+`search:` links:
+ * `search:?q=crash` will search for the string "crash" 
+ * `search:?q=trac+link&wiki=on` will search for "trac" and "link" 
+   in wiki pages only
 
 ----
-See also: TracGuide, TracLinks
+See also: TracGuide, TracLinks, TracQuery