X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=src%2FBuildPlugin%2Fdoc%2FfaceFeature.rst;h=57f37737beb14f3a4a397df5e183ab96a1752ada;hb=79470833af46e5a11abc700ebd07a26ec3e2d5a0;hp=384a3b06b27401c8a167bd3b656ec9d5b26315bc;hpb=b73fb7468bea81901dbeed8e229d742f788ec282;p=modules%2Fshaper.git

diff --git a/src/BuildPlugin/doc/faceFeature.rst b/src/BuildPlugin/doc/faceFeature.rst
index 384a3b06b..57f37737b 100644
--- a/src/BuildPlugin/doc/faceFeature.rst
+++ b/src/BuildPlugin/doc/faceFeature.rst
@@ -1,48 +1,47 @@
 .. _buildFace:
+.. |feature_face.icon|    image:: images/feature_face.png
 
 Face
 ====
 
-The Face feature creates one or several faces using already existing faces in other objects.
+Face feature creates one or several faces using shapes already existing in other objects.
 
-To create face in the active part:
+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:
    
-.. image:: images/Face.png
+.. figure:: images/Face.png
   :align: center
 
-.. centered::
   Create a face
   
-Select one or several faces in viewer.
+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 is also possible 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 operation. 
+**Cancel** button cancels the operation. 
+
+**TUI Command**:
 
-**TUI Command**:  *model.addFace(Part_doc, Shapes)*
+.. 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
 """"""
 
-The result of the operation will be set of faces created from selected shapes:
+The result of the operation will be a set of faces created from the selected shapes:
 
-.. image:: images/CreateFace.png
+.. figure:: images/CreateFace.png
   :align: center
 
-.. centered::
   Result of the operation.
 
-**See Also** a sample TUI Script of a :ref:`tui_create_face` operation.
+**See Also** a sample TUI Script of :ref:`tui_create_face` operation.