Document the two menu entries nothing covered

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
ispyisail
2026-09-19 17:26:51 +12:00
parent 58afb6ed0f
commit 8516148135
2 changed files with 61 additions and 0 deletions
+33
@@ -142,3 +142,36 @@ Looking for how to select *items already placed on a diagram* (Tab-cycling,
select all, invert selection) rather than finding one to place? That's
**[Keyboard-only control](keyboard_control)**, a different meaning of
"select" from everything on this page.
---
## 6. Cleaning a project's embedded collection
A project accumulates embedded copies: every element you place is stored inside
the `.qet` file, and deleting the element from a folio does not remove the
stored definition. Over a long project that adds up.
**Project → Nettoyer le projet** offers three checkboxes, **all ticked by
default**:
| Option | Removes |
|---|---|
| Unused title block templates | embedded title block templates no folio uses |
| Unused elements | embedded element definitions that no folio places |
| Empty categories | embedded folders left with nothing in them |
"Unused" is decided by looking at what the folios actually place, so an element
you deleted from the drawing yesterday counts as unused today.
> **This cannot be undone.** Cleaning does not go through the undo stack — there
> is no undo command to reverse, and Ctrl+Z will not bring the definitions back.
> The only way out is to close the project **without saving**. Save first if you
> are not certain.
It only touches the collection **embedded in the project**. Your own element
library on disk is not affected, and neither is the common collection. The
practical consequence is the reverse of what people fear: cleaning does not
lose you an element you still have installed — but it does mean a project
carried to a machine that lacks that element in its library no longer brings
its own copy.
+28
@@ -134,6 +134,34 @@ See **[CLI reference](cli_reference)** for the commands, and
**[Building a nomenclature query](nomenclature_query)** for the BOM/summary
builder.
### Seeing the list without exporting it
**Project → Liste de câblage (base de données)** shows the same from-to list in
a window, one row per conductor:
| Column | |
|---|---|
| **Fil** | the wire number |
| **Composant 1 / Borne 1** | the element and terminal at one end |
| **Composant 2 / Borne 2** | the element and terminal at the other end |
| **Folio** | where the conductor is |
Rows are ordered by folio, then by wire number — numeric wire numbers first in
numeric order, so `9` comes before `10`, then anything non-numeric as text.
Two things this window tells you that the CSV does not:
- It **refreshes the database before querying**, so a wire number you changed
earlier in the session is already in the list.
- It **counts what it left out**. A conductor whose end is not attached to any
element cannot appear in a from-to list, and the window says how many were
excluded rather than presenting a short list as if it were complete. If that
number is not zero, something on a folio is not connected to what you think.
Being database-backed, it carries the same limitation as `--export-wiring`: no
tension, wire colour, section or function columns, because the database does
not store them.
---
## 5. A note on cables