[dia] doc: Diagram Tree update

[Hans Breuer <hans src gnome org>]

commit abaa8c550c9484d1c36160879e2b105cdc7e1e5e
Author: Hans Breuer <hans breuer org>
Date:   Sun Apr 24 16:04:48 2011 +0200

    doc: Diagram Tree update
    
    New Diagram Tree has a bunch of fancy new features:
     - nicer look, sorting more obvious (I think)
     - can search for object name by simply typing it
     - multiple selection (works across layers!)
     - allows to transfer the selection to the diagram
     - tooltips for additional information

 doc/en/Makefile.am                        |    2 -
 doc/en/graphics/diagram-tree-sort.png     |  Bin 1485 -> 0 bytes
 doc/en/graphics/diagram-tree.png          |  Bin 14031 -> 33773 bytes
 doc/en/graphics/file-preferences-tree.png |  Bin 19892 -> 0 bytes
 doc/en/usage-customization.xml            |   42 ------------
 doc/en/usage-objects.xml                  |  102 ++++-------------------------
 6 files changed, 14 insertions(+), 132 deletions(-)
---
diff --git a/doc/en/Makefile.am b/doc/en/Makefile.am
index 8730f7b..fd3f6f5 100644
--- a/doc/en/Makefile.am
+++ b/doc/en/Makefile.am
@@ -125,7 +125,6 @@ pngfigures = \
 	graphics/toolbox-magnify.png \
 	graphics/diagram-properties.png \
 	graphics/toolbox-modify.png \
-	graphics/diagram-tree-sort.png \
 	graphics/toolbox-scroll.png \
 	graphics/diagram-tree.png \
 	graphics/toolbox-special.png \
@@ -134,7 +133,6 @@ pngfigures = \
 	graphics/file-preferences-diagram.png \
 	graphics/file-preferences-favorites.png \
 	graphics/uml-shapes.png \
-	graphics/file-preferences-tree.png \
 	graphics/view-menu.png \
 	graphics/file-preferences-ui.png \
 	graphics/view-zoom.png \
diff --git a/doc/en/graphics/diagram-tree.png b/doc/en/graphics/diagram-tree.png
index a17c3ce..147fa9b 100644
Binary files a/doc/en/graphics/diagram-tree.png and b/doc/en/graphics/diagram-tree.png differ
diff --git a/doc/en/usage-customization.xml b/doc/en/usage-customization.xml
index 6209dc6..9b2acd2 100644
--- a/doc/en/usage-customization.xml
+++ b/doc/en/usage-customization.xml
@@ -368,47 +368,5 @@
 
     </sect2>
 
-    <sect2 id="diagram-tree-options">
-      <title>Diagram Tree</title>
-      <figure>
-        <title>Diagram Tree</title>
-        <screenshot>
-          <screeninfo>Diagram Tree</screeninfo>
-          <graphic format="PNG" fileref="graphics/file-preferences-tree" srccredit="Mark Dexter" />
-        </screenshot>
-      </figure>  
-      <para>
-        This tab refers to the Diagram Tree window, which can be opened 
-        from the Toolbox menu bar using the 
-        <menuchoice>
-          <guimenu>
-            File
-          </guimenu>
-          <guimenuitem>
-            Diagram Tree
-          </guimenuitem>
-	</menuchoice> choice or by pressing F8.
-        In the Diagram Tree window, you can right-click on an object and select
-        "Hide this type" from the context menu. This removes objects of this 
-        type from the Diagram Tree window. See <link linkend="diagram-tree">
-        Objects and the Toolbox / Diagram Tree</link> for more information.
-      </para>
-      <para> 
-        The Save Hidden object types box controls whether "Hide this type" is permanent
-        or only for the current <application>Dia</application> session.
-        If the Save hidden object types box is checked, then the program will
-        remember which types you have selected to hide in the Diagram Tree. When 
-        <application>Dia</application> is restarted, these object types will
-        continue to be hidden in this window. If this box is unchecked, any time
-        the program restarts, all objects will again display in the Diagram Tree window.
-      </para>
-      <note>
-        <para>
-          You can restore hidden object types by selecting the type from the list
-          in the "Show object type" option in the context menu of the Diagram Tree
-          window.
-        </para>
-      </note>
-    </sect2>
   </sect1>
 </chapter>
diff --git a/doc/en/usage-objects.xml b/doc/en/usage-objects.xml
index 657a9a6..6eda9bc 100644
--- a/doc/en/usage-objects.xml
+++ b/doc/en/usage-objects.xml
@@ -1017,27 +1017,24 @@
           </guimenuitem>
         </menuchoice> from the Toolbox menu bar or by pressing F8
         when the Toolbox is in focus.
