Updating documentation

src/doc/doc/manual/create_box.xml

@@ -14,7 +14,15 @@
   the second point. Press the ESC key to cancel the operation.
   </p>
 
-  <p><b>Hint:</b> A box, once created, will remain a box. For example, it is not possible to delete one vertex 
+  <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.
+  Use the Tab and Shift+Tab keys to navigate between the boxes.
+  You can specify numerical values for the box width and height here. Pressing the Enter key will apply these
+  dimensions. Pressing the Escape key will leave the edit fields.
+  </p>
+
+  <p><b>Note:</b> A box, once created, will remain a box. For example, it is not possible to delete one vertex 
   of it, thus forming a triangle. This is only possible for polygons.
   </p>
 

src/doc/doc/manual/create_path.xml

@@ -18,8 +18,24 @@
   To actually draw a path, 
   choose a layer from the layer panel in which to create a new path. 
   Left click at the first vertex, move the mouse to the second vertex, click to place this one and continue 
-  to the last vertex. Double-click at the last vertex to finish the path. Press the ESC key to cancel the operation.
-  Use the backspace key to remove the current segment and go back to the previous segment.
+  to the last vertex. Double-click at the last vertex or press the Enter key to finish the path. 
+  Press the Escape key to cancel the operation.
+  Use the Backspace key to remove the current segment and go back to the previous segment.
+  </p>
+
+  <p>
+  To temporarily constrain the segment direction, press the Shift or Ctrl key or both while dragging
+  the segment. Shift will apply Manhattan 
+  constraints (vertical and horizontal only), Ctrl will allow diagonal directions in addition and 
+  pressing Shift+Ctrl will allow all directions.
+  </p>
+
+  <p>
+  While you drag a path segment, two edit boxes are shown at the top of the layout view.
+  Press the Tab key to enter these edit boxes.
+  Use the Tab and Shift+Tab keys to navigate between the boxes.
+  You can specify a numerical values for the segment vector here. Pressing the Enter key will apply these
+  relative coordinates and enter a new segment. Pressing the Escape key will leave the edit fields.
   </p>
 
   <p>

src/doc/doc/manual/create_polygon.xml

@@ -14,11 +14,28 @@
   with a left mouse button click. Move to the next vertex. Depending on the connection mode, the edges
   created are confined to certain directions. See <link href="/manual/editor_options.xml"/>
   for a detailed description of the modes. Use the "editor options" dialog (F3 shortcut) to change the mode, 
-  even during editing.
+  even during editing. 
   </p>
 
   <p>
-  Double-click at the final point to finish the polygon. Press the ESC key to cancel the operation.
+  To temporarily constrain the segment direction, press the Shift or Ctrl key or both while dragging
+  the segment. Shift will apply Manhattan 
+  constraints (vertical and horizontal only), Ctrl will allow diagonal directions in addition and 
+  pressing Shift+Ctrl will allow all directions.
+  </p>
+
+  <p>
+  Double-click at the final point or press the Enter key to finish the polygon. 
+  Press the Escape key to cancel the operation. Use the Backspace key to delete the
+  last segment.
+  </p>
+
+  <p>
+  While you drag a polygon segment, two edit boxes are shown at the top of the layout view.
+  Press the Tab key to enter these edit boxes.
+  Use the Tab and Shift+Tab keys to navigate between the boxes.
+  You can specify a numerical values for the segment vector here. Pressing the Enter key will apply these
+  relative coordinates and enter a new segment. Pressing the Escape key will leave the edit fields.
   </p>
 
   <p>

src/doc/doc/manual/measure.xml

@@ -10,13 +10,37 @@
   <p>
   A measurement can be performed by clicking on the ruler icon in the 
   toolbar and selecting "Ruler" from the drop-down options.
-  Left-click on a point in the layout and then left-click again to 
-  specify the second point. A ruler will be shown that indicates
-  the distance measured. 
+  Left-click on a point in the layout and then left-click again
+  or press the Enter key to set the second point. 
+  A ruler will be shown that indicates the distance measured. 
   </p>
 
   <p>
-  A more convenient way is provided with the single-click measurement
+  While you move the endpoint, you can hold the Shift or Ctrl key
+  or both. With only the Shift key pressed, the ruler's direction 
+  will be limited to horizontal or vertical only. With only the Ctrl
+  key pressed, the direction is limited to horizontal, vertical or
+  diagonal. With Ctrl and Shift pressed together, no limitation
+  of direction applies.
+  </p>
+
+  <p>
+  While the ruler is dragged, the current drag distance is indicated
+  in three edit fields at the top of the layout view. By pressing the
+  Tab key, the input focus changes to these edit fields. You can 
+  specify a numerical value for the distances here. Use Tab and
+  Shift+Tab to jump between the fields. Press the Escape key to
+  leave the edit fields. Pressing the Enter key while
+  the cursor is on the "dx" or "dy" field will
+  accept the values and apply them to the ruler.
+  If you specify a value in the last field labelled "d" and press
+  Enter, the ruler will enter "fixed length" mode - in that mode you
+  can still define the ruler's direction with the mouse, but the 
+  length is fixed to the given value.
+  </p>
+
+  <p>
+  A convenient way to measure a distance is the single-click measurement
   ruler. Select "Measure" from the drop-down options of the ruler symbol.
   In this mode, a single click will set a ruler to the specified 
   position. This feature will look for edges in the vicinity of the 
