Help Update for version 7.6.0

doc/salome/gui/SMESH/input/1d_meshing_hypo.doc

@@ -5,31 +5,31 @@
 Basic 1D hypothesis specifies:
 <ul>
 <li>how \ref a1d_algos_anchor "Wire Discretization" should divide the edge;</li>
-<li>how \ref a1d_algos_anchor "Composite Side Discretization" should divide the group of C1-continues edges.</li>
+<li>how \ref a1d_algos_anchor "Composite Side Discretization" should divide the group of C1-continuous edges.</li>
 </ul>
 
-By type of nodes distribution the 1D hypotheses can be categorized as follows:
+1D hypotheses can be categorized by type of nodes distribution as follows:
 <ul>
-<li>Uniform distribution
+<li>Uniform distribution:
   <ul>
     <li>\ref average_length_anchor "Local Length"</li>
     <li>\ref max_length_anchor "Max Size"</li>
     <li>\ref number_of_segments_anchor "Number of segments" with Equidistant distribution</li>
     <li>\ref automatic_length_anchor "Automatic Length"</li>
 </ul></li>
-<li>Constantly increasing or decreasing length of segments
+<li>Constantly increasing or decreasing length of segments:
   <ul>
     <li>\ref arithmetic_1d_anchor "Arithmetic 1D"</li>
     <li>\ref geometric_1d_anchor "Geometric Progression"</li>
     <li>\ref start_and_end_length_anchor "Start and end length"</li>
     <li>\ref number_of_segments_anchor "Number of segments" with Scale distribution</li>
 </ul></li>
-<li>Distribution depending on curvature
+<li>Distribution depending on curvature:
   <ul>
     <li>\ref adaptive_1d_anchor "Adaptive"</li>
     <li>\ref deflection_1d_anchor "Deflection 1D"</li>
 </ul></li>
-<li>Arbitrary distribution
+<li>Arbitrary distribution:
   <ul>
     <li>\ref fixed_points_1d_anchor "Fixed points 1D"</li>
     <li>\ref number_of_segments_anchor "Number of segments" with
@@ -316,7 +316,7 @@ possible to select the edges to be reversed either directly picking them in
 the 3D viewer or selecting the edges or groups of edges in the
 Object Browser.
 
-\ref reversed_edges_helper_anchor "Helper" group assists you in
+\ref reversed_edges_helper_anchor "Helper" group assists in
 defining <b>Reversed Edges</b> parameter.
 
 
@@ -330,23 +330,23 @@ defining <b>Reversed Edges</b> parameter.
 
 \image html rev_edges_helper_dlg.png
 
-\b Helper group assists you in defining <b>Reversed Edges</b>
+\b Helper group assists in defining <b>Reversed Edges</b>
 parameter of the hypotheses depending on edge direction.
 
-<b>Show whole geometry</b> check-box lets you see the whole
+<b>Show whole geometry</b> check-box allows seeing the whole
-geometrical model in the 3D Viewer. This can help you to understand
+geometrical model in the 3D Viewer, which can help to understand the
-location within the model of a set of edges shown in the Viewer.
+location of a set of edges within the model.
 
-<b>Propagation chains</b> group helps you to define 
+<b>Propagation chains</b> group allows defining <b>Reversed Edges</b>
-<b>Reversed Edges</b> so that opposite edges of quadrilateral faces
+for splitting opposite edges of quadrilateral faces
-will be split in the logically same direction. When this group is
+in a logically uniform direction. When this group is
 activated, the list is filled with propagation chains found within the
-model. When you select a chain in the list, edges of the chain are
+model. When a chain is selected in the list its edges are
-shown in the Viewer with arrows so that you can chose a common
+shown in the Viewer with arrows, which enables choosing a common
-direction for all chain edges. \b Reverse button inverses the common
+direction for all chain edges. \b Reverse button inverts the common
-direction of chain edges. If \b Add button is active, this means that some
+direction of chain edges. If \b Add button is active, some
-edges of a chain have different direction and you can click \b Add
+edges of a chain have a different direction, so you can click \b Add
-button to add such edges to <b>Reversed Edges</b> list.
+button to add them to <b>Reversed Edges</b> list.
 
 \image html propagation_chain.png "The whole geometry and a propagation chain"
 

doc/salome/gui/SMESH/input/2d_meshing_hypo.doc

@@ -26,9 +26,9 @@ which will compose the mesh of these faces.
 \anchor length_from_edges_anchor
 <h2>Length from Edges</h2>
 
-<b>Length from edges</b> hypothesis defines maximum linear size of
+<b>Length from edges</b> hypothesis defines the maximum linear size of
-mesh faces as an average length of mesh edges approximating a boundary
+mesh faces as an average length of mesh edges approximating
-of a face being meshed.
+the meshed face boundary.
 
 <b>See Also</b> a sample TUI Script of a 
 \ref tui_length_from_edges "Length from Edges" hypothesis operation.
@@ -113,7 +113,7 @@ of the enforced nodes.
     projected to the meshed face and located close enough to the
     meshed face will be used to create the enforced nodes.</li>
 </ul>
-\note <b>Enforced nodes</b> can't be created at \b Reduced transition type.
+\note <b>Enforced nodes</b> cannot be created at \b Reduced transition type.
 
 Let us see how the algorithm works:
 <ul>

doc/salome/gui/SMESH/input/about_filters.doc

@@ -26,7 +26,7 @@ about selection filters and their usage in GUI.
 - In Python scripts, filters can be used to choose only some mesh
   entities (nodes or elements) for the operations, which require the
   list of entities as input parameter (create/modify group, remove
-  nodes/elements, etc) and for the operations, which accept objects as
+  nodes/elements, etc) and for the operations, which accept objects
   as input parameter. The page \ref tui_filters_page provides
   examples of the filters usage in Python scripts.
 */

doc/salome/gui/SMESH/input/about_hypo.doc

@@ -14,17 +14,16 @@ The choice of a hypothesis depends on the selected algorithm.
 
 Hypotheses are created during creation and edition of 
 \ref constructing_meshes_page "meshes" and
-\ref constructing_submeshes_page "sub-mesh". 
+\ref constructing_submeshes_page "sub-meshes". 
-Once created a hypotheses can be reused during creation and
+Once created a hypotheses can be reused during creation and edition of
-edition of other meshes and sub-meshes. All created hypotheses and
+other meshes and sub-meshes. All created hypotheses and algorithms are
-algorithms are present in the Object Browser in \a Hypotheses and
+present in the Object Browser in \a Hypotheses and \a Algorithms
-\a Algorithms folders correspondingly. From the context menu of the
+folders correspondingly. It is possible to open a dialog to modify the
-hypothesis you can invoke a dialog for modification of its parameters,
+parameters of a hypothesis from its context menu. This menu also
-and \b Unassign command that will unassign the hypothesis from all
+provides \b Unassign command that will unassign the hypothesis from
-the meshes and sub-meshes using it.
+all meshes and sub-meshes using it. Modification of any parameter of a
-Modification of any hypothesis parameter and unassignment of a
+hypothesis and its unassignment leads to automatic removal of elements
-hypothesis leads to automatic removal of elements generated with use
+generated using it.
-of this hypothesis.
 
 In \b MESH there are the following Basic Hypotheses:
 <ul>

doc/salome/gui/SMESH/input/about_meshes.doc

@@ -19,29 +19,29 @@ Mesh module provides several ways to create the mesh:
 
     Construction of \subpage constructing_submeshes_page "sub-meshes"
     allows to discretize some sub-shapes of the main shape, for example a face,
-    using different meshing parameters than other sub-shapes.<br>
+    using the meshing parameters that differ from those for other sub-shapes.<br>
     Meshing parameters of meshes and sub-meshes can be 
     \subpage editing_meshes_page "edited". (Upon edition only mesh entities
     generated using changed meshing parameters are removed and will be
     re-computed).<br>
-    \note Algorithms and hypotheses used at mesh level are referred as
+    \note Algorithms and hypotheses used at mesh level are referred to as
-    \a global ones and those used at sub-mesh level are referred as \a
+    \a global ones and those used at sub-mesh level are referred to as \a
     local ones.
   </li>
   <li>Bottom-up way, using \ref modifying_meshes_page "mesh modification"
     operations, especially \ref extrusion_page "extrusion" and \ref
-    revolution_page "revolution". To create an empty mesh not based on
+    revolution_page "revolution". To create an empty mesh not based on a
     geometry, use the same dialog as to \ref constructing_meshes_page
