chore: release v0.19.2

2026-07-09 16:51:57 +02:00
parent 5ae2bad549
commit 19c2de5f61
37 changed files with 1395 additions and 73 deletions
@@ -0,0 +1,47 @@
+# Awards
+
+OpsLog has a flexible awards engine. Award **definitions** and reference lists are
+shared **globally** across profiles.
+
+## Built-in awards
+
+DXCC, WAS / WAZ / WAC, WPX, IOTA / POTA / SOTA / WWFF, **DDFM** (French
+departments), and more — tracked **worked / confirmed / validated** by band and
+mode.
+
+## How matching works
+
+An award scans a **QSO field** for a reference, by one of:
+
+- **code** — the field value is the reference (e.g. state = `NY`).
+- **description** — the reference's name appears in the field (substring, case-
+  insensitive but **space-sensitive** — "Hongkong" won't match "Hong Kong").
+- **pattern** — a per-reference regex is tested against the field.
+
+Plus **OR rules** (also match if any of these hit), a **leading/trailing** strip,
+a **prefix** added to found references, and a **dynamic** mode (any value counts,
+like POTA).
+
+> **Tip — Hong Kong / Macau style mismatches:** if the data says "Hong Kong" but
+> the reference description is "Hongkong", either fix the description to match, or
+> set that OR-search's *Match by* to **pattern** so the reference's own regex
+> (e.g. `\bHong Kong\b`) is used. In *description* mode the per-reference pattern
+> is ignored.
+
+## Live detection & manual refs
+
+- References are detected **live** as you enter a callsign.
+- You can **manually assign** a reference to a QSO (stored in an ADIF extra so it
+  survives export/import — see [[Import and Export ADIF]]).
+
+## Reference lists & display
+
+- **Import reference lists** for totals and names.
+- Per award, choose what the Recent-QSOs column shows: **reference**, **name**,
+  or **both**. Award columns are opt-in per the Columns picker
+  ([[Recent QSOs and Filters]]).
+
+## Rescan
+
+**Rescan** re-pulls the logbook and recomputes — it picks up fresh LoTW / QRZ /
+eQSL confirmations (see [[QSL Management]]).