From f7815097104ae6da9bb763d1b63df55217818445 Mon Sep 17 00:00:00 2001 From: "Danilo M." Date: Fri, 18 Sep 2026 15:54:59 +0200 Subject: docs: document contact completion and refresh Italian translation Translate the new config warning for contacts_dir, add the README subsection with the vdirsyncer path and the Akonadi warning, correct the query bar's from:/to: entry which had become false, and add the [Unreleased] changelog entry. --- CHANGELOG.md | 8 ++++++++ README.md | 38 +++++++++++++++++++++++++++++++++++--- translations/qtmaildir_it_IT.ts | 4 ++++ 3 files changed, 47 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 41f0254..cb58e2c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,14 @@ point at which they are stable. ## [Unreleased] +### Added + +- **Contact completion.** Point `contacts_dir` under `[general]` at a directory + of vCards, vdirsyncer's `~/.local/share/vdirsyncer/contacts/` being the usual + one, and the composer's To, Cc and Bcc fields and the query bar's `from:` and + `to:` complete against it. The store is read-only and loaded once at startup; + omit the key and the feature is off. + ## [0.29.0] - 2026-09-14 Spam is now a folder you can act on: Mark spam moves the file into a diff --git a/README.md b/README.md index 67fb16e..070425a 100644 --- a/README.md +++ b/README.md @@ -212,6 +212,11 @@ identity. ; your mail server. It is unrelated to the "passed" tag, which is the Maildir ; P flag and means "I forwarded this". ; forward_prefixes = Doorst, VS, VL +; Optional. A directory of vCards to complete addresses from, in the composer +; and in the query bar's from: and to:. A leading ~ is expanded. Omit it and +; the feature is off. See "Contact completion" for the usual value and the +; directory you must NOT use. +; contacts_dir = ~/.local/share/vdirsyncer/contacts/ [completion] ; Optional. Extra content types offered after mimetype:, APPENDED to the @@ -458,6 +463,30 @@ Sent mail is presented differently from the rest, because it reads differently: This applies only to the Sent button. The same query typed into the bar by hand behaves like any other query, threads and all. +### Contact completion + +`contacts_dir` under `[general]` names a directory of vCards to complete +addresses from: + +```ini +[general] +contacts_dir = ~/.local/share/vdirsyncer/contacts/ +``` + +That path is where vdirsyncer keeps a contacts collection and is the usual +value. A leading `~` is expanded. **Do not point it at +`~/.local/share/contacts/`**: that is Akonadi's directory, and it is the wrong +one. + +With the key set, the composer's To, Cc and Bcc fields complete against the +store (accepting a candidate inserts `Name
`), and the query bar +offers addresses after `from:` and `to:`. The store is read **once at startup +and is read-only**: editing contacts is not part of this application. + +Omit the key and the feature is off, exactly as if it did not exist. A path +that is set and missing is reported at startup, since there you asked for +something and are not getting it. + ## The query bar The bar at the top takes a notmuch query and shows the matching threads. @@ -485,10 +514,13 @@ What completes: extend through `[completion] extra_mimetypes`. - **Account directories**, after `path:`, in both the plain and the recursive `/**` form. +- **Addresses**, after `from:` and `to:`, from the vCard store configured by + `contacts_dir`. The value inserted is the bare address; the contact's name + is shown as its description. -`from:`, `to:`, `subject:`, `folder:`, `attachment:`, `thread:` and `id:` -offer no values. Addresses and folder names would need an enumerator -libnotmuch does not expose, and the rest are free text. +`subject:`, `folder:`, `attachment:`, `thread:` and `id:` offer no values. +Folder names would need an enumerator libnotmuch does not expose, and the rest +are free text. notmuch's date parser also accepts free-form dates such as `2026-01-15` or `15/01/2026..today`. Those cannot be offered as candidates, since there is no diff --git a/translations/qtmaildir_it_IT.ts b/translations/qtmaildir_it_IT.ts index f4d7688..371be09 100644 --- a/translations/qtmaildir_it_IT.ts +++ b/translations/qtmaildir_it_IT.ts @@ -244,6 +244,10 @@ Il messaggio È stato inviato. Non inviarlo di nuovo. Config + + Contacts directory '%1' does not exist; contact completion will find no contacts. + La directory dei contatti '%1' non esiste; il completamento dei contatti non troverà alcun contatto. + Language '%1' is not a locale name; using the system language. Expected something like 'it' or 'it_IT'. '%1' non è un nome di locale; verrà usata la lingua di sistema. Atteso qualcosa come 'it' o 'it_IT'. -- cgit v1.2.3