-        When this is toggled on, the Diagram Tree window displays. 
-        The window closes when this is toggled off.
       </para>
 
     </sect2>
     <sect2 id="working-diagram-tree">
       <title>Working With the Diagram Tree</title>
       <para>
-        Actions on the Diagram Tree affect the diagram canvas. If you double-click
-        on a diagram name in the list, that diagram window comes into focus
-        on your desktop. 
-        If you click an object on the list, that object is selected in the
-        diagram on the canvas, just as if you had clicked on it on the canvas.  
-        If you right-click on the Diagram tree list, a context menu
-        displays with six options, as shown in the figure below. 
+        Some actions on the Diagram Tree affect the diagram itself. By selecting
+        objects in the tree, you can modify multiple of them at once.
+        You can sort the objects in the tree by type or name. click on the
+        respective table header.
+        If you right-click on the Diagram Tree list, a context menu
+        displays with three options. 
 
         <figure>
           <title>Diagram Tree</title>
           <screenshot>
             <screeninfo>Diagram Tree</screeninfo>
-            <graphic format="PNG" fileref="graphics/diagram-tree" srccredit="Mark Dexter" />
+            <graphic format="PNG" fileref="graphics/diagram-tree" srccredit="Hans Breuer" />
           </screenshot>
         </figure>  
 
@@ -1046,92 +1043,21 @@
       <itemizedlist>
         <listitem>
           <para>
-            Locate will bring the selected object into view on the canvas.
-            This can be useful if you are trying to find an object in a large 
-            diagram.
-          </para>
-        </listitem> 
-        <listitem>
-          <para>
-            Properties will display the properties dialog for the selected object. 
-            See <link linkend="object-properties">Object Properties</link> for 
-            more information.
-          </para>
-        </listitem> 
-        <listitem>
-          <para>
-            Hide this type will cause all objects of this type to be removed from the
-            list. They are still in the diagram, just not visible in this window.
-          </para>
-        </listitem> 
-        <listitem>
-          <para>
-            Show object type will display a list of any object types you have hidden
-            using Hide this type. You can select a hidden object type to restore it
-            to the list.
+            Select will transfer the current the selection in the tree to the diagram.
           </para>
         </listitem> 
         <listitem>
           <para>
-            Sort objects brings up a sub-menu of sort options as shown in the figure
-            below.
-            <figure>
-              <title>Diagram Tree Sort Options</title>
-              <screenshot>
-                <screeninfo>Diagram Tree Sort Options</screeninfo>
-                <graphic format="PNG" fileref="graphics/diagram-tree-sort" srccredit="Mark Dexter" />
-              </screenshot>
-            </figure>
-          </para>
-          <para>
-            <itemizedlist>
-              <listitem>
-                <simpara>
-                  by name: sorts list by the text entered into the object.
-                </simpara>
-              </listitem>
-              <listitem>
-                <simpara>
-                  by type: sorts list by the object type (Box, Line, etc.).
-                </simpara>
-              </listitem>
-              <listitem>
-                <simpara>
-                  as inserted: sorts list in the order the objects were added to the diagram.
-                </simpara>
-              </listitem>
-              <listitem>
-                <simpara>
-                  All by name: same as by name except that it sorts all open diagrams, not
-                  just the selected one.
-                </simpara>
-              </listitem>
-              <listitem>
-                <simpara>
-                  All by type: same as by type except that it sorts all open diagrams, not
-                  just the selected one.
-                </simpara>
-              </listitem>
-              <listitem>
-                <simpara>
-                  All as inserted: same as as inserted except that it sorts all open diagrams, not
-                  just the selected one.
-                </simpara>
-              </listitem>
-              <listitem>
-                <simpara>
-                  Default: allows you to select which of the three sort types (by name, by type, 
-                  or as inserted) to use by default. Initial default is as inserted.
-                </simpara>
-              </listitem>
-            </itemizedlist>
+            Locate will bring the selected object(s) into view on the canvas.
+            This can be useful if you are trying to find an object in a large 
+            diagram.
           </para>
         </listitem> 
         <listitem>
           <para>
-            Sort diagrams allows you to sort diagrams if you have more than one
-            diagram open during the session. The sort options are by name or as inserted
-            (meaning the order in which the diagrams were opened). 
+            Properties will display the properties dialog for the selected object(s). 
+            See <link linkend="object-properties">Object Properties</link> for 
+            more information.
           </para>
         </listitem> 
       </itemizedlist>