diff --git a/collection_browser.md b/collection_browser.md index 277ee38..27a8808 100644 --- a/collection_browser.md +++ b/collection_browser.md @@ -31,12 +31,10 @@ on this page apply equally to both tabs. The **search box** at the top filters the current tab as you type. -> **Status: pending.** Two changes to this panel are in open pull requests, -> not yet merged: with [PR #1051](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1051) a search shows one flat list, best match -> first, instead of the filtered tree; and with [PR #1042](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1042) **double-clicking** -> a symbol (or pressing **Enter** on it) places it on the folio instead of -> opening the element editor — a preference restores the old behaviour. See -> **[Drawing faster](drawing_faster)**. +A search shows one flat list, best match first, instead of the filtered +tree, and **double-clicking** a symbol (or pressing **Enter** on it) places it +on the folio instead of opening the element editor; a preference restores the +old behaviour. See **[Drawing faster](drawing_faster)**. --- @@ -114,9 +112,9 @@ without waiting on a "favourites" feature that doesn't exist yet: 4. Repeat for every device you reach for often. From then on, they're one level deep under **Collection utilisateur**, in an order you chose. -> **Pending:** with [PR #1052](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1052), this user collection is also the palette of -> the **Insert** element picker, which shows it as a grid at the cursor — -> see **[Drawing faster](drawing_faster)**. +This user collection is also the palette of +the **Insert** element picker, which shows it as a grid at the cursor — +see **[Drawing faster](drawing_faster)**. **"Show only this folder"** (§3) is the other half of this: once your shortlist folder exists, right-click it and solo it to hide the entire diff --git a/drawing_faster.md b/drawing_faster.md index 04bda37..8154713 100644 --- a/drawing_faster.md +++ b/drawing_faster.md @@ -13,18 +13,16 @@ were proposed in [discussion #676](https://github.com/qelectrotech/qelectrotech-source-mirror/discussions/676) and [discussion #1033](https://github.com/qelectrotech/qelectrotech-source-mirror/discussions/1033), -and are built as a series of small pull requests, one per feature. +and were built as a series of small pull requests, one per feature. -> **Status: mostly pending.** The right-click menu restructure (§2) and -> command search (§9) are merged. Every other section carries its own notice naming the pull request -> it describes; nothing in such a section works in your build until that PR -> lands. Check the PR before trying it. Each notice is removed once its PR -> merges. +> **Status: merged.** Every feature on this page is in QElectroTech's +> master branch (the last pull requests merged on 27 September 2026), so it is +> in current development builds. | § | Feature | How you reach it | Pull request | |---|---|---|---| | 1 | [Place a symbol without dragging](#1-placing-a-symbol-without-dragging), and place the last one again | Double-click or Enter in Collections; **A** | [#1042](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1042) | -| 2 | [Placing from the right-click menu](#2-the-folios-right-click-menu) | Right-click an empty spot | [#1041](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1041) (merged), [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) | +| 2 | [Placing from the right-click menu](#2-the-folios-right-click-menu) | Right-click an empty spot | [#1041](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1041), [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) | | 3 | [Ranked collection search](#3-searching-the-collection-best-match-first) | The Collections search box | [#1051](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1051) | | 4 | [Element picker at the cursor](#4-the-element-picker-insert) | **Insert** | [#1052](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1052) | | 5 | [Shortcut bar](#5-the-shortcut-bar-s) | **S** | [#1053](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1053) | @@ -32,13 +30,9 @@ and are built as a series of small pull requests, one per feature. | 6 | [Your own symbols on the bar, and its width](#putting-your-own-symbols-on-the-bar) | *Éléments* in the edit window; the bar's corner grip | [#1060](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1060) | | 7 | [Commands beside the selection](#7-commands-beside-the-selection) | Click something | [#1055](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1055) | | 8 | [Repeat the last command](#8-enter-repeats-the-last-command) | **Enter** on the folio | [#1056](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1056) | -| 9 | [Command search](#9-command-search-ctrlshiftm) | **Ctrl+Shift+M** | [#1049](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1049) (merged) | +| 9 | [Command search](#9-command-search-ctrlshiftm) | **Ctrl+Shift+M** | [#1049](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1049) | | 10 | [Mouse gestures](#10-mouse-gestures-right-drag) | Right-drag | [#1057](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1057) | -The pull requests build on each other in the order of the table (except -§9, which stands alone), so they are expected to merge roughly in that -order. - Menu and option names below are given in French, as QElectroTech shows them until the translations are updated, with an English gloss in italics. @@ -46,12 +40,6 @@ until the translations are updated, with an English gloss in italics. ## 1. Placing a symbol without dragging -> **Status: pending.** This section describes -> [PR #1042](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1042), -> not yet merged. Nothing here works until that lands — check the PR before -> trying any of this against your own build. This section will drop this -> notice once it does. - In the **Collections** panel, **double-click** a symbol, or select it and press **Enter**. The symbol attaches to the cursor; click on the folio to put it down. You stay in placing mode, so each further click places another copy. @@ -85,18 +73,14 @@ Right-click an empty spot on a folio. The menu puts drawing first: | Entry | Does | Since | |---|---|---| -| **Renvoi de folio ▸** (*folio reference*) | places a folio report arrow where you right-clicked | pending, [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) | -| **Insérer le dernier élément** (*insert last element*) | starts placing the last symbol again, as **A** does; shown once something has been placed | pending, [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) | +| **Renvoi de folio ▸** (*folio reference*) | places a folio report arrow where you right-clicked | [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) | +| **Insérer le dernier élément** (*insert last element*) | starts placing the last symbol again, as **A** does; shown once something has been placed | [#1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050) | | **Ajouter ▸** (*add*) | text, image, PDF, line, rectangle, ellipse, polyline, curve, terminal strip | merged ([#1041](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1041)) | | **Propriétés du folio** (*folio properties*) | the folio's properties dialog | merged | | **Lignes et colonnes ▸** (*rows and columns*) | add or remove a row or a column | merged — moved one level down by #1041 | ![The folio's right-click menu with the Renvoi de folio submenu open: Coming arrow, Going arrow, Next folio](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/drawing-folio-menu.png) -> **Status: pending** for the first two rows only: -> [PR #1050](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1050), -> not yet merged. The rest of the menu is in current builds. - ### Which arrows "Renvoi de folio" lists It lists **the folio report symbols your project already uses**, read from @@ -116,12 +100,6 @@ For what a folio report does once placed, see ## 3. Searching the collection, best match first -> **Status: pending.** This section describes -> [PR #1051](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1051), -> not yet merged. Nothing here works until that lands — check the PR before -> trying any of this against your own build. This section will drop this -> notice once it does. - Typing in the **Collections** search box now gives **one flat list, best match first**, instead of the folder tree filtered down to matching branches. Down arrow and Enter place the highlighted symbol (with §1). @@ -145,12 +123,6 @@ symbols' **displayed names** in your language, not their file names. ## 4. The element picker (Insert) -> **Status: pending.** This section describes -> [PR #1052](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1052), -> not yet merged. Nothing here works until that lands — check the PR before -> trying any of this against your own build. This section will drop this -> notice once it does. - Press **Insert** with the mouse over the folio (*Édition → Insérer un élément…*). A small window opens at the cursor: @@ -178,12 +150,6 @@ same way as any collection, and there is nothing extra to back up. ## 5. The shortcut bar (S) -> **Status: pending.** This section describes -> [PR #1053](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1053), -> not yet merged. Nothing here works until that lands — check the PR before -> trying any of this against your own build. This section will drop this -> notice once it does. - Press **S** with the mouse over the folio (*Édition → Barre de raccourcis*). The element picker opens at the cursor with **a row of command buttons on top**, chosen for what is selected — the same idea as SolidWorks' S key. @@ -217,12 +183,6 @@ and are not part of undo. ## 6. Customising the shortcut bar -> **Status: pending.** This section describes -> [PR #1054](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1054), -> not yet merged. Nothing here works until that lands — check the PR before -> trying any of this against your own build. This section will drop this -> notice once it does. - Click **…** at the right end of the bar's command row. An edit window opens in the bar's place: @@ -244,12 +204,6 @@ commands, as described next. ### Putting your own symbols on the bar -> **Status: pending.** This section describes -> [PR #1060](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1060), -> not yet merged. Nothing here works until that lands — check the PR before -> trying any of this against your own build. This section will drop this -> notice once it does. - The symbols you use all day — a fuse, a coil, a contact, a lamp, a motor — can sit on the bar as icons beside the commands, so placing one is **S** and one click. @@ -303,12 +257,6 @@ that width from then on. Until you drag the grip, all icons stay on one row. ## 7. Commands beside the selection -> **Status: pending.** This section describes -> [PR #1055](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1055), -> not yet merged. Nothing here works until that lands — check the PR before -> trying any of this against your own build. This section will drop this -> notice once it does. - Click a symbol, text or wire and a small bar of commands appears just above and to the right of the cursor — SolidWorks' context toolbar. It holds the first eight commands of the shortcut bar's list for that selection (§5), so @@ -328,12 +276,6 @@ QElectroTech → Général → Apparence →* **Afficher les commandes près de ## 8. Enter repeats the last command -> **Status: pending.** This section describes -> [PR #1056](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1056), -> not yet merged. Nothing here works until that lands — check the PR before -> trying any of this against your own build. This section will drop this -> notice once it does. - Press **Enter** on the folio to start the last drawing or placing command again. Draw a line, press Escape, press Enter — you are drawing another. Place a fuse, Escape, Enter — you are placing another fuse. @@ -388,12 +330,6 @@ preferences. ## 10. Mouse gestures (right-drag) -> **Status: pending.** This section describes -> [PR #1057](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1057), -> not yet merged. Nothing here works until that lands — check the PR before -> trying any of this against your own build. This section will drop this -> notice once it does. - Hold the **right** mouse button and drag in any direction: a ring of up to eight commands appears around the point where you pressed. Drag toward one — its slice lights up and its name shows below — and release to run it. diff --git a/keyboard_control.md b/keyboard_control.md index 95c4b1c..01f6105 100644 --- a/keyboard_control.md +++ b/keyboard_control.md @@ -10,29 +10,25 @@ vary by OS/desktop rather than just the Ctrl→Cmd swap; those are called out individually instead of guessed. Every shortcut here is also rebindable, see [Changing a shortcut](#changing-a-shortcut) below. -## The one real gap: placing a *new* element still needs a mouse +## Placing a new element from the keyboard -> **Status: pending fix.** [PR #1042](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1042), not yet merged, closes this gap: -> double-click or **Enter** on a symbol in the Collections panel attaches it -> to the cursor, and **A** places the last one again. With [PR #1052](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1052), -> **Insert** opens a picker at the cursor where you type a name and press -> Enter. Until they land, the paragraphs below describe current builds. See -> **[Drawing faster](drawing_faster)**. +Placing a symbol used to be the one thing that needed a mouse: the only way +to put a catalog symbol on a folio was to drag it from the Collections panel. +It no longer is: -Read this first, because it's the thing most people asking about mouseless -control actually want, and it isn't fully there yet. **Dragging an element -from the Collections panel onto a diagram is the only way to place one -you've never used in this project before — there is no keyboard or -double-click equivalent.** Checked directly: double-clicking an element in -the Collections panel opens it in the **Element Editor**, not onto your -diagram, and neither Enter nor a context-menu action inserts it either. +| To | Do | +|---|---| +| Place a symbol from the Collections panel | select it (Tab into the panel, arrow keys, or type in the search box) and press **Enter**: the symbol attaches to the cursor. Double-click does the same. | +| Place the last symbol again | **A** | +| Pick a symbol at the cursor by name | **Insert** opens a picker; type part of the name and press **Enter** | -That's narrower than it used to be, though: if the element you want is -**already somewhere in the project**, copying and pasting it is now fully -keyboard-driven — see [Duplicating an existing -element](#duplicating-an-existing-element-without-a-mouse) below. The gap -that remains is specifically *the first instance of a catalog element in a -project*. +A preference makes double-click open the element editor again, as it used +to (**[Preferences reference](preferences)**, §1, *Interface*). Full details, including where the attached +symbol lands and how to cancel it, are on **[Drawing faster](drawing_faster)**. + +If the element is **already somewhere in the project**, copying and pasting +it also works entirely from the keyboard — see [Duplicating an existing +element](#duplicating-an-existing-element-without-a-mouse) below. Once an element is already on a diagram, everything below applies — selecting, moving, rotating, editing, wiring and deleting existing elements @@ -202,13 +198,10 @@ elements' *display names*, not their filenames (searching `bobine3` won't find "Coil", searching `coil` will). Arrow keys move through the filtered tree once it has focus. -> **Status: pending.** With [PR #1051](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1051) the search gives one flat list, best -> match first, and with [PR #1042](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1042) Enter on a result places it — see -> **[Drawing faster](drawing_faster)**. Neither is merged yet. - -That's as far as the keyboard takes you here — see the gap noted at the top -of this page. Placing the element you've found still means dragging it onto -a diagram. +The search gives one flat list, best match first, and **Enter** on a result +attaches it to the cursor for placing — see +[Placing a new element from the keyboard](#placing-a-new-element-from-the-keyboard) +above. ## Element Editor (editing a symbol's own drawing) @@ -241,11 +234,9 @@ your platform's standard "redo" key), plus template-specific actions — logos, **Ctrl+Y** edits cell info, zoom on Ctrl+9/Ctrl+0 and your platform's standard zoom-in/out keys. -## Commands at the cursor (mostly pending) +## Commands at the cursor -> **Status: pending**, except command search (Ctrl+Shift+M), which is -> merged. Each other row names its open pull request; nothing in those rows -> works until it lands. The full description is on **[Drawing faster](drawing_faster)**. +The full description is on **[Drawing faster](drawing_faster)**. | Action | Key | Pull request | |---|---|---| @@ -253,7 +244,7 @@ platform's standard zoom-in/out keys. | Element picker at the cursor: type a name, Enter places it | Insert | [PR #1052](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1052) | | Shortcut bar: commands for the selection, plus the picker | S | [PR #1053](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1053) | | Repeat the last drawing or placing command | Enter (on the folio) | [PR #1056](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1056) | -| Search every command by name and run it | Ctrl+Shift+M | merged ([PR #1049](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1049)) | +| Search every command by name and run it | Ctrl+Shift+M | [PR #1049](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1049) | Command search makes every command reachable without knowing its menu, and lists each command's own key next to it. @@ -273,9 +264,6 @@ list to conflicts only. Stated plainly rather than left for you to discover: -- **Placing a *new* catalog element** — one not already used somewhere in - the project — from the Collections panel onto a diagram. (Duplicating an - *existing* one is keyboard-driven — see above.) - **Drawing** a line, rectangle, polygon or terminal — reaching the tool is keyboard-driven (**Édition → Ajouter**, above), but placing its points on the canvas isn't, in a diagram or inside the Element Editor's own symbol diff --git a/preferences.md b/preferences.md index 20e85bb..6777f28 100644 --- a/preferences.md +++ b/preferences.md @@ -39,8 +39,8 @@ title-block templates, custom title-block templates, and custom macros. round up at .75, or no rounding) — matters on fractional-scale displays - Language -Three more options in this group are **pending** — each is in an open pull -request, not in current builds (see **[Drawing faster](drawing_faster)**): +Three more options in this group come with the features on +**[Drawing faster](drawing_faster)**: | Option | Default | Pull request | |---|---|---| @@ -126,9 +126,7 @@ export), see **[DXF import & export](dxf)**. --- -## 3b. Barre de raccourcis (shortcut bar) — pending - -> **Status: pending.** This page is added by [PR #1053](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1053), not yet merged. +## 3b. Barre de raccourcis (shortcut bar) Chooses the commands the **S** shortcut bar shows (and, with later pull requests, the command bar beside a selection and the gesture ring). Pick the