-    "construct the mesh on geometry" but do not specify any geometry
+    "construct the mesh on geometry" but do not specify a geometry
-    nor meshing algorithm.
+    or a meshing algorithm.
   </li>
-  <li>The mesh can be \ref importing_exporting_meshes_page "imported" from
+  <li>The mesh can be \subpage importing_exporting_meshes_page "imported" from
     (and exported to) the file in MED, UNV, STL, CGNS, DAT, GMF and
     SAUVE formats.
   </li>
   <li>The 3D mesh can be generated from the 2D mesh, \ref
     importing_exporting_meshes_page "imported" or manually created. To
-    setup the meshing parameters of a mesh not based on geometry, just
+    setup the meshing parameters of a mesh not based on a geometry, just
     invoke \ref editing_meshes_page "Edit mesh / sub-mesh" command on
     your 3D mesh.
   </li>
@@ -66,29 +66,29 @@ Attractive meshing capabilities include:
   sub-meshes.
 
 The \b structure of a SALOME mesh is described by nodes and elements based on
-these nodes. Geometry of the element is defined by the sequence of
+these nodes. The geometry of an element is defined by the sequence of
 nodes constituting it and
 the <a href="http://www.code-aster.org/outils/med/html/connectivites.html">
   connectivity convention </a> (adopted from MED library). Definition of
-the element basing on elements of lower dimension is NOT supported.
+the element basing on the elements of a lower dimension is NOT supported.
 
 \anchor mesh_entities
 The mesh can include the following entities:
 <ul>
-<li>\b Node &mdash; an entity of a mesh defining a position in 3D
+<li>\b Node &mdash; a mesh entity defining a position in 3D
   space with coordinates (x, y, z).</li>
-<li>\b Edge (or segment) &mdash; 1D element of a mesh linking two nodes.</li>
+<li>\b Edge (or segment) &mdash; 1D mesh element linking two nodes.</li>
-<li>\b Face &mdash; 2D element of a mesh representing a part of
+<li>\b Face &mdash; 2D mesh element representing a part of
   surface bound by links between face nodes. A face can be a
   triangle, quadrangle or polygon.</li>
-<li>\b Volume &mdash; 3D element of a mesh representing a part of 3D
+<li>\b Volume &mdash; 3D mesh element representing a part of 3D
   space bound by volume facets. Nodes of a volume describing each
   facet are defined by
   the <a href="http://www.code-aster.org/outils/med/html/connectivites.html">
   MED connectivity convention.</a> A volume can be a tetrahedron, hexahedron,
   pentahedron, pyramid, hexagonal prism or polyhedron.</li>
-<li>\b 0D element &mdash; element of a mesh defined by one node.</li>
+<li>\b 0D element &mdash; mesh element defined by one node.</li>
-<li>\b Ball element &mdash; discrete element of a mesh defined by a
+<li>\b Ball element &mdash; discrete mesh element defined by a
   node and a diameter.</li>
 </ul>
 
@@ -97,7 +97,7 @@ generated on (if any). The node generated on the geometrical edge or
 surface in addition stores its position in parametric space of the
 associated geometrical entity.
 
-SALOME supports elements of second order, without central node
+SALOME supports elements of second order, without a central node
 (quadratic triangle, quadrangle, tetrahedron, hexahedron, pentahedron
 and pyramid) and with central nodes (bi-quadratic triangle and
 quadrangle and tri-quadratic hexahedron).<br>

doc/salome/gui/SMESH/input/additional_hypo.doc

@@ -31,12 +31,13 @@ The following additional hypothesis are available:
 <h2>Propagation of 1D Hypothesis on opposite edges</h2>
 
 <b>Propagation of 1D Hypothesis on opposite edges</b> allows to mesh
-opposite sides of a quadrangle face, and of other adjacent quadrangles,
+opposite sides of a quadrangle face and other adjacent quadrangles,
-using the same hypothesis assigned to one edge only.<br>
+using the same hypothesis assigned to only one edge.<br>
-Thus you define a sub-mesh on an edge where you define 1D meshing
+Thus you define a sub-mesh on the edge where you define 1D meshing
-parameters and a \b Propagation hypothesis. These local meshing
+parameters and the \b Propagation hypothesis. These local meshing
 parameters will be propagated via opposite sides of quadrangles to the
-whole geometry, or till an edge with other local meshing parameters.
+whole geometry, and this propagation stops at an edge with other local
+meshing parameters.
 
 This hypothesis can be taken into account by 
 \ref a1d_algos_anchor "Wire Discretization" and 
@@ -84,17 +85,17 @@ computations.
 <li><b>Stretch factor</b> - defines the growth factor of element height
   from the mesh boundary inwards.</li>
 <li><b>Extrusion method</b> (available in 3D only) - defines how
-  position of nodes are found during prism construction and how
+  positions of nodes are found during prism construction and how
-  creation of distorted and intersecting prisms is prevented.
+  the creation of distorted and intersecting prisms is prevented.
-<ul><li><b>Surface offset + smooth</b> method extrudes nodes along normal
+<ul><li><b>Surface offset + smooth</b> method extrudes nodes along the normal
-    to underlying geometrical surface. Smoothing of internal surface of
+    to the underlying geometrical surface. Smoothing of the internal surface of
     element layers is possible to avoid creation of invalid prisms.</li>
-  <li><b>Face offset</b> method extrudes nodes along average normal of
+  <li><b>Face offset</b> method extrudes nodes along the average normal of
-    surrounding mesh faces till intersection with a neighbor mesh face
+    surrounding mesh faces to the intersection with a neighbor mesh face
-    translated along its own normal by the layers thickness. Thickness
+    translated along its own normal by the thickness of layers. The thickness
     of layers can be limited to avoid creation of invalid prisms.</li>
-  <li><b>Node offset</b> method extrudes nodes along average normal of
+  <li><b>Node offset</b> method extrudes nodes along the average normal of
-    surrounding mesh faces by the layers thickness. Thickness of
+    surrounding mesh faces by the thickness of layers. The thickness of
     layers can be limited to avoid creation of invalid prisms.</li> 
 \image html viscous_layers_extrusion_method.png "Prisms created by the tree extrusion methods at the same other parameters"
 </ul></li>
@@ -107,9 +108,9 @@ computations.
   Faces (or edges) can be selected either in the Object Browser or in
   the VTK Viewer.
   \note A mesh shown in the 3D Viewer can prevent selection of faces
-  and edges, just hide the mesh to avoid this. Sometimes a face to
+  and edges, just hide the mesh to avoid this. If a face, which should be
-  select is hidden by other faces, in this case consider creating a
+  selected, is hidden by other faces, consider creating a
-  group of faces you want to select in the Geometry module.<br>
+  group of faces to be selected in the Geometry module.<br>
   To avoid a long wait when a
   geometry with many faces (or edges) is displayed, the number of faces
   (edges) shown at a time is limited by the value of "Sub-shapes
@@ -150,12 +151,12 @@ computations.
 
 Quadratic Mesh hypothesis allows to build a quadratic mesh (in which
 links between element nodes are not straight but curved lines due to
-presence of an additional midside node).
+presence of an additional mid-side node).
 
 This 1D hypothesis can be taken into account by 
 \ref a1d_algos_anchor "Wire Discretization" and 
 \ref a1d_algos_anchor "Composite Side Discretization" algorithms. To
-make a quadratic mesh assign this hypothesis at 
+create a quadratic mesh assign this hypothesis at 
 \ref constructing_meshes_page "mesh construction".
 
 See \ref adding_quadratic_elements_page
@@ -168,9 +169,13 @@ for more information about quadratic meshes.
 This additional hypothesis can be used together with 2D triangulation algorithms.
 It allows 2D triangulation algorithms to build quadrangular meshes.
 
-When used with "Quadrangle (Mapping)" meshing algorithm, that is obsolete
+Usage of this hypothesis with "Quadrangle (Mapping)" meshing algorithm
- since introducing \ref hypo_quad_params_anchor "Quadrangle parameters" 
+is obsolete since introducing
-hypothesis, this hypothesis has one restriction on its work: the total quantity of 
+\ref hypo_quad_params_anchor "Quadrangle parameters" hypothesis.
-segments on all four sides of the face must be even (divisible by 2).
+Usage of this hypothesis with "Quadrangle (Mapping)" meshing algorithm
-
+corresponds to specifying "Quadrangle Preference" transition type of
+\ref hypo_quad_params_anchor "Quadrangle parameters" hypothesis.
+\note "Quadrangle Preference" transition type can be used only if the
+total quantity of segments on all sides of the face is even (divisible
+by 2), else "Standard" transition type is used.
 */

