From 4bfa5eeb9323da266be02bc591d0d2eb8ce45570 Mon Sep 17 00:00:00 2001
From: eap <eap@opencascade.com>
Date: Tue, 6 May 2014 19:42:32 +0400
Subject: [PATCH] Re-review docs

---
 .../gui/SMESH/input/1d_meshing_hypo.doc       | 10 +++--
 doc/salome/gui/SMESH/input/cartesian_algo.doc | 35 ++++++++++------
 .../gui/SMESH/input/double_nodes_page.doc     | 41 ++++++++++++-------
 doc/salome/gui/SMESH/input/editing_groups.doc | 13 +++---
 .../gui/SMESH/input/grouping_elements.doc     | 12 ++++--
 .../gui/SMESH/input/mesh_through_point.doc    | 18 +++++---
 doc/salome/gui/SMESH/input/split_to_tetra.doc |  2 +-
 7 files changed, 84 insertions(+), 47 deletions(-)

diff --git a/doc/salome/gui/SMESH/input/1d_meshing_hypo.doc b/doc/salome/gui/SMESH/input/1d_meshing_hypo.doc
index ac0902ec1..72d006bfc 100644
--- a/doc/salome/gui/SMESH/input/1d_meshing_hypo.doc
+++ b/doc/salome/gui/SMESH/input/1d_meshing_hypo.doc
@@ -68,10 +68,12 @@ Lk-1 * d) starting from a given <b>Start Length</b> and  <b>Common Ratio</b>.
 
 The splitting direction is defined by the orientation of the
 underlying geometrical edge.
-<b>Reverse Edges</b> list box allows specifying the edges, for which the splitting should be made in the
-direction opposite to their orientation. This list box is filled after a geometry object is selected for meshing. In this case it is possible to select edges to be reversed either directly picking them in
-the 3D viewer or by selecting the edges or groups of edges in the
-Object Browser. 
+<b>Reverse Edges</b> list box allows specifying the edges, for which
+the splitting should be made in the direction opposite to their
+orientation. This list box is usable only if a geometry object is
+selected for meshing. In this case it is possible to select edges to
+be reversed either directly picking them in the 3D viewer or by
+selecting the edges or groups of edges in the Object Browser. 
 
 \image html a-geometric1d.png
 
diff --git a/doc/salome/gui/SMESH/input/cartesian_algo.doc b/doc/salome/gui/SMESH/input/cartesian_algo.doc
index 6062aa89e..4d00c577f 100644
--- a/doc/salome/gui/SMESH/input/cartesian_algo.doc
+++ b/doc/salome/gui/SMESH/input/cartesian_algo.doc
@@ -29,7 +29,8 @@ nodes are inside and some outside. </li>
 </li>
 </ol>
 To apply this algorithm when you define your mesh, select <b>Body
-  Fitting</b> in the list of 3D algorithms and add <b>Body Fitting Parameters</b> hypothesis. The following dialog will appear:
+  Fitting</b> in the list of 3D algorithms and add <b>Body Fitting
+  Parameters</b> hypothesis. The following dialog will appear:
 
 <br>
 \anchor cartesian_hyp_anchor
@@ -50,10 +51,12 @@ This dialog allows to define
   
 \image html cartesian_implement_edge.png "Implement Edges switched off to the left and on to the right"
 
-  <li> <b>Definition mode</b> allows choosing how Cartesian structured grid is defined. Location of nodes along each grid axis is defined individually:
+  <li> <b>Definition mode</b> allows choosing how Cartesian structured
+  grid is defined. Location of nodes along each grid axis is defined
+  individually:
     <ul>
       <li> You can specify the \b Coordinates of grid nodes. \b Insert button
-        inserts a node at  \b Step distance(negative or positive) from the
+        inserts a node at \b Step distance (negative or positive) from the
         selected node. \b Delete button removes the selected node. Double
         click on a coordinate in the list enables its edition. 
         \b Note that node coordinates are measured along directions of
