Correct user_manual and add a preferences reference
user_manual.md read as confident-sounding but unverified filler, the same
failure mode already found and fixed in api_reference this session. Checked
every concrete claim in Projects & Folios, Working with Elements, Drawing
Wires, Reports, Preferences and the shortcuts table against the actual
source, and found roughly a dozen fabrications, not one or two:
- File -> New Project has no dialog at all (QETDiagramEditor::newProject()
creates the project and calls addNewDiagram() immediately) -- not a
three-step page-size/orientation/margin wizard.
- There is no "folio type" concept anywhere in the source -- no
single-line/multiline/control-diagram selector. Adding a folio
(addNewDiagram()) is likewise instant, no dialog.
- No per-folio "scale" property exists.
- "Auto-save, configure in Preferences" doesn't exist; there is a
20-minute crash-recovery backup timer with no exposed interval setting.
- The claimed element categories (01_Misc/03_Control/04_Energy/
10_Electrical) don't match anything in the collection -- real top-level
trees are 10_allpole/20_logic/30_hydraulic/50_pneumatic/60_energy.
- Every one of Rotate=R, Flip=H/V and Fit-to-page=Ctrl+0 in the shortcuts
table is wrong against ShortcutManager's actual registrations: rotate is
Space, fit-to-page is Ctrl+9, and flip doesn't exist at all for an
element placed on a folio -- flip (F) is element-editor-only, for
redrawing the symbol itself.
- No element-locking or persistent-grouping feature exists on current
master; removed rather than described.
- No wire-splitting mechanism exists (grep for split/conductor turns up
nothing); "wires only connect at terminals" already said correctly
elsewhere in the same file.
- No "Project -> Reports" menu or "I/O Documentation" report type exists;
nomenclature/wiring-list generation is File -> Export or the CLI
(--export-bom etc.), already documented in api_reference.
- The dynamic-text variable list (%id = "element ID", %label, %comment...)
contradicts this session's own verified variables.md -- %id is a folio
index, not an element reference number.
- No in-app "community element repository" browser exists.
- The claimed Preferences categories (Display/Projects/Grid) don't match
the five real pages (General, New project, Export, Print, Shortcuts).
Corrected or removed each, linking to the real mechanism where one of this
session's other pages already covers it (variables, api_reference,
project_database, element_editor, title_blocks, folio_links) rather than
re-describing it. Softened Multi-User Workflows with an actual caveat --
project_database.md already established there's no shared-state
mechanism, so "merge changes when working in parallel" needed the warning
that a merge conflict there is a raw XML conflict, not a structured one.
Applied identically across EN/FR/DE, not just the English source.
Adds a new preferences reference page (EN/FR/DE) covering what the real
five pages actually control, built from configdialog.cpp and
sources/ui/configpage/ directly: the six collection/title-block path
pickers on General (and why relocating one without a trailing slash used
to silently break IEC 81346 prefixes -- bugtracker #671), the New
project/New folio page's dual identity (same class, title and target
change depending on whether a project is open), and that Export and Print
share one underlying widget rather than being separate implementations.
ispyisail