doc/salome/gui/SMESH/input/basic_meshing_algos.doc

@@ -7,7 +7,7 @@ used for meshing entities (1D, 2D, 3D sub-shapes) composing
 geometrical objects.
 
 An algorithm represents either an implementation of a certain meshing
-technique or a interface to a whole meshing program generating elements
+technique or an interface to the whole meshing program generating elements
 of several dimensions.
 
 <ul>
@@ -17,10 +17,10 @@ of several dimensions.
 <li><em>Wire Discretization</em> meshing algorithm - splits an edge into a
 number of mesh segments following an 1D hypothesis.
 </li>
-<li><em>Composite Side Discretization</em> algorithm - allows to apply an 1D
+<li><em>Composite Side Discretization</em> algorithm - allows to apply a 1D
   hypothesis to a whole side of a geometrical face even if it is
-  composed of several edges provided that they form C1 curve and form
+  composed of several edges provided that they form C1 curve in all
-  one side in all faces of the main shape.</li>
+  faces of the main shape.</li>
 </ul>
 
 <li>For meshing of 2D entities (<b>faces</b>):</li>

doc/salome/gui/SMESH/input/borders_at_multi_connection.doc

@@ -2,8 +2,8 @@
 
 \page borders_at_multi_connection_page Borders at multi-connection
 
-\n This mesh quality control highlights segments according to number
+\n This mesh quality control highlights segments according to the number
-of elements, faces and volumes, the segment belongs to.
+of elements, faces and volumes, to which the segment belongs.
 
 \image html image151.gif
 

doc/salome/gui/SMESH/input/borders_at_multi_connection_2d.doc

@@ -3,7 +3,7 @@
 \page borders_at_multi_connection_2d_page Borders at multi-connection 2D
 
 \n This mesh quality control highlights borders of faces (links
-between nodes) according to number of faces the link belongs to.
+between nodes) according to the number of faces, to which the link belongs.
 
 \image html image127.gif
 

doc/salome/gui/SMESH/input/building_compounds.doc

@@ -4,10 +4,10 @@
 
 \n Compound Mesh is a combination of several meshes. All elements and
 groups present in input meshes are present in the compound
-mesh. Neither geometry nor hypotheses of initial meshes are used by
+mesh. However, it does not use geometry or hypotheses of the initial meshes. 
-the compound mesh. No link between input meshes and a compound mesh is
+The links between the input meshes and the compound mesh are not
-supported, so that modification of an input mesh does not lead to
+supported, consequently the modification of an input mesh does not lead to
-update of the compound mesh.
+the update of the compound mesh.
 
 <em>To Build a compound mesh:</em>
 
@@ -27,15 +27,16 @@ The following dialog box will appear:
 <ul>
   <li>\b Name - allows selecting the name of the resulting \b Compound mesh.</li>
   <li><b>Meshes, sub-meshes, groups</b> - allows selecting the meshes,
-    sub-meshes and groups which will be concatenated. They can be
+    sub-meshes and groups to be concatenated. They can be
     chosen in the Object Browser while holding \b Ctrl button.</li>
   <li><b>Processing identical groups</b> - allows selecting the method
     of processing the namesake groups existing in the input meshes.
     They can be either <ul>
-      <li>\b United - all elements of Group1 of Mesh_1 and Group1 of Mesh_2
+      <li>\b United - all elements of \em Group1 of \em Mesh_1 and \em
-        become the elements of Group1 of the Compound_Mesh, or</li>
+      Group1 of \em Mesh_2 become the elements of \em Group1 of the
-      <li>\b Renamed - Group1 of Mesh_1 becomes Group1_1 and Group1 of Mesh_2
+      \em Compound_Mesh, or</li>
-        becomes Group1_2.</li>
+      <li>\b Renamed - \em Group1 of \em Mesh_1 becomes \em Group1_1
+      and \em Group1 of \em Mesh_2 becomes \em Group1_2.</li>
     </ul>
     See \ref grouping_elements_page "Creating Groups" for more information
     about groups.</li>

doc/salome/gui/SMESH/input/changing_orientation_of_elements.doc

@@ -28,12 +28,12 @@
         element will be added to the list. To remove a selected element or
         elements from the list click the \b Remove button. The \b Sort button
         allows to sort the list of elements IDs. The <b>Set filter</b> button
-        allows to apply a definite \ref filtering_elements "filter" to
+        allows to apply a definite \ref filtering_elements "filter" to the
         selection of elements.</li>
       <li><b>Apply to all</b> radio button allows to modify the orientation
         of all elements of the selected mesh.</li>
       <li><b>Select from</b> set of fields allows to choose a sub-mesh or an
-        existing group whose elements then can be added to the list.</li>
+        existing group whose elements can be added to the list.</li>
     </ul>
 
   </li>

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

@@ -2,55 +2,53 @@
 
 \page constructing_meshes_page Constructing meshes
 
-To create a mesh on geometry, at first you create a mesh object by choosing
+To create a mesh on geometry, it is necessary to create a mesh object by choosing
 - a geometrical shape produced in the Geometry module (<em>main shape</em>);
 - <em>meshing parameters</em>, including 
   - \ref basic_meshing_algos_page "meshing algorithms" and
   - \ref about_hypo_page "hypotheses" specifying constraints to be
-    taken into account by chosen meshing algorithms.
+    taken into account by the chosen meshing algorithms.
 
-Then you already can launch mesh generation by invoking \ref
+Then you can launch mesh generation by invoking \ref compute_anchor "Compute" command.
-compute_anchor "Compute" command.
 
 \note Sometimes \a hypotheses term is used to refer to both algorithms
 and hypotheses.
 
-Generation of the mesh on the geometry is performed in the bottom-up
+Mesh generation on the geometry is performed in the bottom-up
 flow: nodes on vertices are created first, then edges are divided into
-segments using nodes on vertices; the segments of the edges is then
+segments using nodes on vertices; the segments of edges are then
-used while meshing faces; then the mesh of the faces is used while meshing
+used to mesh faces; then the mesh of faces is used to mesh
 solids. This automatically assures the conformity of the mesh.
 
-You are to choose a meshing algorithm for every dimension of
+It is required to choose a meshing algorithm for every dimension of
-sub-shapes up to the highest dimension you desire to generate. Note
+sub-shapes up to the highest dimension to be generated. Note
-that some algorithms generate elements of several dimensions while
+that some algorithms generate elements of several dimensions, and
-others, of only one. But it's not necessary to define meshing
+others of only one. It is not necessary to define meshing
 parameters for all dimensions at once; you can start from 1D
 meshing parameters only, compute the 1D mesh, then define 2D meshing
-parameters and compute the 2D mesh (note that 1D mesh won't be
+parameters and compute the 2D mesh (note that 1D mesh will not be
 re-computed).
 
 An algorithm of a certain dimension chosen at mesh creation is applied
-to discretize every sub-shape of this dimension. But you can
+to discretize every sub-shape of this dimension. It is possible to
 specify a different algorithm or hypothesis to be applied to one or
 a group of sub-shapes by creating a \ref constructing_submeshes_page
 "sub-mesh". You can specify no algorithms at all at mesh object
 creation and specify the meshing parameters on sub-meshes only; then
-only sub-shapes for which you defined an algorithm and a needed
+only the sub-shapes, for which an algorithm and a hypothesis (if any)
-hypothesis (if any) will be discretized.
+have been defined will be discretized.
 
-\n Construction of a mesh on some geometry includes at least two (mesh
+\n Construction of a mesh on a geometry includes at least two (mesh
 creation and computing) of the following steps:
 <ul>
-  <li> \ref create_mesh_anchor "Creation of a mesh object" where you
+  <li> \ref create_mesh_anchor "Creation of a mesh object", where you
   can specify meshing parameters to apply to all sub-shapes of the
   main shape.</li>
-  <li> \ref constructing_submeshes_page "Creation of sub-meshes"
+  <li> \ref constructing_submeshes_page "Creation of sub-meshes",
-  (optional) where you can specify meshing parameters to apply to
+  (optional) where you can specify meshing parameters to apply to the
   selected sub-shapes.</li>
   <li> \ref evaluate_anchor "Evaluating mesh size" (optional) can be
-  used to know approximate number of elements before actual generation
+  used to know an approximate number of elements before their actual generation.</li>
-  of them.</li>
   <li> \ref preview_anchor "Previewing the mesh" (optional) can be
   used to generate mesh of only lower dimension(s) in order to
   visually estimate it before full mesh generation, which can be much
@@ -61,8 +59,8 @@ creation and computing) of the following steps:
   <li> \ref compute_anchor "Computing the mesh" uses defined meshing
   parameters to generate mesh elements.</li>
   <li> \ref edit_anchor "Editing the mesh" (optional) can be used to
-  \ref modifying_meshes_page "modify" mesh of lower dimension before
+  \ref modifying_meshes_page "modify" the mesh of a lower dimension before
-  \ref compute_anchor "computing" elements of upper dimension.</li>
+  \ref compute_anchor "computing" elements of an upper dimension.</li>
 </ul>
 
 \anchor create_mesh_anchor
@@ -103,10 +101,10 @@ creation and computing) of the following steps:
     3D sub-shapes (solids) and generate 3D mesh elements
     (tetrahedra, hexahedra etc.)
 
