Update GUI documentation for bug 16716

NPAL16716: Compound. To create the groups of the initial meshes. Awoiding to create empty groups.

NPAL16716: Compound. To create the groups of the initial meshes.

Update of GUI documentation for bugs:
16202, 16203, 16617, 16842, 17694

NPAL16812: Elements Info dialog is added. Icon updated.

NPAL16812: Elements Info dialog is added. Icon deleted.

NPAL18033: EDF612: Mesh stay displayed when we click on Erase all.

NPAL16812: Elements Info dialog is added. The size of dialog is modified.

NPAL16812: Elements Info dialog is added

NPAL18076: EDF617: Regression smesh.py Only the 1st netgen parameters is added/used.

NPAL18025: Regression between 3.2.6 and 3.2.9rc1 about SMESH display

PAL16842 (Genertion of groups when a mesh is transformed)
  fix names generation in generateGroups()

Fix bug 17903: Problem with closing studies.

Fix bug 17655: 'Show' and 'Display only' don't work on Mesh root object.

PAL16617 (Modification/Transformation operations with copy don't create a new mesh)
   merge with V_4

PAL16617 (Modification/Transformation operations with copy don't create a new mesh)
+msgid "SMESH_MOVE_ELEMENTS"
+msgid "SMESH_COPY_ELEMENTS"
+msgid "SMESH_CREATE_MESH"
+msgid "SMESH_MAKE_GROUPS"
+msgid "SMESH_COPY_GROUPS"

PAL16617 (Modification/Transformation operations with copy don't create a new mesh)
+  QString UniqueMeshName(const char* theBaseName, const char* thePostfix);

PAL16617 (Modification/Transformation operations with copy don't create a new mesh)
+  virtual bool Contains (const SMDS_MeshElement* elem);

PAL16617 (Modification/Transformation operations with copy don't create a new mesh)
   PGroupIDs Transform (TIDSortedElemSet & theElements,
                        const gp_Trsf&     theTrsf,
                        const bool         theCopy,
-                       const bool         theMakeGroups);
+                       const bool         theMakeGroups,
+                       SMESH_Mesh*        theTargetMesh=0);

PAL16617 (Modification/Transformation operations with copy don't create a new mesh)

+    SMESH_Mesh MirrorMakeMesh (in long_array IDsOfElements,
+    SMESH_Mesh MirrorObjectMakeMesh (in SMESH_IDSource theObject,
+    SMESH_Mesh TranslateMakeMesh (in long_array IDsOfElements,
+    SMESH_Mesh TranslateObjectMakeMesh (in SMESH_IDSource theObject,
+    SMESH_Mesh RotateMakeMesh (in long_array IDsOfElements,
+    SMESH_Mesh RotateObjectMakeMesh (in SMESH_IDSource theObject,

NPAL 13421

Change version to 3.2.8

PAL17694 (New Tool About Hexahedral Meshing)
+ StdMeshers_UseExisting_1D2D_i.cxx

PAL17694 (New Tool About Hexahedral Meshing)
+ StdMeshers_UseExisting_1D2D.hxx

PAL17694 (New Tool About Hexahedral Meshing)
+    void SetNodeOnVertex(in long NodeID, in long VertexID)
+    void SetNodeOnEdge(in long NodeID, in long EdgeID, in double paramOnEdge)
+    void SetNodeOnFace(in long NodeID, in long FaceID, in double u, in double v)
+    void SetNodeInVolume(in long NodeID, in long SolidID)
+    void SetMeshElementOnShape(in long ElementID, in long ShapeID)

PAL17694 (New Tool About Hexahedral Meshing)
+  SMESH::NodePosition* GetNodePosition(CORBA::Long NodeID);

PAL17694 (New Tool About Hexahedral Meshing)
     Do not clean submesh before algo->Compute()

PAL17694 (New Tool About Hexahedral Meshing)
+    <algorithm type="UseExisting_1D"
+               label-id="Use existing edges"
+               icon-id="mesh_algo_regular.png"
+               input="VERTEX"
+               output="EDGE"
+               dim="1"/>
+
+    <algorithm type="UseExisting_2D"
+               label-id="Use existing faces"
+               icon-id="mesh_algo_quad.png"
+               input="EDGE"
+               output="QUAD,TRIA"
+               dim="2"/>

PAL17694 (New Tool About Hexahedral Meshing)
+  /*!
+   * Node location on a shape
+   */
+  struct NodePosition {
+    long             shapeID;
+    GEOM::shape_type shapeType;
+    double_array     params; // [U] on EDGE, [U,V] on FACE, [] on the rest shapes
+  };
+     * \brief Return position of a node on shape
+     */
+    NodePosition GetNodePosition(in long NodeID);
+
+    /*!

PAL17694 (New Tool About Hexahedral Meshing)
+  /*!
+   * StdMeshers_UseExisting_2D: interface of "UseExisting 2D" algorithm
+   * doing nothing to allow mesh generation by mesh edition functions in TUI mode
+   */
+  interface StdMeshers_UseExisting_2D : SMESH::SMESH_2D_Algo
+  {
+  };
+
+  /*!
+   * StdMeshers_UseExisting_1D: interface of "UseExisting 1D" algorithm
+   * doing nothing to allow mesh generation by mesh edition functions in TUI mode
+   */
+  interface StdMeshers_UseExisting_1D : SMESH::SMESH_1D_Algo
+  {
+  };
+

PAL16842 (Genertion of groups when a mesh is transformed)
    add MakeGroups=False argument

PAL16842 (Genertion of groups when a mesh is transformed)
+  CORBA::Long NbGroups()

PAL16842 (Genertion of groups when a mesh is transformed)
    add *MakeGroups() methods

PAL16842 (Genertion of groups when a mesh is transformed)
+  QCheckBox*        MakeGroupsCheck;

PAL16842 (Genertion of groups when a mesh is transformed)
+  /*!
+   * \brief Create groups of elements made during transformation
+   * \param nodeGens - nodes making corresponding myLastCreatedNodes
+   * \param elemGens - elements making corresponding myLastCreatedElems
+   * \param postfix - to append to names of new groups
+   */
+  PGroupIDs generateGroups(const SMESH_SequenceOfElemPtr& nodeGens,
+                           const SMESH_SequenceOfElemPtr& elemGens,
+                           const std::string&             postfix);

PAL16842 (Genertion of groups when a mesh is transformed)
+  typedef boost::shared_ptr< SMDS_Iterator<SMESH_Group*> > GroupIteratorPtr;
+  GroupIteratorPtr GetGroups() const;

PAL16842 (Genertion of groups when a mesh is transformed)
-#include <SMDSAbs_ElementType.hxx>
+#include "SMDSAbs_ElementType.hxx"

PAL16842 (Genertion of groups when a mesh is transformed)
+        SMDSAbs_NbElementTypes

PAL16842 (Genertion of groups when a mesh is transformed)
    add *MakeGroups() methods

PAL16842 (Genertion of groups when a mesh is transformed)
+    long NbGroups()

PAL16774 (Crash after display of many groups)
+  void RemoveVisuData(int studyID);
-  void UpdateView (SUIT_ViewWindow*,
+  bool UpdateView (SUIT_ViewWindow*,

PAL16202,16203 (Propagation 1D on edges group)
   source shape can be a group

PAL16774 (Crash after display of many groups)
    throw if there are errors in buildPrs()

PAL16202,16203 (Propagation 1D on edges group)
   1) fix error message when Mesh.Compute() fails due to bad hypo definition
   2) fix args of TreatHypoStatus() calls

PAL16774 (Crash after display of many groups)
     add SMESH_VISU_PROBLEM_CLEAR

PAL16202,16203 (Propagation 1D on edges group)
   remove useless includes

PAL16202,16203 (Propagation 1D on edges group)
   source shape can be a group

PAL16202,16203 (Propagation 1D on edges group)
   remove useless includes

PAL16774 (Crash after display of many groups)
    prepare to mesh deletion at closing a study

PAL16202,16203 (Propagation 1D on edges group)
     1) avoid double "Salome exception" in error description
     2) select mesh after visualization

PAL16202,16203 (Propagation 1D on edges group)
- *                * theNumber       - Number of subshapes. Object is selected if it contains theNumber of
- *                                    theSubShapeType sub-shapes
+ *                * theNumber       - Number of subshapes. Object is selected if it contains
+ *                                    theNumber of theSubShapeType sub-shapes, or at least
+ *                                    one theSubShapeType, provided that theNumber==0

PAL16202,16203 (Propagation 1D on edges group)
   remove useless includes and
+  /*!
+   * \brief Return submeshes of groups containing the given subshape
+   */
+  std::list<SMESH_subMesh*> GetGroupSubMeshesContaining(const TopoDS_Shape & shape) const
+    throw(SALOME_Exception);

PAL16202 (Propagation 1D on edges group)
   remove useless includes

PAL16202 (Propagation 1D on edges group)
+  SMESHDS_SubMeshIteratorPtr GetSubMeshIterator() const;

PAL16774 (Crash after display of many groups)
+  void RemoveVisuData(int studyID);
-  void UpdateView (SUIT_ViewWindow*,
+  bool UpdateView (SUIT_ViewWindow*,

PAL16774 (Crash after display of many groups)
+  virtual void                studyClosed( SUIT_Study* );

PAL16774 (Crash after display of many groups)
+  virtual void                studyClosed( SUIT_Study* );
        and catch during visualization

PAL17233: Projection 2D doesn't work (bis)
     exclude using compUVByElasticIsolines()

NPAL17241: EDF590: Keyboard shortcuts for removing and renaming an object.

NPAL 16561

+  // double delta = d1*d2*1e-6; PAL17233
+  double delta = min( d1, d2 ) / 10.;

Update docs for smesh.py.

Fix to provide correct doxygen working: avoid usage of single quote in comments.

Update GUI documentation for NPAL16765

PAL16774 (Crash after display of many groups)
    implement destructor

PAL14858 (The Mesh Info Dialog Box is too slow)
    fix mesh update

PAL17091 ("Mesh Infos" dlg shows wrong number of quadrangles of the computed mesh)
    take into account element type change at merging nodes

Change version to 3.2.8

PAL16567(problem with extrusion 3D, Propagation 2D when the source fase isn't planar)
-  int    myFaceIndex = -1;
-  double myFaceParam = 0.;
+  myFaceIndex = -1;
+  myFaceParam = 0.;

PAL14858 (The Mesh Info Dialog Box is too slow)
    fix the previous integration

PAL14858 (The Mesh Info Dialog Box is too slow)
    replace ::SMESH_Mesh::ElementOrder with SMDSAbs_ElementOrder

PAL14858 (The Mesh Info Dialog Box is too slow)
    use SMDS_MeshInfo to nkow nb of entities

PAL14858 (The Mesh Info Dialog Box is too slow)
+  SMDS_MeshInfo          myInfo;

PAL14858 (The Mesh Info Dialog Box is too slow)
+enum SMDSAbs_ElementOrder {
+  ORDER_ANY,          /*! entities of any order */
+  ORDER_LINEAR,       /*! entities of 1st order */
+  ORDER_QUADRATIC     /*! entities of 2nd order */
+};

PAL14858 (The Mesh Info Dialog Box is too slow)
+ SMDS_MeshInfo.hxx

PAL16631 (SALOME crash after a mesh computation failed due to lack of memory)

PAL16631 (SALOME crash after a mesh computation failed due to lack of memory)
   use SMDS_MemoryLimit in CheckMemory() to know a lower memory limit

PAL16631 (SALOME crash after a mesh computation failed due to lack of memory)
+BIN = SMDS_MemoryLimit

PAL16631 (SALOME crash after a mesh computation failed due to lack of memory)
-  void Update(const Handle(SALOME_InteractiveObject)& theIO,
+  bool Update(const Handle(SALOME_InteractiveObject)& theIO,

PAL16631 (SALOME crash after a mesh computation failed due to lack of memory)
  fix misspelling

+  SMDS_Mesh::CheckMemory(); // PAL16631

+  SMDS_Mesh::CheckMemory(); // PAL16631

Fix for Bug NPAL16771(EDF 556 SMESH : Can't select some groups of nodes in the VTK view).

PAL16892 (impossible to create Distribution of Layers hypothesis, for Radial Prism 3D algorithm)
-  myHypTypes = SMESH::GetAvailableHypotheses( false, 0 );
+  myHypTypes = SMESH::GetAvailableHypotheses( false, 1 );

+        // PAL16857(SMESH not conform to the MED convention):
+        if ( aMeshDimension == 2 && anIsZDimension ) // 2D only if mesh is in XOY plane
+          aMeshDimension = 3;

PAL16774,PAL16631(SALOME crash after a mesh computation that failed because of lack of memory)
    Catch exceptions during visualization

PAL16774,PAL16631(SALOME crash after a mesh computation that failed because of lack of memory)
    Precise error message

PAL16774,PAL16631(SALOME crash after a mesh computation that failed because of lack of memory)
-  bool CheckMemory()
+  int CheckMemory() - return size of free memory

PAL16774,PAL16631(SALOME crash after a mesh computation that failed because of lack of memory)
-  void Update( int theIsClear = true );
+  bool Update( int theIsClear = true );

PAL16774,PAL16631(SALOME crash after a mesh computation that failed because of lack of memory)
1)
-  void Update( int theIsClear = true );
+  bool Update( int theIsClear = true );
2) Do not catch here

-       FitAll();
+       // FitAll(); - PAL16770(Display of a group performs an automatic fit all)

PAL16834 (smesh Prism don't work with NETGEN_2D algorithm)
     fix regression involved by the previous fix

PAL16834 (smesh Prism don't work with NETGEN_2D algorithm)
     fix FindMatchingNodesOnFaces() for a sphere meshed by NETGEN_2D_ONLY

PAL16773: First display of a group of nodes appears as not selected in VTK.
-      myHighlitableActor->SetVisibility(anIsVisible);
       myHighlitableActor->GetExtractUnstructuredGrid()->
  SetModeOfExtraction(VTKViewer_ExtractUnstructuredGrid::ePoints);
+      myHighlitableActor->SetVisibility(anIsVisible);

PAL16753 (selection bug in GUI)
   enble extrusion of not shown mesh

NPAL16631: EDF281: Suppress automatic update if mesh computation failed because of lack of memory.

NPAL16690: EDF532: 'Add Node' and 'Move Node' coordinates are limited to 3 digits.

PAL16713 (mesh.GetElementsByType : 'module' object has no attribute 'SMESH')
+import SMESH # necessary for back compatibility
 from   SMESH import *

NPAL16631: EDF281: Crash on update mesh if computation failed because of memory lack.

PAL16229 (Issue in order to mesh with Hexahedron algorithms)
     do not check shape topology in CheckHypothesis()