@@ -63,7 +66,7 @@ This dialog allows to define
         <em>f(t)</em> where \a t is a position along a grid axis
         normalized at [0.0,1.0]. The whole range of geometry can be
         divided into sub-ranges with their own spacing formulas to apply;
-    \a t varies between 0.0 and 1.0 within each sub-range. \b Insert button
+        \a t varies between 0.0 and 1.0 within each sub-range. \b Insert button
         divides a selected range into two. \b Delete button adds the
         selected sub-range to the previous one. Double click on a range in
         the list enables edition of its right boundary. Double click on a
@@ -71,14 +74,22 @@ This dialog allows to define
     </li> </ul>
   </li>
   
-  <li> <b> Fixed Point</b> group allows defining an exact location of a grid node in the direction defined by spacing. The following cases are possible:
-<ul>
-<li>If all three directions are defined by spacing, there will be a mesh node at  the <b> Fixed Point</b>. </li>
-<li>If two directions are defined by spacing, there will be at least a link between mesh nodes passing through    the <b> Fixed Point</b>.</li>
-<li> If only one direction is defined by spacing, there will be at least an element facet passing through the <b> Fixed Point</b>.</li> 
-<li>If no directions are defined by spacing, <b> Fixed Point</b> is disabled.</li>
-</ul>
-</li>
+  <li> <b> Fixed Point</b> group allows defining an exact location of
+  a grid node in the direction defined by spacing. The following cases
+  are possible:
+    <ul>
+      <li>If all three directions are defined by spacing, there will
+      be a mesh node at the <b> Fixed Point</b>. </li>
+      <li>If two directions are defined by spacing, there will be at
+      least a link between mesh nodes passing through the <b> Fixed
+      Point</b>.</li> 
+      <li> If only one direction is defined by spacing, there will be
+      at least an element facet passing through the <b> Fixed
+      Point</b>.</li>
+      <li>If no directions are defined by spacing, <b> Fixed Point</b>
+      is disabled.</li>
+    </ul>
+  </li>
 	
   <li> <b> Directions of Axes</b> group allows setting the directions of grid axes.
     <ul>
diff --git a/doc/salome/gui/SMESH/input/double_nodes_page.doc b/doc/salome/gui/SMESH/input/double_nodes_page.doc
index 9c3983f01..ce643d326 100644
--- a/doc/salome/gui/SMESH/input/double_nodes_page.doc
+++ b/doc/salome/gui/SMESH/input/double_nodes_page.doc
@@ -110,19 +110,19 @@ This mode duplicates the given elements, i.e. creates new elements with the same
 
 Parameters to be defined in this mode:
 <ul>
-<li><b>Group of elements to duplicate</b> (<em>mandatory</em>): these
-  elements will be duplicated.</li> 
-<li><b>Construct group with newly created elements</b> option
-  (<em>checked by default</em>): if checked - the group of newly created
-  elements will be built. The name of the created group starts from
-  "DoubleElements".</li>
+  <li><b>Group of elements to duplicate</b> (<em>mandatory</em>): these
+    elements will be duplicated.</li>
+  <li><b>Construct group with newly created elements</b> option
+    (<em>checked by default</em>): if checked - the group of newly created
+    elements will be built. The name of the created group starts from
+    "DoubleElements".</li>
 </ul>
 
 <br>
 \anchor mode_group_boundary_anchor
 <h2>Duplicate nodes on group boundaries</h2>
 
-This mode duplicates nodes located on boundaries between given groups of volumes. 
+This mode duplicates nodes located on boundaries between given groups of volumes.
 
 <br>
 
@@ -130,13 +130,26 @@ This mode duplicates nodes located on boundaries between given groups of volumes
 
 Parameters to be defined in this mode:
 <ul>