-    As soon as you have selected an algorithm, you can create (or
+    As soon as you have selected an algorithm, you can create a
-    select already created) a hypothesis. A set of accessible
+    hypothesis (or select an already created one). A set of accessible
-    hypotheses includes only hypotheses the selected algorithm can take
+    hypotheses includes only the hypotheses that can be used by the
-    into account.
+    selected algorithm.
 
     \note
     - Some page(s) can be disabled if the geometrical
@@ -115,10 +113,10 @@ creation and computing) of the following steps:
     \b 3D page is disabled.
     - Some algorithms affect the geometry of several dimensions,
     i.e. 1D+2D or 1D+2D+3D. If such an algorithm is selected, the
-    dialog box pages related to the corresponding lower dimensions are
+    dialog pages related to the corresponding lower dimensions are
     disabled.
-    - \b 0D page does not refer to the 0D elements, but to 0D
+    - \b 0D page refers to 0D geometry (vertices) rather than
-    geometry (vertices). Mesh module does not provide algorithms that
+    to 0D elements. Mesh module does not provide algorithms that
     produce 0D elements. Currently \b 0D page provides only one
     algorithm "Segments around vertex" that allows specifying the required
     size of mesh edges about the selected vertex (or vertices).
@@ -126,9 +124,9 @@ creation and computing) of the following steps:
     For example, you need to mesh a 3D object.
 
     First, you can change a default name of your mesh in the \b Name
-    box. Then check that a selected geometrical object, whose name is
+    box. Then check that the selected geometrical object indicated in
-    shown in \b Geometry field, is that you wish to mesh; if not, click
+    \b Geometry field, is what you wish to mesh; if not, select
-    the right object in the Object Browser. Click "Select" button
+    the correct object in the Object Browser. Click "Select" button
     near \b Geometry field if the name of the object has not yet
     appeared in \b Geometry field.
     <center>
@@ -224,11 +222,9 @@ creation and computing) of the following steps:
       </center>
 
       \note 
-      - \a "Automatic" in the names of predefined sets of
+      - \a "Automatic" in the names of predefined sets of hypotheses
-        hypotheses came from previous versions of SALOME where
+      does not actually mean that they are suitable for meshing any
-        \ref automatic_length_anchor "Automatic Length" hypothesis 
+      geometry.
-        was included in these sets, and not that these sets are suitable for
-        meshing any geometry.
       - The list of sets of hypotheses can be shorter than in the
         above image depending on the geometry dimension.
   </li>
@@ -381,18 +377,18 @@ click "Compute" button of the toolbar.
 
 After the mesh computation finishes, the Mesh Computation information
 box appears. If you close this box and click "Compute" button again,
-without previously changing meshing parameters, the mesh is
+without previously changing meshing parameters, the mesh will NOT be
-NOT re-computed and the Mesh Computation information box with
+re-computed and the Mesh Computation information box will be shown
-the same contents is shown. (To fully re-compute the mesh, invoke \ref
+with the same contents. (To fully re-compute the mesh, invoke 
-clear_mesh_anchor "Clear Mesh Data" command before).
+\ref clear_mesh_anchor "Clear Mesh Data" command before). 
 
-In case of a success, the box shows information on number of entities
+If the mesh computation has been a success, the box shows information
-of different types in the mesh.
+on the number of entities of different types in the mesh.
 
 \image html meshcomputationsucceed.png
 
 \anchor meshing_failed_anchor
-If the mesh computation failed, the information about the cause of the
+If the mesh computation has failed, the information about the cause of the
 failure is provided in \b Errors table.
 
 \image html meshcomputationfail.png
@@ -439,12 +435,12 @@ By default, the information box is always shown after mesh computation operation
 \anchor edit_anchor
 <h2>Editing the mesh</h2>
 
-It is possible to \ref modifying_meshes_page "edit the mesh" of
+It is possible to \ref modifying_meshes_page "edit the mesh" of a 
-lower dimension before generation of mesh of higher dimension.
+lower dimension before generation of the mesh of a higher dimension.
 
-For example you can generate 2D mesh, modify it using e.g. 
+For example you can generate a 2D mesh, modify it using e.g. 
-\ref pattern_mapping_page, and then generate 3D mesh basing on the
+\ref pattern_mapping_page, and then generate a 3D mesh basing on the
-modified 2D mesh. The workflow is following:
+modified 2D mesh. The workflow is as follows:
 - Define 1D and 2D meshing algorithms.
 - Compute the mesh. 2D mesh is generated.
 - Apply \ref pattern_mapping_page.
@@ -453,9 +449,9 @@ and hypotheses.
 - Compute the mesh. 3D mesh is generated.
 
 \note Nodes and elements added \ref adding_nodes_and_elements_page
-"manually" can't be used in this workflow because the manually created
+"manually" cannot be used in this workflow because the manually created
-entities are not attached to any geometry and thus (usually) can't be
+entities are not attached to any geometry and thus (usually) cannot be
-found by a mesher paving some geometry.
+found by the mesher paving a geometry.
 
 <b>See Also</b> a sample TUI Script demonstrates the possibility of 
 \ref tui_editing_while_meshing "Intermediate edition while meshing"

doc/salome/gui/SMESH/input/constructing_submeshes.doc

@@ -11,8 +11,8 @@ and/or hypotheses than those used to generate the mesh on other
 sub-shapes.
 
 Creation of a sub-mesh allows to control individually meshing of a
-certain sub-shape, thus allowing to get mesh locally coarser or finer, to get
+certain sub-shape, thus to get a locally coarser or finer mesh, to get
-elements of different types in the same mesh etc.
+elements of different types in the same mesh, etc.
 
 A sub-shape to create a sub-mesh on should be retrieved from the main shape
 in one of the following ways: <ul>
@@ -33,7 +33,7 @@ compound of solids, starts from searching an algorithm, 1D as for the
 edge. The following sub-shapes are sequentially checked for presence
 of a sub-mesh where 1D algorithm is assigned:
 <ul>
-<li> the \b edge it-self</li>
+<li> the \b edge itself</li>
 <li> <b>groups of edges</b> containing the edge, if any</li>
 <li> \b wires sharing the edge</li>
 <li> \b faces sharing the edge</li>
@@ -43,29 +43,28 @@ of a sub-mesh where 1D algorithm is assigned:
 <li> <b>groups of solids</b> sharing the edge, if any</li>
 <li> the <b>main shape</b></li>
 </ul>
