@recaptime-dev's working patches + fork for Phorge, a community fork of Phabricator. (Upstream dev and stable branches are at upstream/main and upstream/stable respectively.)
hq.recaptime.dev/wiki/Phorge
phorge
phabricator
Document Ferret engine fulltext search features
Summary: Ref T12819. Adds some documentation for `-term`, `~term`, `title:term`, etc.
Test Plan: Read documentation.
Reviewers: chad
Reviewed By: chad
Maniphest Tasks: T12819
Differential Revision: https://secure.phabricator.com/D18592
+50
+50
src/docs/user/userguide/search.diviner
+50
src/docs/user/userguide/search.diviner
···
123
123
typed your own username when you run the query. However, if you send the query
124
124
to someone else, it will show results for //their// username when they run it.
125
125
This can be particularly useful when creating dashboard panels.
126
+
127
+
128
+
Fulltext Search
129
+
===============
130
+
131
+
Global search and some applications provide **fulltext search**. In
132
+
applications, this is a field called {nav Query}.
133
+
134
+
Fulltext search allows you to search the text content of objects and supports
135
+
some special syntax. These features are supported:
136
+
137
+
- Substring search with `~platypus`.
138
+
- Field search with `title:platypus`.
139
+
- Filtering out matches with `-platypus`.
140
+
- Quoted terms with `"platypus attorney"`.
141
+
- Combining features with `title:~"platypus attorney"`.
142
+
143
+
See below for more detail.
144
+
145
+
**Substrings**: Normally, query terms are searched for as words, so searching
146
+
for `read` won't find documents which only contain the word `threaded`, even
147
+
though "read" is a substring of "threaded". With the substring operator, `~`,
148
+
you can search for substrings instead: the query `~read` will match documents
149
+
which contain that text anywhere, even in the middle of a word.
150
+
151
+
**Quoted Terms**: When you search for multiple terms, documents which match
152
+
each term will be returned, even if the terms are not adjacent in the document.
153
+
For example, the query `void star` will match a document titled `A star in the
154
+
void`, because it matches both `void` and `star`. To search for an exact
155
+
sequence of terms, quote them: `"void star"`. This query will only match
156
+
documents which use those terms as written.
157
+
158
+
**Stemming**: Searching for a term like `rearming` will find documents which
159
+
contain variations of the word, like `rearm`, `rearms`, and `rearmed`. To
160
+
search for an an exact word, quote the term: `"rearming"`.
161
+
162
+
**Field Search**: By default, query terms are searched for in the title, body,
163
+
and comments. If you only want to search for a term in titles, use `title:`.
164
+
For example, `title:platypus` only finds documents with that term in the
165
+
title. This can be combined with other operators, for example `title:~platypus`
166
+
or `title:"platypus attorney"`. These scopes are also supported:
167
+
168
+
- `title:...` searches titles.
169
+
- `body:...` searches bodies (descriptions or summaries).
170
+
- `core:...` searches titles and bodies, but not comments.
171
+
- `comments:...` searches only comments.
172
+
173
+
**Filtering Matches**: You can remove documents which match certain terms from
174
+
the result set with `-`. For example: `platypus -mammal`. Documents which match
175
+
negated terms will be filtered out of the result set.