/*!

\page merging_elements_page Merging Elements

\n This functionality allows to merge coincident elements of a mesh
selectable in the dialog box.

\image html mergeelems.png

<ul>
  <li>\b Name is the name of the mesh whose elements will be merged.</li>
  <li>\b Tolerance is a maximum distance between elements sufficient for merging.
    <ul>
      <li>\b Detect button generates the list of coincident elements for the given \b Tolerance.</li>
    </ul></li>
  <li><b>Coincident elements</b> is a list of groupes of elements for
    merging. All elements of each group will form one after the operation.
    <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>
    </ul></li>
  <li><b>Edit selected group</b> list allows editing the selected group:
    <br><br>
    \image html add.gif
    <center>adds to the group the element selected in the viewer.</center>
    <br>
    \image html remove.gif
    <center>removes from the group the selected element.</center>
    <br>
    \image html sort.gif
    <center>moves the selected element to the first position in the
    group. This means that all other elements will be merged into this
    one.</center>
    <br>
  </li>
  <li>To confirm your choice click \b Apply or <b>Apply and Close</b> button.</li>
</ul>

In this picture you see a triangle which coincides with one of the
elements of the mesh. After we apply <b>Merge Elements</b> functionality, the
triangle will be completely merged with the mesh.

\image html meshtrianglemergeelem1.png

<br><b>See Also</b> a sample TUI Script of a
\ref tui_merging_elements "Merge Elements" operation.

*/