-(This sequence of sub-shapes defines priority of sub-meshes. Thus more
+(This sequence of sub-shapes defines the priority of sub-meshes. Thus more
 local, i.e. assigned to sub-shape of lower dimension, algorithms and
 hypotheses have higher priority during the search of hypotheses to
 apply.)
 
-As soon as an 1D algorithm is found the search stops and the same
+As soon as a 1D algorithm is found, the search stops and the same
-sequence of sub-shapes is checked to find a main and additional 1D
+sequence of sub-shapes is checked to find the main and additional 1D
-hypotheses the found 1D algorithm can take into account. 
+hypotheses, which can be taken into account by the found 1D algorithm. 
 
-The multi-dimensional algorithms have higher priority than
+The multi-dimensional algorithms have a higher priority than
-uni-dimensional algorithms if they are assigned to sub-meshes of the
+uni-dimensional ones if they are assigned to sub-meshes of the
 same priority.
 
 If meshing parameters are defined on sub-meshes of the same priority,
-for example different 1D hypotheses are assigned to two faces sharing
+for example, different 1D hypotheses are assigned to two faces sharing
 an edge, the hypothesis assigned to a sub-shape with a lower ID will
 be used for meshing. You can \ref submesh_order_anchor "change" mutual
 priority of such concurrent sub-meshes. 
 
-
 \n Construction of a sub-mesh consists of:
 <ul>
-<li>Selecting a mesh which will encapsulate your sub-mesh</li>
+<li>Selecting a mesh which will encapsulate the sub-mesh</li>
 <li>Selecting a sub-shape for meshing</li>
 <li>Applying one or several
 \ref about_hypo_page "hypotheses" and 
@@ -94,7 +93,7 @@ Geometry (e.g. a face if the parent mesh has been built on box) of the
 sub-mesh. You can define meshing algorithms and hypotheses in the same way as
 in \ref constructing_meshes_page "Create mesh" dialog. 
 
-Later you can change applied hypotheses or their parameters in 
+Later you can change the applied hypotheses or their parameters in 
 \ref editing_meshes_page "Edit mesh/sub-mesh" dialog. Mesh entities
 generated using changed hypotheses are automatically removed.
 

doc/salome/gui/SMESH/input/create_groups_from_geometry.doc

@@ -14,9 +14,9 @@ menu in the Object browser <b>Create Groups from Geometry</b> item.
 
 \image html create_groups_from_geometry.png
 
-In this dialog \b Elements group contains a list of shapes to create
+In this dialog \b Elements group contains a list of shapes, on which 
-groups of elements on them; \b Nodes group contains a list of shapes
+groups of elements will be created; \b Nodes group contains a list of shapes, 
-to create groups of node on them.
+on which groups of nodes will be created.
 
 
 */

doc/salome/gui/SMESH/input/creating_groups.doc

@@ -98,11 +98,11 @@ of a certain type generated on the selected geometrical object. Group
 contents are dynamically updated if the mesh is modified. The group on
 geometry can be created only if the mesh is based on geometry.
 
-To define a group, click a \a Selection button and chose
+To define a group, click the \a Selection button and choose
 - <em>Direct geometry selection</em> to select a shape in the Object
   Browser or in the Viewer;
 - <em>Find geometry by mesh element selection</em> to activate a
-  dialog which retrieves a shape by a selected element generated on
+  dialog which retrieves a shape by the selected element generated on
   this shape.
 
 Note that this choice is available only if the mesh elements are
@@ -130,8 +130,8 @@ of a certain type satisfying the defined filter. Group contents are
 dynamically updated if the mesh is modified.
 
 To define a group, click the <b>Set filter</b> button and define
-criteria of the filter in the opened dialog. After confirmation of the
+criteria of the filter in the opened dialog. After the
-operation a new group of mesh elements will be created. See more about
+operation is confirmed, a new group of mesh elements will be created. See more about
 filters on the 
 \ref selection_filter_library_page "Selection filter library" page. 
 

doc/salome/gui/SMESH/input/diagonal_inversion_of_elements.doc

@@ -18,7 +18,8 @@ The following dialog box shall appear:
 \image html diagonalinversion.png
  
 </li>
-<li>Enter IDs of nodes forming the required edge in the \b Edge field (the node IDs must be separated by a dash) or select
+<li>Enter IDs of nodes forming the required edge in the \b Edge field
+(the node IDs must be separated by dashes) or select
 this edge in the 3D viewer.</li>
 <li>Click the \b Apply or <b>Apply and Close</b> button.</li>
 </ol>

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

@@ -8,7 +8,7 @@ mesh of plus one dimension are additionally created. All created
 elements can be automatically grouped. Extrusion can be used to create
 a \ref extrusion_struct "structured mesh from scratch".
 
-\image html extrusion_box.png "If you extrude several quadrangles, you get exactly same mesh as if you meshed a geometrical box (except that the initial quadrangles can be incorrectly oriented): quadrangles and segments on boundary of generated mesh are created"
+\image html extrusion_box.png "If you extrude several quadrangles, you get exactly the same mesh as if you meshed a geometrical box (except for that the initial quadrangles can be incorrectly oriented): quadrangles and segments are created on the boundary of the generated mesh"
 
 <p>Any node, segment or 2D element can be extruded. Each type of
 elements is extruded into a corresponding type of result elements:
@@ -32,15 +32,10 @@ elements is extruded into a corresponding type of result elements:
 <em>"Extrusion" button</em>
 </center>
 
-The following dialog, looking different depending on selected options,
+The following dialog will appear:
-will appear:
 
 \image html extrusionalongaline1.png
 
-\image html extrusionalongaline2.png
-
-\image html extrusionalongaline3.png
-
 </li>
 
 <li>In this dialog:
@@ -48,8 +43,8 @@ will appear:
   <li>Specify \b Nodes, \b Edges and \b Faces, which will be extruded, by one
     of following means:
     <ul>
-      <li><b>Select the whole mesh, sub-mesh or group</b> activating this
+      <li><b>Select the whole mesh, sub-mesh or group</b> activating the
-        checkbox.</li>
+        corresponding check-box.</li>
       <li>Choose mesh elements with the mouse in the 3D Viewer. It is
         possible to select a whole area with a mouse frame.</li> 
       <li>Input the element IDs directly in <b>Node IDs</b>, <b>Edge
@@ -63,7 +58,11 @@ will appear:
   <li>If the <b>Extrusion to Distance</b> radio button is selected
     - specify the translation vector by which the elements will be extruded.
   </li>
-  <li>If the <b>Extrusion Along Vector</b> radio button is selected
+  <p><br></p>
+
+\image html extrusionalongaline2.png  
+
+ <li>If the <b>Extrusion Along Vector</b> radio button is selected
     <ul>
       <li>specify the coordinates of the \b Vector along which the elements
         will be extruded, either directly or by selecting the mesh face (the
@@ -72,19 +71,23 @@ will appear:
         be negative).</li>
     </ul>
   </li>
+  <p><br></p>
+
+\image html extrusionalongaline3.png  
+  
   <li>If the <b>Extrusion By Normal</b> radio button is selected,
-    every node of selected faces is extruded along the \a average
+    every node of the selected faces is extruded along the \a average
     of the \a normal vectors to the faces sharing the node. (Nodes and
-    edges can't be extruded in this mode.)
+    edges cannot be extruded in this mode.)
     <ul>
       <li>Specify the \b Distance of extrusion (it can be negative),</li>
       <li>Use <b>Along average normal</b> check-box to specify along
-        what vector the distance is measured.
+        which vector the distance is measured.
         <ul>
           <li>If it is \a activated the distance is measured along the
             average normal mentioned above. </li>
           <li>If it is \a deactivated every node is extruded along the
-            average normal till its intersection with the virtual plane got
+            average normal till its intersection with a virtual plane obtained
             by translation of the face sharing the node along its own normal
             by the \b Distance.</li>
         </ul>
@@ -95,8 +98,8 @@ will appear:
         \image html extrusionbynormal_alongavgnorm.png "'Along average normal' activated (to the left) and deactivated (to the right)"
         <p></li>
 
-      <li>Using <b>Use only input elements</b> check-box specify what
+      <li><b>Use only input elements</b> check-box specifies what
-        elements to use to compute the average normal.<ul>
+        elements will be used to compute the average normal.<ul>
           <li> If it is \a activated only selected faces, among faces
             sharing the node, are used to compute the average normal at
             the node. </li>

doc/salome/gui/SMESH/input/group_of_underlying_elements.doc

@@ -19,12 +19,12 @@ In this dialog box specify <ul>
       <li>\b All - include if all nodes are common;</li>
       <li>\b Main - include if all corner nodes are common (meaningful for
         a quadratic mesh) </li>
-      <li><b>At least one</b> - include if one or more node is common</li>
+      <li><b>At least one</b> - include if one or more nodes are common</li>
-      <li>\b Majority - include if half of nodes or more is common</li></ul>
+      <li>\b Majority - include if half or more nodes are common</li></ul>
   </li>
   <li> select reference groups,</li>
-  <li> <b>Include underlying entities only</b> option if activated
+  <li> If <b>Include underlying entities only</b> option is activated
-  allows inclusion of an entity provided that it is based on nodes of
+  an entity can be included if it is based on nodes of
   one element of a reference group.</li>
 </ul>
 

doc/salome/gui/SMESH/input/grouping_elements.doc

@@ -12,35 +12,36 @@ visualization only and is not exported.
 There are three types of groups different by their internal
 organization:<ol>
 <li><b>Standalone group</b> is a static set of mesh entities. Its
-  contents can be explicitely controlled by the user. Upon removal of
+  contents can be explicitly controlled by the user. Upon removal of
   the entities included into the group, the group becomes empty and
-  the user is to pay efforts to restore its contents. Hence it is
+  its content can be restored only manually. Hence it is
-  resonable to create standalone groups when the mesh generation is
+  reasonable to create standalone groups when the mesh generation is
   finished and mesh quality is verified.
   \warning Creation and edition of large standalone groups in
   \ref creating_groups_page "Create group" dialog using manual edition
   is problematic due to poor performance of the dialog.</li>
-<li><b>Group on geomerty</b> is associated to one or a group of
+  
+<li><b>Group on geometry</b> is associated to a sub-shape or a group of
   sub-shapes of the main shape and includes mesh entities generated on
-  this geometrical entities. The association to geometry is
+  these geometrical entities. The association to a geometry is
-  established at group construction and can't be changed. The group
+  established at group construction and cannot be changed. The group
-  contents is always up-to-date without user's efforts, hence the
+  contents are always updated automatically, hence the
   group can be created even before mesh elements generation.</li>
-<li><b>Group on filter</b> encapsulates a filter which is used to
+<li><b>Group on filter</b> encapsulates a filter, which is used to
   select mesh entities composing the group from the whole
   mesh. Criteria of the filter can be changed at any time. The
-  group contents is always up-to-date without user's efforts, hence
+  group contents are always updated automatically, hence
   the group can be created even before mesh elements generation.</li>
 </ol>
 The group on geometry and group on filter can be converted to
-the standalone group.
+a standalone group.
 
 \image html groups_in_OB.png "Groups of different types look differently in the Object Browser"
 
 The following ways of group creation are possible:
 
 - \subpage creating_groups_page "Create group" dialog allows creation of
-  a group of any of all the three types:
+  a group of any type:
   \ref standalone_group "Standalone group",
   \ref group_on_geom "Group on geometry" and
   \ref group_on_filter "Group on filter" using dedicated tabs.
@@ -49,7 +50,7 @@ The following ways of group creation are possible:
 - Standalone groups of all nodes and elements of the chosen sub-mesh
   (type of elements depends on dimension of sub-mesh geometry) can
   be created using <b>Mesh -> Construct Group</b> menu item (available
-  in context menu as well).
+  from the context menu as well).
 - Standalone groups of any element type can be created basing on nodes
   of other groups - using \subpage group_of_underlying_elements_page
   "Group based on nodes of other groups" dialog.
