X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Fpartition_explanation.doc;h=2725784af305eef0df6037f4468289bc864bebcb;hb=00621ab4f35ece96476fc358acf598d78ec0a95d;hp=ecc6410519c2cab6a4bec9210b84d0c261721cc2;hpb=5d094b2282c1daab114e4ebf563afaa013e8ab2a;p=modules%2Fgeom.git

diff --git a/doc/salome/gui/GEOM/input/partition_explanation.doc b/doc/salome/gui/GEOM/input/partition_explanation.doc
index ecc641051..2725784af 100644
--- a/doc/salome/gui/GEOM/input/partition_explanation.doc
+++ b/doc/salome/gui/GEOM/input/partition_explanation.doc
@@ -1,27 +1,55 @@
-/*!\page partition_explanation Fuse, Partition and Compound usage
+/*!
 
-It is frequently asked about the difference between the above mentioned operations. It's indeed simple. Lets take the example of a cylinder and a box that you want to join together.
+\page partition_explanation Fuse, Partition and Compound usage
+
+\tableofcontents
 
-\b Fuse
+It is frequently asked about the difference between the above mentioned operations. It's indeed simple. Lets take the example of a cylinder and a box that you want to join together.
 
-The \b fuse operation will make a <b>single solid</b> from the two given solids :
+\section sec1 Fuse
 
+The \b fuse operation will make a <b>single solid</b> from the two given solids. It allows you to build complex models by putting simple shapes together.
 \image html fuse.png
 
-\b Partition
-
-The \b partition operation will do basically the same but it will <b>keep a face at the frontier between the two solids</b> (in brown on the picture below). 
-This face is shared by the two solids, which means that this face is present only one time in the resulting shape and is a sub-shape of the box and a sub-shape of the cylinder.
+\section sec2 Partition
+The \b partition operation will also connect the two solids but it will <b>keep a face at the frontier</b> (in brown on the picture below). The resulting shape will consist in <b>two connected solids</b> that share 
+a face at their frontier. It means that this face is present only one time in the resulting shape and is a sub-shape of both the box and the cylinder.
 
-This operation allows you to identify different areas in a shape (e.g. different materials) and to ensure a conformal mesh when meshing it later. Indeed the face at the frontier is meshed only one time. 
+\n This operation allows you to identify different areas in a shape (e.g. different materials) and to ensure a <b>conformal mesh</b> when meshing it later. Indeed the face at the frontier is meshed only once. 
 
 \image html partition.png
 
-\b Compound
 
+\section sec3 Compound
 When you build a \b compound by using the build -> compound operation you just make <b>an object that contains the two separate solids</b> like in a "bag".
 The two solids remain unconnected. The compound is just a set of shapes, no more.
 
+\n The compound Allows applying operations to a collection of shapes.
+
 \image html compound2.png
 
+
+\section sec4 Summary
+
+In the frame of this example we can summarize the following differences:
+
+<ul>
+<li> \b Fuse 
+<ul>
+<li> \a Result : A <b>single solid</b>. </li>
+<li> \a Purpose : Allows building complex models by putting simple shapes together.</li>
+</ul>
+<li> \b Partition
+<ul>
+<li>\a Result : Two <b>connected solids</b> sharing faces.</li>
+<li>\a Purpose : Useful to ensure a conformal mesh of separated areas of your model (fluid / solid , concrete / steel ...)</li>
+</ul>
+<li> \b Compound
+<ul>
+<li>\a Result : Two <b>unconnected solids</b>.</li>
+<li>\a Purpose : Allows applying operations to a collection of shapes.</li>
+</ul>
+</ul>
+
+
 */
\ No newline at end of file