Update GUI documentation for bugs :

16841, 16202, 16203, 16842, 17694

doc/salome/gui/SMESH/input/constructing_meshes.doc

@@ -97,6 +97,13 @@ visualizing the mesh elements that cause it.
 <b>Publish Subshape</b> button allows importing it in a separate MED
 or UNV file.
 
+<b>NOTE</b> It is possible to define a 1D or a 2D mesh in a
+python script and then use such submeshes in the construction of a 3D
+mesh. For this, there exist two algorithms: <b>Use existing edges</b> and <b>Use
+existing faces</b>. They are not entirely usable from the GUI, so a
+mesh created using these algorithms should be exported into a python
+script, edited and then imported into the GUi. 
+
 Consider trying a sample script for construction of a mesh from our 
 \ref tui_creating_meshes_page "TUI Scripts" section.
 </li>

doc/salome/gui/SMESH/input/extrusion.doc

@@ -32,6 +32,8 @@ submesh,</li>
 <li>specify the vector along which the elements will be extruded,</li>
 <li>number of steps.</li>
 </ul>
+<li> <b>Generate Groups</b> checkbox allows copying the groups of
+elements of the source mesh to the newly created one. </li>
 </li>
 
 <li>Click the \b Apply or \b OK button.</li>

doc/salome/gui/SMESH/input/extrusion_along_path.doc

@@ -91,6 +91,8 @@ path</b> item or click <em>"Extrusion along a path"</em> button in the toolbar.
 The following dialog box will appear:
 
 \image html extrusion1.png
+
+\image html extrusion2.png
 </li>
 
 <li>In the dialog box you should:
@@ -108,6 +110,8 @@ or group</b>,
 <li><b>Start node</b> - the first or the last node on the edge. It is used to define the direction of extrusion </li>
 </ul>
 </li>
+<li> <b>Generate Groups</b> checkbox allows copying the groups of
+elements of the source mesh to the newly created one. </li>
 </ul>
 </li>
 

doc/salome/gui/SMESH/input/mesh_infos.doc

@@ -2,12 +2,8 @@
 
 \page mesh_infos_page Mesh infos
 
-\n There are two types of information boxes: <b>Standard Mesh
-Infos</b> and <b>Advanced Mesh Infos</b>.
-<ul>
-<li>\ref standard_mesh_infos_anchor "Standard"</li>
-<li>\ref advanced_mesh_infos_anchor "Advanced"</li>
-</ul>
+\n There are three information boxes: <b>Standard Mesh
+Infos</b>, <b>Advanced Mesh Infos</b> and <b> Mesh Element Info</b>.
 
 <br>
 \anchor standard_mesh_infos_anchor
@@ -33,7 +29,7 @@ The following information will be displayed:
 \anchor advanced_mesh_infos_anchor
 <h2>Advanced Mesh Infos</h2>
 
-The <b>Advanced Mesh Infos</b> gives more information about the mesh,
+The <b>Advanced Mesh Infos</b> box gives more information about the mesh,
 including the total number of faces and volumes and their geometrical
 types.
 \n To view the <b>Advanced Mesh Infos</b>, select your mesh or submesh
@@ -53,4 +49,15 @@ the information is displayed in Python Console.
 
 \image html b-mesh_infos.png
 
+<br>
+\anchor mesh_element_info_anchor
+<h2>Mesh Element Info</h2> 
+
+The <b>Mesh Element Info</b> box gives basic information about the
+type and the coordinates of the selected mesh element. 
+
+\image html eleminfo1.png
+
+\image html eleminfo2.png 
+
 */

doc/salome/gui/SMESH/input/projection_algos.doc

@@ -6,7 +6,8 @@
 object by the projection of another already meshed geometrical object.
 
 <b>Projection 1D</b> algorithm permits to define the mesh of an edge
-by the projection of another already meshed edge.
+(or group of edges)
+by the projection of another already meshed edge (or group of edges).
 \n To apply this algorithm select the edge to be meshed (indicated in
 the field \b Geometry of <b>Create mesh</b> dialog box),
 <b>Projection1D</b> in the list of 1D algorithms and click the
@@ -20,15 +21,21 @@ meshed source \b Edge and the \b Mesh (optional, use it if there are several
 different meshes on the same edge). It could also be necessary to
 define the orientation of edges, which is done by indicating the
 <b>Source Vertex</b> being the first point of the Source Edge and the 
-<b>Target Vertex</b> being the first point of the created \b Edge.
+<b>Target Vertex</b> being the first point of the created \b Edge. For
+a group of edges, <b>Source</b> and <b>Target</b> vertices should be
+shared by only one edge of the group. If <b>Source</b> and
+<b>Target</b> vectors are specified, the elements of the group must be ajacent.
 
