Add the wire/cable catalogue manual (EN/FR/DE), pending PR #936
Documents the catalogue added by PR #936, in English, French and German,
each carrying the "Status: pending" notice until that PR merges.
Written as a cable manual rather than a wire one, because the data model
is a cable model: wirespec.h defines isCable() as numCores > 1, and the
per-core colours and sections, outer diameter, shield type and cable
family all exist because a cable has several differing cores. A
single-core wire is the degenerate case.
Every factual claim was checked against the source rather than the PR
description: the menu entry and dock behaviour (qetdiagrameditor.cpp),
the database path and its being global rather than per project
(wirecataloguedb.cpp), the fifteen IEC 60757 colours (iec60757.cpp), the
search matching section and core count as text, and what assigning a core
writes to a conductor, including the dashed shield and the green-yellow
bicolour pair (conductorpropertieswidget.cpp).
That check corrected one thing. The PR describes the terminal strip's
Cable column as a stub returning an empty string; what is actually there
is Cable and CableWire declared as column enums with no data source at
all. The page says the latter.
The page leads with what the feature is not, because conductors.md states
that QElectroTech has no cable object and that remains true: assigning a
catalogue entry copies values onto one conductor, and the Cable field it
fills is read by nothing. Linked both ways with each language's
conductors page, and added to the sidebar under Guides.
Project > Nettoyer le projet and Project > Liste de câblage (base de
données) were the only two entries in the Project menu with no wiki
coverage at all. Both are small, so they go into the pages people would
already be reading rather than into two thin stubs.
Cleaning, in collection_browser: three checkboxes all ticked by default,
what "unused" is decided from, and the part that matters -- it does not
go through the undo stack, so Ctrl+Z will not bring the definitions back
and closing without saving is the only way out. Also which collection it
touches: the one embedded in the project, never your own library, which
is the reverse of what people fear and has its own consequence for a
project carried to another machine.
The wiring list window, in conductors, beside the exports it mirrors:
its six columns, the sort (numeric wire numbers before text, so 9 comes
before 10), that it refreshes the database before querying so a number
edited this session is already there, and that it counts the conductors
it excluded -- an endpoint attached to no element cannot appear in a
from-to list, and a non-zero count means something is not connected.
Being database-backed it carries the same missing columns as
--export-wiring, which the page already explains.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CaKympWT3owLotCpEN2CFj
The most-used object in the program had no reference page. Conductors
are mentioned on 27 wiki pages and covered by none; every neighbouring
subsystem has a guide -- auto-numbering, folio links, terminal strips,
the nomenclature builder -- while the conductor itself had only a
chapter in user_manual.
Written from ConductorProperties and the export code rather than from
the dialog's labels, so each field says what reads it:
- the three levels settings come from (application, folio, conductor),
which are three different dialogs and do not rewrite each other;
- every field with its XML attribute, so a .qet file can be read;
- which fields fill which column of --export-cables, since that is the
only reason several of them exist;
- that --export-wiring cannot carry those columns at all: it reads the
project database, whose conductor table stores only the two terminals
and the wire number;
- Ctrl+K discards hand-routing, and a stored path that no longer matches
its terminals is silently dropped at load;
- F2 colours one conductor and refuses with several selected.
Two things stated plainly because users hit them and find nothing:
- Cable and Bus are stored, reloaded, shown in the dialog, and read by
nothing at all.
- There is no cable object -- no class, no database table, no grouping.
"--export-cables" is the from-to list, one row per conductor. A user
looking for cable management should know that before going looking.
Also records that named conductor presets do not exist (#461), which is
what a user was told to use on that issue and could not find, and links
PR #929 as pending rather than describing it as working.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CaKympWT3owLotCpEN2CFj
ispyisail