@@ -69,10 +70,9 @@ The created groups can be later:
 - \ref importing_exporting_meshes_page "Exported" into a file as a
   whole mesh.
 
-In the Object Browser, if groups container item includes more
+In the Object Browser, if an item contains more than one child group,
-than one group, it is possible to sort the groups by name in
+it is possible to sort the groups by name in ascending order
-ascending order. For this, select the groups container in the Object
+using <b>Sort children</b> context menu item. 
-Browser and choose <b>Sort children</b> context menu item. 
 
 \image html smesh_sort_groups.png "Sorting groups"
 

doc/salome/gui/SMESH/input/importing_exporting_meshes.doc

@@ -4,8 +4,8 @@
 
 \n In MESH there is a functionality allowing import/export
 of meshes from/to \b MED, \b UNV (I-DEAS 10), \b DAT (simple ascii format), \b STL,
-\b GMF (internal format of DISTENE products, namely BLSurf, GHS3D and
+\b GMF (internal format of DISTENE products, namely MG-CADSurf, MG-Tetra and
-Hexotic algorithms) and \b CGNS format files. You can also export a
+MG-Hexa algorithms) and \b CGNS format files. You can also export a
 group as a whole mesh.
 
 

doc/salome/gui/SMESH/input/index.doc

@@ -16,10 +16,11 @@
   either \ref importing_exporting_meshes_page "imported" or manually
   created); 
  </li>
-<li>\ref importing_exporting_meshes_page "import and export of meshes in various formats";</li>
+<li>\ref importing_exporting_meshes_page "importing and exporting meshes in various formats";</li> 
 <li>\subpage modifying_meshes_page "modifying meshes" with a vast
   array of dedicated operations;</li> 
-<li>\subpage grouping_elements_page "creating groups of mesh elements";</li>
+<li>\subpage grouping_elements_page "creating groups of mesh
+  elements";</li>
 <li>filtering mesh entities (nodes or elements) using
   \subpage filters_page "Filters" functionality for \ref
   grouping_elements_page "creating groups" and applying \ref
@@ -27,14 +28,17 @@
 <li>\subpage viewing_meshes_overview_page "viewing meshes" in
   the VTK viewer;</li>
 <li>applying to meshes \subpage quality_page "Quality Controls", 
-  allowing to highlight important elements;
+  allowing to highlight important elements;</li>
-<li>various \subpage measurements_page "measurements" of the mesh objects.
+<li>taking various \subpage measurements_page "measurements" of the
+  mesh objects.</li>
 </ul>
 
-When setting parameters of operations, it is possible to use the variables predefined in
+It is possible to use the variables predefined in
-\subpage using_notebook_mesh_page "Salome notebook".
+\subpage using_notebook_mesh_page "Salome notebook" to set parameters
+of operations.
 
-Mesh module preferences are described in the \subpage mesh_preferences_page section of SALOME Mesh Help.
+Mesh module preferences are described in the \subpage mesh_preferences_page 
+section of SALOME Mesh Help.
 
 Almost all mesh module functionalities are accessible via
 \subpage smeshpy_interface_page "Mesh module Python interface".

doc/salome/gui/SMESH/input/merging_elements.doc

@@ -37,15 +37,16 @@ object selectable in the dialog box. Two elements are considered coincident if t
 <li>\b Detect button generates the list of coincident elements found
   in the selected object.</li>
 <li><b>Coincident elements</b> is a list of groups of elements for
-  merging. As result of the operation all elements of each group will
+  merging. After the operation all elements of each group will
-  be replaced by the firts element of the group.
+  be united into one element. The first element of a group is kept and
+  the others are removed.
 <ul>
 <li>\b Remove button deletes the selected group from the list.</li>
 <li>\b Add button adds to the list a group of elements selected in the
   viewer with pressed "Shift" key.</li>
-<li><b>Select all</b> checkbox selects all groups.</li>
+<li><b>Select all</b> check-box selects all groups.</li>
-<li><b>Show double elements IDs</b> checkbox shows/hides identifiers of
+<li><b>Show double elements IDs</b> check-box shows/hides identifiers of
-  elements of selected groups in the 3D viewer.</li>
+  elements of the selected groups in the 3D viewer.</li>
 </ul></li>
 <li><b>Edit selected group</b> list allows editing the selected group:
 <br><br>
@@ -53,12 +54,11 @@ object selectable in the dialog box. Two elements are considered coincident if t
 <center>adds to the group the elements selected in the viewer.</center>
 <br>
 \image html remove.png
-<center>removes from the group the selected elements.</center>
+<center>removes the selected elements from the group.</center>
 <br>
 \image html sort.png
 <center>moves the selected element to the first position in the
-  group. This means that all other elements of the group will be
+  group in order to keep it in the mesh.</center>
-  replaced by this one.</center>
 <br>
 </li>
 <li>To confirm your choice click \b Apply or <b>Apply and Close</b> button.</li>

doc/salome/gui/SMESH/input/merging_nodes.doc

@@ -39,14 +39,15 @@ In this mode additional controls are available:
 <li>\b Detect button generates the list of coincident nodes for the given
 \b Tolerance.</li>
 <li><b>Coincident nodes</b> is a list of groups of nodes for
-  merging. As result of the operation all nodes of each group will be
+  merging. After the operation all nodes of each group will
-  replaces by the firts node of the group.
+  be united into one node. The first node of a group is kept and
+  the others are removed.
 <ul>
 <li>\b Remove button deletes the selected group from the list.</li>
 <li>\b Add button adds to the list a group of nodes selected in the
 viewer with pressed "Shift" key.</li>
-<li><b>Select all</b> checkbox selects all groups.</li>
+<li><b>Select all</b> check-box selects all groups.</li>
-<li><b>Show double nodes IDs</b> checkbox shows/hides identifiers of
+<li><b>Show double nodes IDs</b> check-box shows/hides identifiers of
 nodes of selected groups in the 3D viewer.</li>
 </ul>
 
@@ -65,15 +66,14 @@ nodes of selected groups in the 3D viewer.</li>
   <br>
   \image html sort.png
   <center>moves the selected node to the first position in the
-    group. This means that all other nodes of the group will be
+    group in order to keep it in the mesh.</center><br>
-    replaced by this one.</center><br>
 </li>
 </ul>
 </li>
 <li>To confirm your choice click \b Apply or <b>Apply and Close</b> button.</li>
 </ol>
 
-\image html merging_nodes1.png "The initial obgect" 
+\image html merging_nodes1.png "The initial object" 
 
 \image html merging_nodes2.png "The object has been merged with a very big tolerance"
 

doc/salome/gui/SMESH/input/mesh_preferences.doc

