X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Fadd_point_on_edge_operation.doc;h=4a58ee64a66a01126f96464bef71a824b85ab7af;hb=9351fe0dfa570db0b1411ea63e7becb12a913944;hp=00951bcd0f81416578643f39dfb2b6f62b3f78d7;hpb=239f8109c64fa0c5a2e1d87a420bad5529b57f48;p=modules%2Fgeom.git

diff --git a/doc/salome/gui/GEOM/input/add_point_on_edge_operation.doc b/doc/salome/gui/GEOM/input/add_point_on_edge_operation.doc
index 00951bcd0..4a58ee64a 100644
--- a/doc/salome/gui/GEOM/input/add_point_on_edge_operation.doc
+++ b/doc/salome/gui/GEOM/input/add_point_on_edge_operation.doc
@@ -5,30 +5,42 @@
 \n To <b>Add Point on Edge</b> in the <b>Main Menu</b> select
 <b>Repair - > Add Point on Edge</b>.
 
-\n This operation splits an edge in two in accordance with the
+\n This operation splits an edge in two new edges in accordance with the
 specified mode (by length or by parameter) and a value specifying the
 position of the point on edge (for example val =0.5; mode =
-Length). This operation is available in <b>OCC Viewer</b> only.
+by length). This operation is available in <b>OCC Viewer</b> only.
 
 \n The \b Result will be a \b GEOM_Object.
 
 \n <b>TUI Command:</b> <em>geompy.DivideEdge(Shape, EdgeID, Value,
-IsByParameter), </em> where \em Shape is a shape which contains an edge to
-be divided, \em EdgeID is the ID of the edge to be divided, if it = -1,
-then Shape is an edge, \em Value is a paramter on the edge or a
-length. \em IsByParameter if it is True then Value is the edge parameter
-in the range [0:1] otherwise it is a part of the length of the edge in the range
-[0: full length of the edge]
-\n <b>Arguments:</b> Name + 1 Edge + 1 value setting the position of
+IsByParameter)</em>
+- \em Shape is a shape which contains an edge to be divided
+- \em EdgeID is the ID of the edge to be divided, if it is = -1, 
+then \em Shape should be an edge itself
+- \em Value is a value of parameter on edge or length parameter,
+depending on \em IsByParameter.
+- \em IsByParameter is a boolean flag, specifying operation mode:
+  - \c True: \em Value is treated as a curve parameter [0..1]
+  - \c False: \em Value is treated as a length parameter [0..1] 
+
+<b>Arguments:</b> Name + 1 Edge + 1 Value setting the position of
 the point according to one of the selected modes.
 
+The difference between "by parameter" and "by length" modes becomes
+apparent on the edges with irregular parametrization (for example,
+b-splines which usually have irregular density by the length).
+For example, value 0.5 "by length" on such edge will produce the point
+in the middle of this edge (equidistant from both its ends); the same
+0.5 value "by parameter" will result in the point situated closer to
+one of the ends (depending on the actual parametrization).
+
 \image html repair8.png
 
 \n <b>Example:</b>
 
-\image html image167.jpg
+\image html image167.png "The initial edge"
 
-\image html image168.jpg
+\image html image168.png "The edge split in two segments" 
 
 Our <b>TUI Scripts</b> provide you with useful examples of the use of 
 \ref tui_add_point_on_edge "Repairing Operations".