X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FFeaturesPlugin%2Fdoc%2FcutFeature.rst;h=9a99224068308aa9988977f7fbc173a021c03233;hb=0fcd69345a4dfdb31e252574c68bc70e123999e8;hp=e381c7c984ee0b038d64dde3009fcbb7138746e9;hpb=547a3952b37fe76f0d4e031a7d8a943ac6a45bb5;p=modules%2Fshaper.git

diff --git a/src/FeaturesPlugin/doc/cutFeature.rst b/src/FeaturesPlugin/doc/cutFeature.rst
index e381c7c98..9a9922406 100644
--- a/src/FeaturesPlugin/doc/cutFeature.rst
+++ b/src/FeaturesPlugin/doc/cutFeature.rst
@@ -1,10 +1,67 @@
+.. _featureCut:
+.. |bool_cut.icon|    image:: images/bool_cut.png
 
 Cut
 ===
 
+Cut feature implements a Boolean operation to cut tool objects from main objects.
 
-.. image:: images/Cut.png
+To perform a Cut operationin the active part:
+
+#. select in the Main Menu *Features - > Cut* item  or
+#. click |bool_cut.icon| **Cut** button in the toolbar
+
+The following property panel will be opened:
+
+.. image:: images/boolean_cut_property_panel.png
   :align: center
 
 .. centered::
-  Cut definition
+  **Cut operation**
+
+- **Main Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will be cut by tool objects.
+  Any kind of shape can be selected, including subshapes of compsolids/compounds.
+  In this case only selected subshapes will be cut, others will stay untouched (as much as possible).
+- **Tool Objects** contains a list of objects selected in the Object Browser or in the Viewer, which will cut main objects.
+  Any kind of shape can be selected, including subshapes of compsolids/compounds.
+  Non-selected subshapes from compsolids/compounds will be ignored.
+- **See preview** button shows a result of the operation.
+
+**TUI Command**:
+
+.. py:function:: model.addCut(Part_doc, mainObjects, toolObjects)
+
+    :param part: The current part object
+    :param list: A list of main objects.
+    :param list: A list of tool objects.
+    :return: Created object
+
+Result
+""""""
+
+A result shape which is a cut by tool objects from main object, will be produced for each selected object:
+
+.. image:: images/CreatedCut.png
+   :align: center
+
+.. centered::
+   **Created cut**
+
+If a subsolid (yellow wireframe) of a compsolid was selected:
+
+.. image:: images/boolean_cut_subsolids_arguments.png
+   :align: center
+
+.. centered::
+   **Cut arguments**
+
+it will be cut in the result and not selected subsolids will be added to it:
+
+.. image:: images/boolean_cut_subsolids_result.png
+   :align: center
+
+.. centered::
+   **Cut subsolid result**
+
+
+**See Also** a sample TUI Script of :ref:`tui_create_cut` operation.