mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2026-09-20 07:14:13 +02:00
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
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user