-\n <b>Projection 2D</b> algorithm permits to define the mesh of a face by the
-projection of another already meshed face. This algorithm works only
+\n <b>Projection 2D</b> algorithm permits to define the mesh of a face
+(or group of faces) by the
+projection of another already meshed face (or group of faces). This
+algorithm works only
 if all edges of the target face have been meshed as 1D Projections of
 the edges of the source face.
 
 To apply this algorithm select the face to be meshed (indicated in the
-field \b Geometry of <b>Create mesh</b> dialog box), <b>Projection 2D</b> in the list
+field \b Geometry of <b>Create mesh</b> dialog box), <b>Projection
+2D</b> in the list
 of 2D algorithms and click the <em>"Add Hypothesis"</em> button. The
 following dialog box will appear:
 

doc/salome/gui/SMESH/input/revolution.doc

@@ -36,6 +36,8 @@ be revolved,</li>
 <li>number of steps,</li>
 <li>tolerance of rotation</li>
 </ul>
+<li> <b>Generate Groups</b> checkbox allows copying the groups of
+elements of the source mesh to the newly created one. </li>
 </li>
 
 <li>Click the \b Apply or \b OK button.</li>

doc/salome/gui/SMESH/input/rotation.doc

@@ -18,8 +18,12 @@ rotated and the rotation parameters:
 <li>\b Axis: point and vector</li>
 <li>\b Angle of rotation</li>
 </ul>
+<b>Create a Copy</b> checkbox allows creating a new mesh, the source
+mesh (or group of elements remains at its initial location).
+<b>Generate Groups</b> checkbox allows copying the groups of elements
+of the source mesh to the newly created one.
 \par
-<b>Create a copy</b> radio button allows to copy the rotated object.
+
 
 \image html rotation1.png
 

doc/salome/gui/SMESH/input/symmetry.doc

@@ -25,9 +25,11 @@ or some of its elements specifying:
 <li>one axis (point and vector)</li>
 <li>one plane (point and normal)</li>
 </ul>
+<b>Create a Copy</b> checkbox allows creating a new mesh, the source
+mesh (or group of elements remains at its initial location).  
+<b>Generate Groups</b> checkbox allows copying the groups of elements
+of the source mesh to the newly created one.
 \par
-<b>Create a copy</b> radio button allows to keep the initial elements or
-mesh.
 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_symmetry "Symmetry" operation.  

doc/salome/gui/SMESH/input/translation.doc

@@ -24,7 +24,10 @@ or some of its elements specifying:
 </ul>
 Toggle the corresponding checkbox to <b>Select whole mesh, submesh or
 group</b>.
-<b>Create a copy</b> button allows to copy the translated object.
+<b>Create a Copy</b> checkbox allows creating a new mesh, the source
+mesh (or group of elements remains at its initial location).
+<b>Generate Groups</b> checkbox allows copying the groups of elements
+of the source mesh to the newly created one.
 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_translation "Translation" operation.  

doc/salome/gui/SMESH/input/viewing_meshes_overview.doc

@@ -24,6 +24,8 @@ Object Browser, applying all recent changes. </li>
 more detailed information about the mesh.</li>
 <li>\ref standard_mesh_infos_anchor "Standard Mesh Infos" - provides
 basic information about the mesh.</li>
+<li>\ref mesh_element_info_anchor "Mesh Element Info" - provides basic
+information about the selected element of the mesh. </li>
 <li>\ref numbering_page "Numbering"  - allows to display the ID
 numbers of all meshing elements or nodes composing your mesh in the
 viewer.</li>
@@ -36,10 +38,10 @@ meshes.</li>
 <li>\ref transparency_page "Transparency" - allows to change the
 transparency of mesh elements.</li>
 <li>\ref clipping_page "Clipping" - allows to create cross-sections of the selected objects.</li>
-<li>\ref about_quality_controls_page "Quality Controls" - graphically
+<li>\ref about_quality_controls_page "Controls" - graphically
 presents various information about meshes.</li>
 <li><b>Hide</b> - allows to hide the selected mesh from the viewer.</li>
-<li><b>Display Only</b> -allows to display only the selected mesh, hiding all other from the viewer.</li>
+<li><b>Show Only</b> -allows to display only the selected mesh, hiding all other from the viewer.</li>
 <li><b>Dump view</b> - exports an object from the viewer in bmp, png, jpg or jpeg image format.</li>
 <li><b>Change background</b> - allows to redefine the background color. By default it is black.</li>
 </ul>