drawing_faster: pinning symbols to the shortcut bar and setting its width (PR #1060, pending)

drawing_faster.md

@@ -29,6 +29,7 @@ and are built as a series of small pull requests, one per feature.
 | 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) |
 | 6 | [Customising the shortcut bar in place](#6-customising-the-shortcut-bar) | "…" on the bar | [#1054](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1054) |
+| 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) |
@@ -238,7 +239,65 @@ in the bar's place:
 
 It edits the list for the kind of selection the bar was opened on (nothing,
 wires, or anything else). The palette below is not edited here; it is your
-user collection (§4).
+user collection (§4) — but you can put symbols on the bar itself, next to the
+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.
+
+![The shortcut bar with its eight commands on the first row and five pinned symbols on the second: fuse, coil, contact, lamp, three-phase motor](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/drawing-shortcut-bar-pinned.png)
+
+Open the edit window (**…** on the bar with nothing selected). Beside
+*Autres commandes* there is an **Éléments** (*elements*) column with a search
+box. Type at least three letters of a symbol's name; the matches appear with
+their icons, best first, as in the Collections search (§3).
+
+![The edit window with "diode" typed in the Éléments search: Diode, diode-tube, Diode bridge, Photodiode… listed, and the five pinned symbols at the end of the bar row](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/drawing-shortcut-bar-pin-search.png)
+
+| To… | Do |
+|---|---|
+| pin a symbol | drag it from the *Éléments* list onto the bar, or double-click it |
+| pin the best match quickly | type its name and press **Enter** — the window stays open for the next one |
+| move it along the bar | drag it, like a command |
+| unpin it | double-click it on the bar, or drag it off the bar onto *Autres commandes* |
+| keep the changes | **Terminé**, as for commands |
+
+Then, on the bar, **click a symbol's icon to start placing it** — the same
+as choosing it in the element picker. Hover an icon for the symbol's name.
+
+Good to know:
+
+- Symbols can only be pinned to the bar you get with **nothing selected**.
+  With something selected, the bar is for working on that selection.
+- Once at least one symbol is pinned there, the palette grid (§4) is no
+  longer shown under the bar — your pinned symbols replace it. The search
+  box is still there, and the list comes back as soon as you type.
+- Symbols embedded in a project (*Imported elements*) are not offered: only
+  symbols from the QET, company and user collections, which exist in every
+  project. A pinned symbol that is later deleted from its collection simply
+  disappears from the bar.
+- The **Barre de raccourcis** preferences page (§5) lists pinned symbols
+  by name among the commands, so you can reorder them there; **← Retirer**
+  unpins one.
+- After **Terminé**, the bar reopens **at the mouse pointer**, not where the
+  edit window was. The edit window remembers the size you leave it at.
+
+### Making the bar narrower
+
+A bar with many commands and symbols gets long. Drag the small **grip in
+the bar's bottom-right corner** (*Glisser pour changer la largeur de la
+barre*) to the left: the icons wrap onto more rows as the bar narrows, and
+the bar grows downwards to fit. The width is remembered — the bar opens at
+that width from then on. Until you drag the grip, all icons stay on one row.
 
 ---
 
@@ -377,6 +436,8 @@ are separate windows with their own keys.
 
 - The palette (§4) is always your user collection folder; there is no
   setting in the preferences dialog to point it elsewhere.
+- Symbols can be pinned only to the nothing-selected bar (§6), and only
+  from the QET, company and user collections.
 - Command search, the shortcut bar and gestures only offer commands that
   have an entry in the Shortcuts preferences page. A handful of panel and
   dock actions don't.