From 808c06140f1e7f35866b823e53b63a4f82bcb557 Mon Sep 17 00:00:00 2001
From: Mario Mejias <mariomejias.f@gmail.com>
Date: Tue, 29 Sep 2026 00:41:45 +0200
Subject: [PATCH] Documentation: Shift and Ctrl keys for drawing boxes and
 box/ellipse rulers

---
 src/doc/doc/manual/create_box.xml |  6 ++++++
 src/doc/doc/manual/measure.xml    | 13 +++++++++++++
 2 files changed, 19 insertions(+)

diff --git a/src/doc/doc/manual/create_box.xml b/src/doc/doc/manual/create_box.xml
index b2516cbcc6..9ad258c202 100644
--- a/src/doc/doc/manual/create_box.xml
+++ b/src/doc/doc/manual/create_box.xml
@@ -14,6 +14,12 @@
   the second point. Press the ESC key to cancel the operation.
   </p>
 
+  <p>
+  While you drag the box, press the Ctrl key to confine the box to a square.
+  Press the Shift key to make the first point the center of the box.
+  Both keys can be combined.
+  </p>
+
   <p>
   While you drag the box, two edit boxes are shown at the top of the layout view.
   Press the Tab key to enter these edit boxes.
diff --git a/src/doc/doc/manual/measure.xml b/src/doc/doc/manual/measure.xml
index 8694eb36ef..4de7c861fa 100644
--- a/src/doc/doc/manual/measure.xml
+++ b/src/doc/doc/manual/measure.xml
@@ -84,6 +84,17 @@
   of this circle and the circle outline.
   </p>
 
+  <p>
+  The "Box" and "Ellipse" rulers are two-click types like the normal ruler,
+  but show a box or an ellipse spanned by the two points. For these rulers,
+  the Shift and Ctrl keys have a different meaning while you move the
+  second point: with the Shift key pressed, the first point becomes the
+  center of the box or ellipse. With the Ctrl key pressed, the box is
+  confined to a square and the ellipse to a circle. Both keys can be
+  combined. The same applies to all rulers using the "box" or "ellipse"
+  outline style.
+  </p>
+
   <p>
   Rulers can be configured in manifold ways. Use "Rulers And Annotations Setup" 
   in the "Edit" menu to open the ruler configuration dialog. 
@@ -99,6 +110,8 @@
   can be overridden with the Shift and Ctrl keys: pressing Shift while moving the
   mouse will enforce orthogonal constraint, Ctrl will enforce diagonal constraint 
   while pressing both will release any direction constraint.
+  When drawing box or ellipse rulers, these keys center the ruler or
+  confine it to a square or circle instead (see above).
   </p>
 
   <p>