docs(i18n): fix the spam docs review findings

3 files changed, 24 insertions, 15 deletions

diff --git a/CHANGELOG.md b/CHANGELOG.md
index bb7eb49..937c35d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -28,25 +28,21 @@ point at which they are stable.
   another already held the lock. qtmaildir reads it instead of inferring the
   outcome from a line in the log. Set `status` under `[sync]` to move the file;
   the default matches what the script writes and no config change is needed.
-
-- **A Spam view, and Mark spam now moves the file.** Every account may name a
+- **A Spam view, and Mark spam now moves the file.** Every account needs a
   `spam` folder beside its `trash`, and a built-in Spam filter lists that folder
   as a threaded view the way the trash filter does. Mark spam moves the message
   into that folder and records the one it came from in a `moved-from:` tag, so
   Restore and Undo put it back where it was. Before this the action only added
   the tag and left the file in place, so a message marked spam on one machine
   did not appear in the folder on another.
-
 - **Empty Spam.** Moves every message in the account's spam folder to its trash
   in one act, scoped to the account selector like Empty trash, and asks nothing
   first: it is a move with an undo behind it, and a mutation that can be undone
   gets undo rather than a dialog.
-
 - **Find stranded spam.** Mail carrying the `spam` tag while sitting in no spam
   folder, usually because another client or an older version tagged it and left
   the file where it was, is listed by a menu entry so it can be selected and
   moved. It is the spam counterpart to Find stranded deleted mail.
-
 - **A spam button on the message pane's bar**, beside Star and Archive. It is
   drawn with a bug rather than the theme's junk glyph, and falls back to
   `mail-mark-junk` on a theme that ships no bug.
@@ -136,13 +132,23 @@ and writes `moved-from:<folder>` and nothing else. Until the old tags are
 renamed, Restore cannot find them, so such a message falls back to the
 account's inbox rather than the folder it came from, and Undo of an old delete
 no longer knows the origin. Rename it once, per distinct folder, before you
-rely on either:
+rely on either. The search term needs its OWN double quotes: the shell's
+quotes only glue the argument together, and notmuch then splits a bare
+`tag:deleted-from:My Folder` into a term and a stray word, matching nothing at
+all while looking like it worked. In a tag NAME a space is hex-encoded `%20`,
+which is how notmuch spells a space there:
 
 ```bash
-notmuch tag +moved-from:'<folder>' -deleted-from:'<folder>' \
-  -- tag:'deleted-from:<folder>'
+notmuch tag +moved-from:'My%20Folder' -deleted-from:'My%20Folder' \
+  -- 'tag:"deleted-from:My Folder"'
 ```
 
+Replace `My%20Folder` with the folder name, writing any space as `%20`, and
+`My Folder` in the quoted term with the same name keeping its spaces. A folder
+with no space needs neither `%20` nor the inner quotes, so `Inbox` is
+`+moved-from:'Inbox' ... -- 'tag:"deleted-from:Inbox"'`. Run it once per
+distinct folder.
+
 There is no compatibility branch on purpose: a reader accepting both prefixes
 would answer "first match wins" on a message holding one of each, which is the
 silent mis-restore the single tag exists to prevent.
diff --git a/README.md b/README.md
index 2be629d..0c798f5 100644
--- a/README.md
+++ b/README.md
@@ -593,8 +593,10 @@ From: account re-seeds it only until you pick one yourself.
 
 ## Tagging
 
-Archive, delete, spam, mark-important and toggle-unread write fixed tags. For anything
-else, **Ctrl+T** opens a dialog over the selected threads: type tags to add or
+Archive, mark-important and toggle-unread write fixed tags. Delete and spam
+move the file instead: each adds a fixed tag (`deleted` or `spam`) and records
+the folder the file left in a `moved-from:<folder>` origin. For anything else,
+**Ctrl+T** opens a dialog over the selected threads: type tags to add or
 remove, separated by commas, or clear a checkbox to drop a tag already present.
 
 Both fields complete against every tag in your database, which is a guard
@@ -776,9 +778,10 @@ Defaults, all rebindable through `[keys]`:
 | `Ctrl+Q` | `quit` | Quit |
 
 Every action in this table carries a default binding, and every one appears in
-a menu. Some actions carry no default, because a chord for them would be
-arbitrary (Empty trash, Empty spam, Delete permanently); they are reachable
-from the menus and the shortcut reference prints them as unbound.
+a menu. Some actions carry none, because a chord for them would be arbitrary:
+Find stranded deleted mail, Find stranded spam, Empty trash, Empty spam, Delete
+permanently and Save message. They are reachable from the menus, and the
+shortcut reference prints them as unbound.
 **Help > Keyboard shortcuts** lists the current bindings, generated from the
 actions themselves, so it shows your overrides rather than these defaults.
 
diff --git a/translations/qtmaildir_it_IT.ts b/translations/qtmaildir_it_IT.ts
index 0a251e4..53a9dc3 100644
--- a/translations/qtmaildir_it_IT.ts
+++ b/translations/qtmaildir_it_IT.ts
@@ -897,7 +897,7 @@ Il messaggio È stato inviato. Non inviarlo di nuovo.</translation>
     </message>
     <message>
         <source>&amp;Check for stranded spam</source>
-        <translation>&amp;Cerca spam non spostato</translation>
+        <translation>Cerca spam &amp;fuori posto</translation>
     </message>
     <message>
         <source>Show mail tagged spam that is not in a spam folder</source>
@@ -913,7 +913,7 @@ Il messaggio È stato inviato. Non inviarlo di nuovo.</translation>
     </message>
     <message>
         <source>Empty spam f&amp;older...</source>
-        <translation>S&amp;vuota cartella spam...</translation>
+        <translation>S&amp;gombera la cartella spam...</translation>
     </message>
     <message>
         <source>Move every message in the spam folder to the trash</source>