Docs: update search documentation for Tantivy backend

- configuration.md: add PAPERLESS_SEARCH_LANGUAGE and
  PAPERLESS_ADVANCED_FUZZY_SEARCH_THRESHOLD settings
- usage.md: replace Whoosh query language link with Tantivy; remove
  "inexact terms are slow" note; add full natural date keyword list;
  add fuzzy search note
- api.md: update autocomplete ordering description (alphabetical, not Tf/Idf)
- administration.md: deprecate `optimize` subcommand (now a no-op);
  add one-time reindex upgrade note

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Trenton H
2026-03-30 13:19:27 -07:00
parent 7f63259f41
commit b626f5602c
4 changed files with 50 additions and 15 deletions
+19 -9
View File
@@ -839,18 +839,28 @@ Matching inexact words:
produ*name
```
!!! note
Matching natural date keywords:
Inexact terms are hard for search indexes. These queries might take a
while to execute. That's why paperless offers auto complete and query
correction.
```
added:today
modified:yesterday
created:this_week
added:last_month
modified:this_year
```
Supported date keywords: `today`, `yesterday`, `this_week`, `last_week`,
`this_month`, `last_month`, `this_year`, `last_year`.
All of these constructs can be combined as you see fit. If you want to
learn more about the query language used by paperless, paperless uses
Whoosh's default query language. Head over to [Whoosh query
language](https://whoosh.readthedocs.io/en/latest/querylang.html). For
details on what date parsing utilities are available, see [Date
parsing](https://whoosh.readthedocs.io/en/latest/dates.html#parsing-date-queries).
learn more about the query language used by paperless, see the
[Tantivy query language documentation](https://docs.rs/tantivy/latest/tantivy/query/struct.QueryParser.html).
!!! note
Fuzzy (approximate) matching can be enabled by setting
[`PAPERLESS_ADVANCED_FUZZY_SEARCH_THRESHOLD`](configuration.md#PAPERLESS_ADVANCED_FUZZY_SEARCH_THRESHOLD).
When enabled, paperless will include near-miss results ranked below exact matches.
## Keyboard shortcuts / hotkeys