-<li><b>Groups of volumes</b> (<em>mandatory</em>): list of volume
-  groups. These groups should be disjoint, i.e. should not have shared volumes.</li>
-<li> If <b>Create joint elements</b> option is activated, flat elements are created on the duplicated
-nodes: a triangular facet shared by two volumes of two groups generates
-a flat prism, a quadrangular facet generates a flat hexahedron.</li>
-<li> If <b>On all boundaries</b> : option is activated, the volumes, which are not
-  included into <b>Groups of volumes</b>, are considered as another group and thus the nodes on the boundary between <b>Groups of volumes</b> and the remaining mesh are also duplicated.</li>
+  <li><b>Groups of volumes</b> (<em>mandatory</em>): list of volume
+    groups. These groups should be disjoint, i.e. should not have shared
+    volumes.</li>
+  <li> If <b>Create joint elements</b> option is activated, flat
+    elements are created on the duplicated nodes: a triangular facet
+    shared by two volumes of two groups generates a flat prism, a
+    quadrangular facet generates a flat hexahedron.
+    <br>
+    The created flat volumes are stored in groups. These groups are named
+    according to the position of the group in the list of groups: group
+    "j_n_p" is a group of flat elements that are built between the group \#n
+    and the group \#p in the group list. All the flat elements are gathered
+    into the group named "joints3D". The flat element of the multiple
+    junctions between the simple junction are stored in a group named
+    "jointsMultiples".</li>
+  <li> If <b>On all boundaries</b> option is activated, the volumes,
+    which are not included into <b>Groups of volumes</b>, are considered
+    as another group and thus the nodes on the boundary
+    between <b>Groups of volumes</b> and the remaining mesh are also
+    duplicated.</li>
 </ul>
 
 <br><b>See Also</b> a sample TUI Script of a
diff --git a/doc/salome/gui/SMESH/input/editing_groups.doc b/doc/salome/gui/SMESH/input/editing_groups.doc
index ca9b7a222..18b8ef654 100644
--- a/doc/salome/gui/SMESH/input/editing_groups.doc
+++ b/doc/salome/gui/SMESH/input/editing_groups.doc
@@ -10,14 +10,15 @@ the <b>Edit Group</b> item or <em>"Edit Group"</em> button in the toolbar.</li>
 \image html image74.gif
 <center><em>"Edit Group" button</em></center>
 
-The following dialog box will appear:
+The following dialog box will appear (if the selected group
+is <em>standalone</em>, else this dialog looks different):
 
 \image html editgroup.png
 
 In this dialog box you can modify the name and the color of your group
-despite of its type. You can add or remove the elements forming a
+despite of its type. You can add or remove the elements composing a
 <em>standalone group</em>. You can change criteria of the filter of
-the <em>group on filter</em>. For more information see
+a <em>group on filter</em>. For more information see
 \ref creating_groups_page "Creating Groups" page.
 
 <li>Click the \b Apply or <b>Apply and Close</b> button to confirm
@@ -28,14 +29,14 @@ modification of the group.</li>
 <em>To convert an existing group on geometry or a group on filer into
 a standalone group of elements and modify:</em>
 <ol>
-<li>Select your group on geometry (or your group on filter) in the
+<li>Select your group on geometry (or on filter) in the
 Object Browser and in the \b Mesh menu click the <b>Edit Group as
-Standalone</b> item.</li> 
+Standalone</b> item.</li>
 
 \image html image74.gif
 <center><em>"Edit Group as Standalone" button</em></center>
 
-The selected group will be converted into a standalone group and 
+The selected group will be converted into a standalone group and
 its contents can be modified.
 
 <li>Click the \b Apply or <b>Apply and Close</b> button to confirm modification of the
diff --git a/doc/salome/gui/SMESH/input/grouping_elements.doc b/doc/salome/gui/SMESH/input/grouping_elements.doc
index c6a97e165..c6905cdce 100644
--- a/doc/salome/gui/SMESH/input/grouping_elements.doc
+++ b/doc/salome/gui/SMESH/input/grouping_elements.doc
@@ -3,8 +3,9 @@
 \page grouping_elements_page Grouping elements
 
 In Mesh module it is possible to create groups of mesh elements:
