Update help pages for Vertex, Face and Shell features (issue #3102)

[modules/shaper.git] / src / BuildPlugin / doc / faceFeature.rst

diff --git a/src/BuildPlugin/doc/faceFeature.rst b/src/BuildPlugin/doc/faceFeature.rst
index aee91f3a12f8b16d7652d4dd282ebf808120db10..3552530903fbaabb03e44826089f2f9de1b3ef7a 100644 (file)
--- a/src/BuildPlugin/doc/faceFeature.rst
+++ b/src/BuildPlugin/doc/faceFeature.rst
@@ -1,4 +1,5 @@
 .. _buildFace:
+.. |feature_face.icon|    image:: images/feature_face.png
 
 Face
 ====
@@ -8,13 +9,7 @@ Face feature creates one or several faces using shapes already existing in other
 To create a face in the active part:
 
 #. select in the Main Menu *Build - > Face* item  or
-#. click **Face** button in the toolbar
-
-.. image:: images/feature_face.png
-  :align: center
-
-.. centered::
-  **Face** button
+#. click |feature_face.icon| **Face** button in the toolbar
 
 The following property panel will be opened:
    
@@ -26,13 +21,19 @@ The following property panel will be opened:
   
 Select one or several faces in viewer. Additionally, a face can be build by a closed wire or a set of edges composing a closed wire.
 
+It also allowed to select a whole sketch result from the object browser. In this case, the smallest closed contour of the sketch will be transformed to the planar face.
+
 **Apply** button creates faces.
 
 **Cancel** button cancels the operation. 
 
-**TUI Command**:  *model.addFace(Part_doc, Shapes)*
+**TUI Command**:
+
+.. py:function:: model.addFace(Part_doc, Shapes)
 
-**Arguments**:   Part document + list of shapes.
+    :param part: The current part object.
+    :param list: A list of shapes.
+    :return: Result object.
 
 Result
 """"""