@@ -44,17 +44,17 @@ or in later sessions with this module according to the preferences.
   presentation mode as default.
 
 - <b>Representation of the 2D quadratic elements</b>
-  - <b>Default mode of the 2D quadratic elements</b> combobox - allows
+  - <b>Default mode of the 2D quadratic elements</b> combo-box - allows
     to select lines or arcs for representation of quadratic elements as default.
   - <b>Maximum Angle</b> - maximum deviation angle used by the
     application to build arcs.
 
 - <b>Mesh export</b>
-  - If you toggle <b>Automatically create groups for MED export</b> checkbox,
+  - If you toggle <b>Automatically create groups for MED export</b> check-box,
     this operation will be carried out automatically.
 
 - <b>Mesh computation</b>
-  - <b>Show a computation result notification</b> combobox allows to
+  - <b>Show a computation result notification</b> combo-box allows to
     select the notification mode about a mesh computation result.
     There are 3 possible modes:
     - <b>Never</b> - do not show the result dialog at all;
@@ -132,16 +132,16 @@ or in later sessions with this module according to the preferences.
 \image html pref22.png
 
 - <b>Nodes</b> allows to define default parameters for nodes, which will be applied 
-  for a new created mesh only. Customization of already created meshes can be done using 
+  for a newly created mesh only. Existing meshes can be customized using 
-  \ref colors_size_page "Properties dialog box" that is called by click on popup menu of mesh.
+  \ref colors_size_page "Properties dialog box" available from the context menu of a mesh.
   - <b>Color</b> -  allows to select the color of nodes. Click on the
     colored line to access to the <b>Select Color</b> dialog box.
   - <b>Type of marker</b> - allows to define the shape of nodes.
   - <b>Scale of marker</b> - allows to define the size of nodes.
 
 - <b>Elements</b> allows to define default parameters for different elements, which will be applied 
-  for a new created mesh only. Customization of already created meshes can be done using 
+  for a newly created mesh only. Existing meshes can be customized using 
-  \ref colors_size_page "Properties dialog box" that is called by click on popup menu of mesh.
+  \ref colors_size_page "Properties dialog box" available from the context menu of a mesh.
   - <b>Surface color</b>  - allows to select the surface color of 2D elements
     (seen in Shading mode). Click on the colored line to access to the
     <b>Select Color</b> dialog box.
@@ -175,21 +175,21 @@ or in later sessions with this module according to the preferences.
 - <b>Groups</b>
   - <b>Names color</b> - specifies color of group names to be used in
     3D viewer.
-  - <b>Default color</b> - specifies default group color, which is used 
+  - <b>Default color</b> - specifies the default group color, which is used 
-  when creating new mesh group (see \ref creating_groups_page "Create Group dialog box").
+  to create a new mesh group (see \ref creating_groups_page "Create Group dialog box").
 
 - <b>Numbering</b> allows to define properties of numbering functionality:
   - <b>Nodes</b> - specifies text properties of nodes numbering
     (font family, size, attributes, color).
   - <b>Elements</b> - same for elements.
 
-- <b>Orientation of Faces</b> - allows to define the behavior of
+- <b>Orientation of Faces</b> - allows to define default properties of orientation vectors.
-  <b>Orientation of faces</b> functionality, which will be applied 
+  These preferences will be applied to the newly created meshes only; properties of existing meshes
-  for a new created mesh only. Customization of already created meshes can be done using 
+  can be customized using \ref colors_size_page "Properties dialog box"
-  \ref colors_size_page "Properties dialog box" that is called by click on popup menu of mesh.
+  available from the context menu of a mesh.
-  - \b Color - allows to define the color of orientation vertors;
+  - \b Color - allows to define the color of orientation vectors;
   - \b Scale - allows to define the size of orientation vectors;
-  - <b>3D Vector</b> checkbox allows to choose between 2D planar
+  - <b>3D Vector</b> check-box allows to choose between 2D planar
     and 3D vectors.
 
 <br><h2>Selection Preferences</h2>
@@ -220,9 +220,9 @@ or in later sessions with this module according to the preferences.
 \image html pref24.png
 
 \note The following settings are default and will be applied for 
-a new created mesh only. Customization of already created meshes 
+a newly created mesh only. Existing meshes 
-can be done using local \ref scalar_bar_dlg "Scalar Bar Properties dialog box" 
+can be customized using local \ref scalar_bar_dlg "Scalar Bar Properties dialog box" 
-that is called by click on popup menu of mesh.
+available from the context menu of a mesh.
 
 - <b>Font</b> - in this menu you can set type, face and color for
   the font of <b>Title</b> and <b>Labels</b>.

doc/salome/gui/SMESH/input/modifying_meshes.doc

@@ -58,8 +58,8 @@ transformation operations, giving the possibility to:
 <li>\subpage cut_mesh_by_plane_page "Cut a tetrahedron mesh by a plane".</li>
 </ul>
 
-It is possible to \ref edit_anchor "modify the mesh" of lower
+\note It is possible to \ref edit_anchor "modify the mesh" of a lower
-dimension before generation of mesh of higher dimension.
+dimension before generation of the mesh of a higher dimension.
 
 <p><br></p>
 

doc/salome/gui/SMESH/input/quad_ijk_algo.doc

@@ -3,20 +3,20 @@
 \page quad_ijk_algo_page Quadrangle (Mapping) meshing algorithm
 
 <b>Quadrangle (Mapping)</b> meshing algorithm is intended for creating
-all-quadrangle and quad-dominant meshes on faces with no holes and
+all-quadrangle and quad-dominant meshes on faces without holes and
 bound by at least three edges.
 
-The algorithm can create mesh on any face but mesh quality and
+The algorithm can create mesh on any face but its quality and
-validity depends on two factors:
+validity depend on two factors:
-- face shape (number of edges and concavity of boundary);
+- face shape (number of edges and boundary concavity);
 - discretization of edges.
 
 \image html quad_mesh_invalid.png "Invalid mesh on quadrilateral concave faces"
 
-The algorithm uses <em>Transfinite Interpolation</em> technic in
+The algorithm uses <em>Transfinite Interpolation</em> technique in the 
 parametric space of a face to locate nodes inside the face.
 
-The algorithm treats any face as a quadrangle. If a face is bound by
+The algorithm treats any face as quadrangle. If a face is bound by
 more than four edges, four most sharp vertices are considered as
 corners of the quadrangle and all edges between these vertices are
 treated as quadrangle sides. In the case of three edges, the vertex
@@ -26,24 +26,24 @@ quadrangle.
 \image html quad_meshes.png "Algorithm generates a structured mesh on complex faces provided that edges are properly discretized"
 
 To get an all-quadrangle mesh you have to carefully define 1D
-hypotheses on edges of a face. To get a \b structured mesh you have to assure
+hypotheses on edges of a face. To get a \b structured mesh you have to provide
 equal number of segments on opposite sides of the quadrangle. If this
-condition is not respected, the algorithm by default (with no
+condition is not respected, the algorithm by default (without a 
-hypothesis) creates \b quad-dominant mesh with triangles located near a
+hypothesis) creates a \b quad-dominant mesh with triangles located near the
-side with maximal number of segments. But you can get an
+side with the maximal number of segments. However, you can get an
 \b all-quadrangle mesh in this case by using 
 \ref hypo_quad_params_anchor "Quadrangle Parameters"
 hypothesis to specify how to make transition mesh between opposite
 sides with different number of segments, provided that certain
-conditions are respected. In any case total number of segments must be
+conditions are respected. In any case the total number of segments must be
-even. To use \a Reduced transition method there must be equal number
+even. To use \a Reduced transition method, there must be an equal number
 of segments on one pair of opposite sides.
 
-The following hypotheses help in creation of quadrangle meshes. 
+The following hypotheses help to create quadrangle meshes. 
 - \ref propagation_anchor "Propagation" additional 1D hypotheses
-  help to get equal number of segments on opposite sides of the
+  help to get an equal number of segments on the opposite sides of a
   quadrilateral face.
 - \ref a1d_algos_anchor "Composite Side Discretization" algorithm is useful
-  to discretize several C1 continues edges as one quadrangle side.
+  to discretize several C1 continuous edges as one quadrangle side.
 
 */

doc/salome/gui/SMESH/input/reorient_faces.doc

@@ -5,8 +5,8 @@
 \n This operation allows fixing the orientation of a set of faces in
 the following ways:
 <ul>
