X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=src%2FBuildPlugin%2Fdoc%2FsubShapesFeature.rst;h=d1b767232f6dab1cfe15b35dcf05f02d38af885c;hb=bcd96990e1fca77402d522bc8b095ebfa1091894;hp=e5af6f8002abba075ed229bd931b35973c8c6f6c;hpb=c5ec43297b55923e1cf2ee39978bf42d733ee465;p=modules%2Fshaper.git

diff --git a/src/BuildPlugin/doc/subShapesFeature.rst b/src/BuildPlugin/doc/subShapesFeature.rst
index e5af6f800..d1b767232 100644
--- a/src/BuildPlugin/doc/subShapesFeature.rst
+++ b/src/BuildPlugin/doc/subShapesFeature.rst
@@ -1,3 +1,52 @@
 
 Sub-shapes
 ==========
+
+The feature **Sub-shapes** modifies the selected entity by creating a non-manifold topology. It gives the possibility to:
+
+* add/remove vertices lying on edges of a wire;
+* add/remove edges and vertices lying on a face.
+
+To create Sub-shapes in the active part:
+
+#. select in the Main Menu *Build - > Sub-shapes* item  or
+#. click **Sub-shapes** button in the toolbar
+
+.. image:: images/feature_subshapes.png 
+   :align: center
+
+.. centered::
+   **Sub-shapes** button 
+
+The following property panel appears.
+
+.. image:: images/SubShapes.png
+  :align: center
+
+.. centered::
+  Sub-shapes property panel
+
+Input fields:
+
+- **Shape** panel contains the shape to be modified. The shape is selected in 3D OCC viewer or object browser. For today it has to be a wire or a face;
+- **Sub-shapes** panel contains the list of sub-shapes which are already included into result. A sub-shape can be deleted from the list or the list can be extended with new shapes selected in the view.
+
+**TUI Command**:  *model.addSubShapes(Part_doc, shape, sub-shapes)*
+
+**Arguments**: 1 part + shape in format *model.selection(TYPE, shape)* + list of sub-shapes in format *model.selection(TYPE, subshape)*.
+
+Result
+""""""
+The result replaces the original shape with its copy with added/removed sub-shapes.
+
+.. image:: images/CreateSubShapes.png
+   :align: center
+
+.. centered::
+   Sub-shapes
+
+**See Also** a sample TUI Script of :ref:`tui_create_subshape` operation.
+
+
+  
+