X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Fdependency_tree.doc;h=e44dba4004e11d2995b53040551f5384bbaa9f21;hb=69b2ec02a2002731ceaf0597fa9f4dd9cd57dc91;hp=ec4aa11e3333c60a77bfaffb1d0380c2d5fc8b73;hpb=8dd08cf7fe70dc1117b7b75544eab22af5f4f9fc;p=modules%2Fgeom.git

diff --git a/doc/salome/gui/GEOM/input/dependency_tree.doc b/doc/salome/gui/GEOM/input/dependency_tree.doc
index ec4aa11e3..e44dba400 100644
--- a/doc/salome/gui/GEOM/input/dependency_tree.doc
+++ b/doc/salome/gui/GEOM/input/dependency_tree.doc
@@ -2,15 +2,29 @@
 
 \page dependency_tree_page Dependency Tree
 
-\n In order to better understand the relations between the %GEOM 
-objects in a study the user has the possibility to display the 
-ascendants and descendant of an object in a family tree.
+<ul>
+<li>\ref dependency_tree_general_description_anchor "General description"</li>
+<li>\ref dependency_tree_nodes_anchor "Nodes" </li>
+<li>\ref dependency_tree_links_anchor "Links" </li>
+<li>\ref dependency_tree_operations_anchor "Operations" </li>
+<li>\ref dependency_tree_navigation_anchor "Navigation" </li>
+<li>\ref dependency_tree_popup_menu_anchor "Context menu"</li>
+</ul>
+
+\anchor dependency_tree_general_description_anchor <h2>General description</h2>
 
-User can build the dependency tree with new main objects by selecting 
-them in Object Browser, in OCC Viewer or in Dependency Tree Viewer 
-and calling corresponding popup menu. When invoked, this menu item 
-will open a 2D view window and display a dependency tree for the 
-selected object or objects (multiple selection is supported).
+In order to better understand the relations between the %GEOM 
+objects in a study the user has a possibility to display the 
+ascendants and descendant of the object(s) in a family tree.
+
+User can build the dependency tree by selecting desirable object 
+in Object Browser or OCC Viewer and calling "Show dependency tree" 
+popup item. It will open a new or clear the existing "Dependency 
+Tree" view window (only one view is supported) and display a 
+dependency tree for the selected object or objects (multiple 
+selection is supported). Also user can rebuild the tree if to select 
+some object(s) right in the "Dependency Tree" view and call 
+"Rebuild the tree" popup menu item.
 
 \image html tree_example.png
 
@@ -18,67 +32,67 @@ User can change all necessary parameters of Dependency Tree Viewer
 in \ref pref_dependency_tree "Preferences".
 
 <hr>
-\anchor dependency_tree_nodes <h2>Nodes</h2>
+\anchor dependency_tree_nodes_anchor <h2>Nodes</h2>
 
 Tree nodes in the Dependency Viewer are named according to the study 
 names of the corresponding objects. 
 
-Non-published objects are shown in the tree as "unpublished" and are 
-colored in special for non-published objects color.
+Non-published objects are shown in the tree as "unpublished" and 
+colored in special color.
 
-The long name of the object is displayed in a shortened version; 
-full name of the object can be seen in the tool tip when the cursor 
-is on the node.
+All nodes have the fixed size, so the long names are cut and shown 
+with ellipsis; full name of the object can be seen in the tooltip 
+if to keep the cursor over the node.
 
-Dependency Tree Viewer supports the following states of nodes:
+"Dependency Tree" view supports the following states of nodes:
 
-\image html tree_main_node.png
-<ul><li><b>Main node</b> - node of main object, selected in Object 
+<ul><li><b>Main node</b> - node of main object(s), which were selected in Object 
 Browser, OCC Viewer or Dependency Tree Viewer in order to build the 
 dependency tree;</li></ul>
+\image html tree_main_node.png
 
-\image html tree_default_node.png
-<ul><li><b>Default node</b> - node, which participate in building of 
+<ul><li><b>Default node</b> - node of published in study object, which participate in building of 
 dependency tree as ascendant or descendant;</li></ul>
+\image html tree_default_node.png
 
+<ul><li><b>Unpublished node</b> - the same as "Default node", but 
+corresponding object was not published in study;</li></ul>
 \image html tree_unpublished_node.png
-<ul><li><b>Unpublished node</b> - node of non-published in study 
-object;</li></ul>
 
+<ul><li><b>Highlighted node</b> - the state of node when mouse 
+cursor is over it;</li></ul>
 \image html tree_highlighted_node.png
-<ul><li><b>Highlighted node</b> - the state of node when mouse is 
-near or on it;</li></ul>
 
+<ul><li><b>Selected node</b> - the state of node when user 
+clicks the left mouse button on node.</li></ul>
 \image html tree_selected_node.png
-<ul><li><b>Selected node</b> - the state of selected node when 
-clicking left mouse button on node.</li></ul>
 
 <hr>
-\anchor dependency_tree_links <h2>Links</h2>
+\anchor dependency_tree_links_anchor <h2>Links</h2>
 
 Dependency Tree Viewer shows oriented links between nodes to 
 represent dependency direction. Viewer supports the following states 
 of links:
 
+<ul><li><b>Unidirectional link</b> - shows that A object depends on 
+B object;</li></ul>
 \image html tree_unidir_link.png
-<ul><li><b>Unidirectional link</b> - shows that object A depends on 
-the object B;</li></ul>
 
