preferences added

README.md

@@ -38,6 +38,8 @@ database with the `.agnd` extension.
   transactional SQLite persistence.
 - Responsive compact/wide layouts, keyboard navigation, mouse selection,
   clickable function-key commands, and an in-app help screen.
+- Application-wide Preferences plus per-document settings for themes, display and
+  locale conventions, autosave, confirmations, dates, filing, Trash, and backups.
 
 ## Build and run
 
@@ -107,6 +109,34 @@ In the `F5` note editor, `Enter` inserts a line, arrows/Home/End move the cursor
 and `Ctrl-S` saves. Mouse clicks select rows, switch views, and activate the
 bottom command strip.
 
+## Preferences and document settings
+
+Press `F10`, then `p` for application-wide Preferences. Rogue Agenda saves these
+as typed TOML at `~/.config/rogue-agenda/preferences.toml`. The screen controls:
+
+- `classic`, `mono`, and `amber` themes
+- function-key command bar and category-rule detail visibility
+- carriage-return and item markers
+- autosave checkpoint interval and destructive-action confirmations
+- ISO, US, European, or long date display and 12/24-hour time
+- decimal and thousands separators
+
+The file is created when Preferences are first saved. It can also be edited with
+a text editor while Rogue Agenda is closed; unknown keys and invalid values are
+reported instead of silently ignored.
+
+Press `F10`, then `d` for settings stored in the current `.agnd` document. These
+travel with the document and include its description, backup-on-open, Trash
+retention (`on-demand`, `on-close`, `end-of-day`, or `immediate`), completed-item
+policy, automatic filing, numeric date order, first day of the week, default and
+named times, and note-editor tab width. `this week` and `next week` honor the
+chosen week boundary; `morning`, `afternoon`, and `evening` honor their configured
+times.
+
+Use `F10`, then `b` to create a consistent sibling backup named
+`document.agnd.bak`, or enable backup-on-open. Use `F10`, then `t` to empty Trash.
+Permanent operations request confirmation unless that preference is disabled.
+
 ## Designing live views
 
 Open the View Manager with `F8`. Press `n` to create a view, `e` to edit one,