@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 the "field present" and "field absent" operators in Ferret
Summary: Ref T13509. Adds documentation for the new operators.
Test Plan: Read documentation, tried examples, got sensible-seeming results.
Maniphest Tasks: T13509
Differential Revision: https://secure.phabricator.com/D21112
+10
-1
+10
-1
src/docs/user/userguide/search.diviner
+10
-1
src/docs/user/userguide/search.diviner
···
140
140
- Quoted terms with `"platypus attorney"`.
141
141
- Matching entire fields with `=platypus`.
142
142
- Combining features with `title:~"platypus attorney"`.
143
+
- Testing a field for presence (`title:~`) or absence (`title:-`).
143
144
144
145
See below for more detail.
145
146
···
169
170
- `title:...` searches titles.
170
171
- `body:...` searches bodies (descriptions or summaries).
171
172
- `core:...` searches titles and bodies, but not comments.
172
-
- `comments:...` searches only comments.
173
+
- `comment:...` searches only comments.
173
174
174
175
**Filtering Matches**: You can remove documents which match certain terms from
175
176
the result set with `-`. For example: `platypus -mammal`. Documents which match
···
182
183
requires that the entire field match the query exactly, so //only// documents
183
184
exactly titled "Warp Drive" will be matched by the query (but note that the
184
185
query is still case insensitive).
186
+
187
+
**Present and Absent Fields**: To find objects with //any// value in a
188
+
particular field, use `field:~` as a search term (with no additional text). For
189
+
example, searching Maniphest for `comment:~` will find tasks with any comments.
190
+
191
+
If you want to find objects that are //missing// a particular field, use
192
+
`field:-` with no additional argument. For example, searching Maniphest for
193
+
`body:-` will find tasks with no description.