drawing_faster: shortcut-bar tooltips, rotate vs orient texts, text angle dialog (pending #1084)

drawing_faster.md

@@ -17,7 +17,9 @@ and were built as a series of small pull requests, one per feature.
 
 > **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.
+> in current development builds. One later change is still pending: the
+> longer button tooltips and the text angle dialog in §5 and §7
+> ([PR #1084](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1084)).
 
 | § | Feature | How you reach it | Pull request |
 |---|---|---|---|
@@ -164,8 +166,49 @@ top**, chosen for what is selected — the same idea as SolidWorks' S key.
 
 ![The shortcut bar with a symbol selected: rotate, orient texts, edit, copy, cut, delete](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/drawing-shortcut-bar-selection.png)
 
-Each button runs **the same command as the menu** — hover it for the name.
-Escape closes the bar without doing anything.
+Each button runs **the same command as the menu**. Escape closes the bar
+without doing anything.
+
+### What a button does
+
+> **Status: pending.** This part describes
+> [PR #1084](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1084),
+> not yet merged. Until it lands, a tooltip shows only the command's name
+> (and its shortcut, on this bar). This notice will be removed once it does.
+
+Hover a button for its tooltip: the command's name, its keyboard shortcut if
+it has one, and on a second line what it does — the same sentence the status
+bar shows for that command in the menus.
+
+![Tooltip over the orient-texts button: "Orienter les textes (Ctrl+Space)" over "Pivote les textes sélectionnés à un angle précis"](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/drawing-shortcut-bar-tooltip.png)
+
+### Rotate or orient texts?
+
+The first two buttons for a selection are easy to confuse:
+
+| Button | Menu name | What it turns | How far |
+|---|---|---|---|
+| Rotate | *Pivoter* (Space) | the selected symbols, pictures and texts, each in place | 90° per click |
+| Orient texts | *Orienter les textes* (Ctrl+Space) | only the selected **texts** and text groups — free texts, symbol texts, wire texts | to an exact angle you type |
+
+*Orienter les textes* is greyed out unless at least one text or text group is
+selected: selecting a symbol does not select its texts. Click the text itself
+(Ctrl+click to add more), then press the button. A dialog asks for the angle:
+type it, or click one of the eight handles around the circle, then **OK**.
+
+> **Status: pending.** This part describes
+> [PR #1084](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1084),
+> not yet merged. Until it lands, the dialog always opens at 0°. This notice
+> will be removed once it does.
+
+The dialog opens at the angle the selected texts already have, so turning a
+vertical text by a few degrees means changing 90 to, say, 85 — not typing the
+whole angle again. If the selected texts are at different angles it opens at
+0°. The angle you enter replaces each text's angle; it is not added to it.
+
+![The text angle dialog opened on a text already at 90°: the spin box shows 90.00° and the preview text is vertical](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/drawing-orient-texts-dialog.png)
+
+Like every edit, orienting texts can be undone with Ctrl+Z.
 
 ### Choosing the commands
 
@@ -264,6 +307,10 @@ customising one customises the other.
 
 ![A step selected, with rotate, orient texts, edit, copy, cut and delete buttons beside it](https://raw.githubusercontent.com/wiki/qelectrotech/qelectrotech-source-mirror/images/drawing-context-toolbar.png)
 
+Hover a button for what it does, as on the shortcut bar (§5)
+([PR #1084](https://github.com/qelectrotech/qelectrotech-source-mirror/pull/1084),
+pending; until then the tooltip is only the command's name).
+
 It fades as the mouse moves away and disappears beyond about 200 pixels, or
 at the next key press. It does **not** appear after dragging something, while
 placing a symbol or running a drawing tool, or on a read-only folio.