New upstream version 5.1.0upstream/5.1.0

1 files changed, 22 insertions, 9 deletions

diff --git a/app/doc/addm.but b/app/doc/addm.but
index cee8896..724e5fd 100644
--- a/app/doc/addm.but
+++ b/app/doc/addm.but
@@ -52,19 +52,19 @@ The \f{Add Menu} has all the actions related to adding track pieces to the layou
 
 \u000
 
-\dd \f{Block} - Create, edit or delete a block.
+\dd \f{Block} - Create a block.
 
 \u000
 
-\dd \f{Switchmotor} - Create, edit or delete a switchmotor.
+\dd \f{Switchmotor} - Create a switchmotor.
 
 \u000
 
-\dd \f{Signal} - Create, edit or delete a signal.
+\dd \f{Signal} - Create a signal.
 
 \u000
 
-\dd \f{Control} - Create a signal.
+\dd \f{Control} - Create a control.
 
 \u000
 
@@ -100,26 +100,36 @@ You can join to and from circles, after which they become curved tracks.
 
 \rule
 
-
 \S{cmdCurve} Curved Track
 
 \G{png.d/bcurve.png}
 
 Creating a curve is a two step operation.  The four methods (with their Shortcut keys) used to create a Curved Track are:
 
-\dd \G{png.d/bcurve1.png} (\c{Control-4}) Drag from one endpoint in the direction of the Curve at that point and release.  Click and Drag to position the second endpoint.
+\dd \G{png.d/bcurve1.png} (\c{Control-4}) Drag from one endpoint in the direction of the Curve at that point and release.  Click and Drag the red arrows to position the second endpoint. 
+If Shift is held down when the first endpoint is being placed and the cursor is on a track, the new curve end will "Snap" to the nearest open track endpoint and you can drag out the second end aligned to that track. After a track is competed, the new track will be connected to this first track.
 
 \u000
 
 \dd \G{png.d/bcurve2.png} (\c{Control-5}) Drag from one of the endpoints to the Center of the Curved track and release.  Click and Drag to position the second endpoint.
+If Shift is held down when the first endpoint is being placed and the cursor is on a track, the new curve end will "Snap" to the nearest open track endpoint and you can drag out the center at right angles aligned to that end. After a track is competed, the new track will be connected to this first track.
 
 \u000
 
 \dd \G{png.d/bcurve3.png} (\c{Control-6}) Drag from the Center of the Curved track to one of the endpoints and release.  Click and Drag to position the second endpoint.
+Shift has no effect.
 
 \u000
 
 \dd \G{png.d/bcurve4.png} (\c{Control-7}) Drag from one endpoint to the other endpoint to form the Chord of the Curve and release.  Click on the center of the track and Drag to form the Curve.
+Shift has no effect.
+
+\u000
+
+\dd \G{png.d/bezier.png} Place one endpoint and drag out the first control point and release, Place the second Endpoint and drag out the second control point and release. Once all 4 points are placed, you can pick one at a time and drag it to move it. Complete the Curve by pressing Enter, or Reject it with Esc.
+If Shift is held down when either endpoint is being placed it will "Snap" to an open track endpoint of the track underneath the cursor and you can only drag out the control point aligned to the end of the track. After the new track is competed, it will be connected to this existing track.
+
+\u000
 
 A drop down menu, which allows selection of the Curved Track creation method, is invoked from the down arrow button (\G{png.d/bmenu.png}) located on the right side the Curved track button. Dependent upon previous selection, the Curved Track button will look like \G{png.d/bcurve1.png}, \G{png.d/bcurve2.png}, \G{png.d/bcurve3.png} or \G{png.d/bcurve4.png}.
 
@@ -127,7 +137,7 @@ A drop down menu, which allows selection of the Curved Track creation method, is
 
 \dd \e{Curved Track Button Menu}
 
-In all cases, two Red arrow heads will be drawn after the first step to indicate where you can Drag to complete the second step.
+In all but the bezier case, two Red arrow heads will be drawn after the first step to indicate where you can Drag to complete the second step.
 
 A straight track will be created if the second endpoint is lined up with the first endpoint.
 
@@ -135,6 +145,10 @@ If the Snap Grid (\K{cmdGrid}) is enabled then the endpoints will be constrained
 
 Optionally, the curve center point and radius can be displayed for the Curve.  This is enabled by the Move Label (\K{cmdMoveLabel}) command.
 
+For Beziers, the active control point will be drawn in red and the available endpoints are shown with circles.  
+
+\f{Note:} You can also create Straight and Curved tracks using \k{cmdModify} by dragging out extra track from an open end-point.
+
 \rule
 
 
@@ -165,8 +179,6 @@ Note: the drawing is an approximation to show the location of the \e{Points} and
 
 \S{cmdHelix} Helix Track
 
-\G{png.d/bhelix.png}
-
 A helix track is used to change the elevation of track in a restricted space.  A helix is drawn as a circle of track, but in 3 dimensions it would resemble a cork screw or the pattern of threads on a bolt.
 
 \G{png.d/ahelix.png}
@@ -216,6 +228,7 @@ It is possible to create tracks that abut (the endpoints are very close and alig
 \G{png.d/bstraigh.png}
 
 Straight track is a created by selecting the first endpoint then dragging the cursor to the point where you want the second endpoint to be.
+If Shift is held down when the first endpoint is being placed and the cursor is on a track, the new straight end will "Snap" to the nearest open track endpoint and you can drag out the second end aligned to that track. After a track is competed, the new track will be connected to the existing track.
 
 If the Snap Grid (\K{cmdGrid}) is enabled then the endpoints will be constrained to the grid.