+<ul><li><b>Bidirectional link</b> - shows that A object depends on 
+B object and, at the same time, B object depends on 
+A object;</li></ul>
 \image html tree_bidir_link.png
-<ul><li><b>Bidirectional link</b> - shows that object A depends on 
-the object B and at the same time object B depends on 
-the object A;</li></ul>
 
-\image html tree_selfdep_link.png
 <ul><li><b>Self-dependency link</b> - shows that object depends on 
 itself;</li></ul>
+\image html tree_selfdep_link.png
 
-\image html tree_cycldep_link.png
 <ul><li><b>Cyclic dependency links</b> - shows cyclic dependency of 
 some nodes.</li></ul>
+\image html tree_cycldep_link.png
 
 <hr>
-\anchor dependency_tree_operations <h2>Operations</h2>
+\anchor dependency_tree_operations_anchor <h2>Operations</h2>
 
 The dependency tree of a chosen %GEOM object is displayed in 
 the dedicated 2D view window.
@@ -91,46 +105,38 @@ mouse button.
 
 \image tree_tool_bar
 
-\image html tree_view_dump.png
-
 <b>Dump View</b> - exports an object from the viewer in bmp, png or
 jpeg image format.
-
-\image html tree_view_fitall.png
+\image html tree_view_dump.png
 
 <b>Fit all</b> - scales the presentation so that it could fit within
 the Viewer boundaries.
-
-\image html tree_view_fitarea.png
+\image html tree_view_fitall.png
 
 <b>Fit area</b> - resizes the view to place in the visible area only
 the contents of a frame drawn with pressed left mouse button.
-
-\image html tree_view_fitselect.png
+\image html tree_view_fitarea.png
 
 <b>Fit selection</b> - resizes the view to fit in the visible area
 only currently selected objects.
-
-\image html tree_view_zoom.png
+\image html tree_view_fitselect.png
 
 <b>Zoom</b> - allows to zoom in and out.
-
-\image html tree_view_pan.png
+\image html tree_view_zoom.png
 
 <b>Panning</b> - if the represented objects are greater that the
 visible area and you don't wish to use <b>Fit all</b> functionality,
 click on this button and you'll be able to drag the scene to see its
 remote parts.
-
-\image html tree_view_glpan.png
+\image html tree_view_pan.png
 
 <b>Global panning</b> - allows to select a point to be the center of
 the presentation showing all displayed objects in the visible ares.
-
-\image html tree_hierarchy_type.png
+\image html tree_view_glpan.png
 
 <b>Hierarchy depth</b> - allows to change the number of hierarchy 
 levels to be shown in the dependency tree.
+\image html tree_hierarchy_type.png
 <ul>
 <li>Level 1 corresponds to the parents and children of the selected 
 object(s);</li>
@@ -139,32 +145,31 @@ of the selected object(s);</li>
 <li>etc...</li>
 </ul>
 
-\image html tree_disp_ascendants.png
-
-<b>Display ascendants</b> - allows to customize the display 
+<b>Display ascendants</b> - allows user to control the displaying 
 of ascendants.
+\image html tree_disp_ascendants.png
 
-\image html tree_disp_descendants.png
-
-<b>Display descendants</b> - allows to customize the display 
+<b>Display descendants</b> - allows user to control the displaying 
 of descendants.
+\image html tree_disp_descendants.png
 
+<b>Move nodes</b> - enables/disables of moving the nodes.
 \image html tree_move_nodes.png
 
-<b>Move nodes</b> - allows to customize the moving of nodes.
-
+<b>Update</b> - allows user to update a dependency tree model and the view.
 \image html tree_button_update.png
 
-<b>Update</b> - allows to update a dependency tree model and a view.
-
 <hr>
-\anchor dependency_tree_navigation <h2>Navigation</h2>
+\anchor dependency_tree_navigation_anchor <h2>Navigation</h2>
 
 Dependency Tree 2D Viewer supports the following navigation mode:
 
-Rectangle selection in this mode is performed by the left mouse 
-button; multiple selection is available when \b Shift button 
-is pressed.
+<ul>
+<li>rectangle selection in this mode is performed by the left mouse 
+button</li>;
+<li>multiple selection is available when \b Shift button 
+is pressed.</li>
+</ul>
 
 Also, holding \b Ctrl key with pressed mouse buttons performs 
 the following view transformations:
@@ -174,14 +179,14 @@ the following view transformations:
 </ul>
 
 <hr>
-\anchor dependency_tree_popup_menu <h2>Popup Menu</h2>
+\anchor dependency_tree_popup_menu_anchor <h2>Popup Menu</h2>
 
 After the object has appeared in the Dependency Tree 2D Viewer, 
-you can select it with left mouse click to change its presentation 
-parameters and access to other useful options by right-clicking on 
+user can select it with left mouse click to change its presentation 
+parameters and get access to other useful options by right-clicking on 
 the selected object.
 
-\image html tree_popup_menu.png
+\image html tree_popup_menu1.png
 
 <ul>
 <li>\b Show - allows to show selected object(s) in OCC 3D Viewer;</li>
@@ -189,6 +194,7 @@ the selected object.
 in OCC 3D Viewer;</li>
 <li><b> Rebuild the tree</b> - allows to rebuild the dependency tree 
 for selected object(s);</li>
+<li>\ref reduce_study_page "Reduce study" - allows to reduce study.</li>
 </ul>
 
 Some functionalities are available through right-clicking on