-<li>The desired orientation of a set of neighboring faces can be defined
+<li>The required orientation of a set of neighboring faces can be defined
-  by a vector giving a desired direction of a normal of a certain face. <br>
+  by a vector giving the direction of a normal to a certain face. <br>
   Since the direction of face normals in the set can be even opposite,
   it is necessary to specify a \a control face, the normal to which
   will be compared with the vector. This face can be either:
@@ -41,7 +41,7 @@ The orientation of a face is changed by reverting the order of its nodes.
 <li>To reorient by direction of the face normal:
     <ul>
     <li>Specify the coordinates of the \b Point by which the control face
-      will be found. You can specify the \b Point by either picking a
+      will be found. You can specify the \b Point by picking a
       node in the 3D Viewer or selecting a vertex in the Object
       Browser.</li>
     <li>Set up the \b Direction vector to be compared with the normal of the
@@ -61,7 +61,7 @@ The orientation of a face is changed by reverting the order of its nodes.
 
 </li>
 
-<li>In the second mode it is possible to either pick the \b Face by mouse in the 3D Viewer or directly input the \b Face ID in the corresponding field.
+<li>In the second mode it is possible to pick the \b Face by mouse in the 3D Viewer or directly input the \b Face ID in the corresponding field.
 
 <center>
 \image html reorient_2d_face.png "The orientation of adjacent faces is chosen according to a vector. The control face is explicitly given."
@@ -81,7 +81,7 @@ The orientation of a face is changed by reverting the order of its nodes.
 
 <br>
 <center>
-\image html reorient_2d_volume.png "The orientation of faces is chosen with relation to adjacent volumes."
+\image html reorient_2d_volume.png "The orientation of faces is chosen relatively to adjacent volumes."
 </center>
 
 </li>

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

@@ -33,7 +33,7 @@ The following dialog will appear:
       of following means:
       <ul>
         <li><b>Select the whole mesh, sub-mesh or group</b> activating this
-          checkbox.</li>
+          check-box.</li>
         <li>Choose mesh elements with the mouse in the 3D Viewer. It is
           possible to select a whole area with a mouse frame.</li>
         <li>Input the element IDs directly in <b>Node IDs</b>, <b>Edge
@@ -46,14 +46,14 @@ The following dialog will appear:
     </li>
     <li>Specify the \b Axis of revolution:
       <ul>
-        <li>Specify the cooordinates of the start \b Point of the
+        <li>Specify the coordinates of the start \b Point of the
           axis of revolution; either directly or by picking a node
           in the Viewer (selection of nodes is activated as you click
           the \a Selection button).</li>
         <li>Specify the \b Vector of the axis in either of three ways:
           <ul>
             <li>directly adjust vector components;</li>
-            <li>click \a Selection button, chose <em>From Origin to
+            <li>click \a Selection button, choose <em>From Origin to
                 selected Point</em> in the opened menu and pick a node
                 in the Viewer; </li>
             <li>click \a Selection button, chose <em>Normal to

doc/salome/gui/SMESH/input/selection_filter_library.doc

@@ -27,14 +27,14 @@ criteria. The \b Insert button creates a new criterion before the
 selected criterion. The \b Remove button deletes the selected
 criterion. The \b Clear button deletes all criteria.
 \n Each <b>Entity type</b> has its specific list of criteria, however all
-filters have common syntax. For each criterion you should specify the
+filters have common syntax. The <b>Threshold Value</b> should be specified 
-<b>Threshold Value</b> and for numerical criteria whether we search
+for most criteria. For numerical criteria it is necessary to indicate if 
-for the elements that should be \b More, \b Less or \b Equal to this
+the found elements should be \b More, \b Less or \b Equal to this
 \b Value. You can also reverse the sense of a criterion using \b Unary
 operator \a Not and you should specify logical relations between
 criteria using \b Binary operators \a Or and \a And.
 \n Some criteria have the additional parameter of \b Tolerance.<br> 
-Switching on <b>Insert filter in viewer</b> checkbox limits
+Switching on <b>Insert filter in viewer</b> check-box limits
 selection of elements in the Viewer to the current filter.
 <br>
 In the \b Source field you choose if the filter will be applied to
@@ -72,7 +72,7 @@ algorithm works faster, if this is any other
 shape, the algorithm works slower.
 </li><li>
 <b>Belong to Mesh Group</b> selects entities included into the mesh group
-defined by <b>Threshold Value</b>.
+defined by the <b>Threshold Value</b>.
 </li><li>
 <b>Range of IDs</b> allows selection of entities with the specified
 IDs. 
@@ -102,7 +102,7 @@ defined by the <b>Threshold Value</b>. The list of available geometric
 types depends on the current entity type.
 </li><li>
 <b>Entity type</b> allows selection of elements by their type defined
-as combination of geometry type + number of nodes.
+as a combination of geometry type and the number of nodes.
 </li>
 </ul>
 

doc/salome/gui/SMESH/input/smoothing.doc

@@ -3,8 +3,11 @@
 \page smoothing_page Smoothing
 
 \n Smoothing is used to improve quality of 2D mesh by adjusting the
-locations of element corners (nodes). \note Depending on smoothing
+locations of element corners (nodes). 
-method and mesh geometry smoothing can decrease quality of elements.
+
+\note Depending on the chosen method and mesh geometry
+the smoothing can actually decrease the quality of elements and even
+make some elements inverted.
 
 <em>To apply smoothing to the elements of your mesh:</em>
 <ol>

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

@@ -64,21 +64,21 @@ possible to select a whole area with a mouse frame; or</li>
 
 <li>specify the conditions of symmetry operation:
 <ul>
-<li>activate <b>Move elements</b> radio button to change location of
+<li>activate <b>Move elements</b> radio button to change the location of
   the selected elements within the current mesh;</li>
 <li>activate <b>Copy elements</b> radio button to duplicate the
   selected elements at the new location within the current mesh;</li>
-<li>activate <b>Create as new mesh</b> radio button to create new
+<li>activate <b>Create as new mesh</b> radio button to create a new
   element in a new mesh; the new mesh appears in the Object Browser
-  with the default name MeshName_mirrored (it is possible to change
+  with the default name \a MeshName_mirrored (it is possible to change
   this name in the adjacent box);</li>
-<li>activate <b> Copy groups </b> checkbox to put new mesh enities
+<li>activate <b> Copy groups </b> check-box to put new mesh entities
-  into new groups if source entities belongs to some groups. New
+  into new groups if source entities belong to some groups. New
   groups are named by pattern "<old group name>_mirrored".</li>
 </ul>
 </li>
 </ul>
-<li>activate <b>Preview</b> checkbox to show the result of
+<li>activate <b>Preview</b> check-box to show the result of
   transformation in the viewer;</li>
 <li>click \b Apply or <b> Apply and Close</b> button to confirm the
   operation.</li>

doc/salome/gui/SMESH/input/uniting_set_of_triangles.doc

@@ -2,7 +2,7 @@
 
 \page uniting_set_of_triangles_page Uniting a set of triangles
 
-\n In MESH you can union many neighboring triangles (cells) into
+\n It is possible to unite many neighboring triangles into
 quadrangles by deletion of the common edge.
 
 <em>To union several triangles:</em>
@@ -10,7 +10,7 @@ quadrangles by deletion of the common edge.
 <li>Select a mesh (and display it in the 3D Viewer if you are going to
   pick elements by mouse).</li>
 <li>In the \b Modification menu select the <b>Union of triangles</b>
-  item or click <em>"Union of triangles"</em> button in the toolbar.
+  item or click <em>"Union of triangles"</em> button in the tool-bar.
 
 \image html image80.png
 <center><em>"Union of triangles" button</em></center>

doc/salome/gui/SMESH/input/uniting_two_triangles.doc

@@ -2,14 +2,14 @@
 
 \page uniting_two_triangles_page Uniting two triangles
 
-\n In MESH you can union two neighboring triangles (cells) by deletion
+\n In MESH you can union two neighboring triangles by deletion
 of the common edge.
 
 <em>To unite two triangles:</em>
 <ol>
 <li>From the \b Modification menu choose the <b>Union of two
 triangles</b> item or click <em>"Union of two triangles"</em> button
-in the toolbar.
+in the tool-bar.
 
 \image html image71.png
 <center><em>"Union of two triangles" button</em></center>
@@ -20,7 +20,7 @@ The following dialog box shall appear:
 
 </li>
 <li>Enter IDs of nodes forming the required edge in the \b Edge field
-  (the node IDs must be separated by a dash) or select this edge in
+  (a couple of node IDs separated by a dash) or select this edge in
   the 3D viewer.</li>
 <li>Click the \b Apply or <b>Apply and Close</b> button.</li>
 </ol>