@@ -24,6 +48,11 @@
   is attached perpendicular to the edge next to the initial point.
   </p>
 
+  <p>
+  The "Measure Edge" ruler type is also a single-click measurement
+  ruler, but measures the length of an edge at the click position.
+  </p>
+
   <p>
   You can mark a position with a single click by selecting the "Cross"
   ruler type. Clicking at a location will place such a ruler. The ruler
@@ -35,7 +64,12 @@
   object. Click and the first point to start such a ruler. Then click
   on more points to add new segments to the ruler. Each segment is shown
   as an individual ruler with tick marks and a length. Finish the sequence
-  with a double-click.
+  with a double-click or by pressing the Enter key.
+  Note that the lengths indicated by the ruler labels are the lengths
+  of the individual segments. To get an incremental length (the sum
+  of all segment length), change the ruler's label format from "$D" to "$DD" ("DD"
+  is variable giving the incremental length).
+  See the description of ruler templates below, about how to make this change permanent.
   </p>
 
   <p>

src/doc/doc/manual/move_layer_sel.xml

@@ -12,10 +12,16 @@
   All selected shapes are moved to the layer that is the current one (marked with a rectangle) in the layer list.
   The shapes will not be moved across the hierarchy but just inside their cell.
   </p>
+
   <p>
   All layers (source and target) must be located in the same layout. To move shapes to a 
   different layout, use copy &amp; paste.
   </p>
 
+  <p>
+  You can also change the layer in the shape properties. This will effectively
+  move shapes to other layers too.
+  </p>
+
 </doc>
 

src/doc/doc/manual/move_sel.xml

@@ -17,19 +17,27 @@
   <p>
   While moving, the whole selection can be rotated by 90 degree counterclockwise with a right mouse 
   button click. 
-  The ESC key will cancel the operation.
+  The Escape key will cancel the operation.
   </p>
 
   <p>
   For movements, the movement direction constraint apply. 
   See <link href="/manual/editor_options.xml"/> for details about the modes
-  available. For example, in manhattan mode, only horizontal and vertical movements are allowed.
+  available. For example, in Manhattan mode, only horizontal and vertical movements are allowed.
   The global movement constraint can be overridden by pressing Shift (orthogonal), Ctrl (diagonal) or 
   both Shift and Ctrl (any angle) while moving the mouse.
   </p>
 
   <p>
-  If a move distance and direction is known numerically, "Move By" from the "Edit/Selection" menu can be used. 
+  While you move the selection, two edit boxes are shown at the top of the layout view.
+  Press the Tab key to enter these edit boxes.
+  Use the Tab and Shift+Tab keys to navigate between the boxes.
+  You can specify a numerical shift value here. Pressing the Enter key will apply these
+  shifts. Pressing the Escape key will leave the edit fields.
+  </p>
+
+  <p>
+  To apply a specific shift, you can also use "Move By" from the "Edit/Selection" menu.
   A dialog will open that allows specification of the horizontal and vertical move distance in micrometers.
   Positive values move to the top or right and negative ones to the bottom or left.
   This dialog also applies to partial mode, so that edges or parts of a layout can be 

src/doc/doc/manual/partial.xml

@@ -35,7 +35,9 @@
   Simply clicking at an item immediately enters "move" mode. In this mode, you can position the element at the desired
   target location and place it there by left-clicking at the position. Press "ESC" to cancel the operation.
   When a complex selection is made, move mode is entered by clicking at one of the selected items (the edges
-  or vertices, not the shape to which they belong). 
+  or vertices, not the shape to which they belong). While you move, two edit boxes are shown at the top of 
+  the layout view. Press the Tab key to enter these edit fields. You can specify explicit move distances there.
+  Press the Enter key to apply them or the Escape key to leave these edit fields.
   </p>
 
   <p>

src/doc/doc/manual/ruler_properties.xml

@@ -53,9 +53,14 @@
 
   <ul>
     <li><b>$X</b>: The value of the X variable (the horizontal distance, see below for a complete list of variables).</li>
-    <li><b>$(sprintf('%.2f',X))</b>: The value of the 'X' variable formatted as two digit fixed precision value.</li>
+    <li><b>$(sprintf('%.2f',X))</b>: The value of the 'X' variable formatted as two digit fixed precision value.
+      The "sprintf" function follows the conventions of the same standard C function.</li>
     <li><b>$(abs(X)+abs(Y))</b>: The Manhattan distance of the ruler.</li>
     <li><b>$min(X,Y)</b>: The minimum of X and Y.</li>
+    <li><b>$(X) ($Y)</b>: the value of the X variable, followed by the value of the Y variables in brackets. 
+      This will give a string like "2.5 (-0.5)". Note 
+      that you cannot simply write "$X ($Y)" because the expression evaluation reads that as an attempt to call a 
+      function named "X".</li>
   </ul>
 
   <p>
@@ -85,9 +90,9 @@
   </p>
 
   <ul>
-    <li><b>DD:</b> The sum of all lengths.</li>
-    <li><b>LL:</b> The sum of all Manhattan.</li>
-    <li><b>XX:</b> The horizonal distance between first and current point.</li>
+    <li><b>DD:</b> The sum of all lengths up to the labelled segment.</li>
+    <li><b>LL:</b> The sum of all Manhattan up to the labelled segment.</li>
+    <li><b>XX:</b> The horizontal distance between first and current point.</li>
     <li><b>YY:</b> The vertical distance between first and current point.</li>
   </ul>