-nodes, edges, faces or volumes. One group contains elements of only
-one type. The following ways of creation are possible:
+nodes, edges, faces, volumes, 0D elements or balls. One group contains
+elements of only one type. The following ways of creation are
+possible:
 
 - by selecting the elements using filters and/or directly on the 
   presentation in the VTK viewer, and/or by using elements of other
@@ -32,11 +33,14 @@ The created groups can be later:
 - \subpage using_operations_on_groups_page "Subjected to Boolean operations"
 - \subpage deleting_groups_page "Deleted"
 
-If sub-meshes or groups container item has more than one child sub-object, it is possible to sort the children in ascending order. For this, select the parent object in the Object Browser and choose <b>Sort children</b> context menu item.
+In the Object Browser, if groups or sub-meshes container item has more
+than one child sub-object, it is possible to sort the children in
+ascending order. For this, select the parent object in the Object
+Browser and choose <b>Sort children</b> context menu item. 
 
 \image html smesh_sort.png "Sorting of sub-objects"
 
 An important tool, providing filters for creation of \b Standalone
-groups is \ref selection_filter_library_page.
+groups and groups <b>On Filter</b> is \ref selection_filter_library_page.
 
 */
diff --git a/doc/salome/gui/SMESH/input/mesh_through_point.doc b/doc/salome/gui/SMESH/input/mesh_through_point.doc
index 679d629b4..a86e6986b 100644
--- a/doc/salome/gui/SMESH/input/mesh_through_point.doc
+++ b/doc/salome/gui/SMESH/input/mesh_through_point.doc
@@ -21,13 +21,19 @@ The following dialog will appear:
 \image html meshtopass2.png "Automatic node selection"
 
 </li>
-<li>Specify the way of node selection: manually (the first radio button) or automatically (the second radio button).</li>
-
-<li>If the manual method is selected, select the necessary node (X, Y, Z fields show the original coordinates of the node to move) or set the node ID.</li>
+<li>Specify the way of node selection: manually (the first radio
+  button) or automatically (the second radio button).</li>
+<li>If the manual method is selected, select the necessary node (X, Y,
+  Z fields show the original coordinates of the node to move) or type
+  the node ID.</li>
 <li>Enter the coordinates of the destination point.</li>
-<li>Click <b>Update Destination</b> button to update the coordinates of the destination point.</li>
-<li>Activate \b Preview check-box to show the result of move in the viewer</li>
-<li>Click the \b Apply or <b>Apply and Close</b> button to confirm the operation.</li>
+<li>Click <b>Update Destination</b> button to set the coordinates
+  of the destination point equal to the coordinates of the node to
+  move.</li>
+<li>Activate \b Preview check-box to show the result of move in the
+  viewer.</li>
+<li>Click the \b Apply or <b>Apply and Close</b> button to confirm the
+  operation.</li>
 </ol>
 
 \image html moving_nodes1.png "The initial mesh"
diff --git a/doc/salome/gui/SMESH/input/split_to_tetra.doc b/doc/salome/gui/SMESH/input/split_to_tetra.doc
index 187af8b89..fb5c4e165 100644
--- a/doc/salome/gui/SMESH/input/split_to_tetra.doc
+++ b/doc/salome/gui/SMESH/input/split_to_tetra.doc
@@ -38,7 +38,7 @@ First it is possible to select the type of operation:
   
 <li>If \b Tetrahedron element type is selected, <b> Split hexahedron </b> group allows specifying the number of tetrahedra  a hexahedron will be split into. If the chosen method does not allow to get a conform mesh, a generic solution is applied: an additional node is created at the gravity center of a hexahedron, serving an apex of tetrahedra, all quadrangle sides of the hexahedron are split into two triangles each serving a base of a new tetrahedron.</li> 
 
-<li>If \Prism element type is selected, the <b>Split hexahedron</b> group looks as follows:
+<li>If \b Prism element type is selected, the <b>Split hexahedron</b> group looks as follows:
 
 \image html split_into_prisms.png
 
-- 
2.30.2