[digikam-doc] digikam: new patch from Wolfgang about to write tags manager and setup color management handbook sections

[Gilles Caulier]

Git commit 17e78e763825ccc0b25236ea96a01733eebc61b8 by Gilles Caulier.
Committed on 23/10/2016 at 16:06.
Pushed by cgilles into branch 'master'.

new patch from Wolfgang about to write tags manager and setup color management handbook sections

M  +1    -1    digikam/using-setup-cm.docbook
M  +51   -2    digikam/using-tagsmngr.docbook

http://commits.kde.org/digikam-doc/17e78e763825ccc0b25236ea96a01733eebc61b8

diff --git a/digikam/using-setup-cm.docbook b/digikam/using-setup-cm.docbook
index 9a2c009..7bf3fa0 100644
--- a/digikam/using-setup-cm.docbook
+++ b/digikam/using-setup-cm.docbook
@@ -6,7 +6,7 @@
     </para>
 
     <para>
-        Basically, a profile "maps" the color information and gives information on how one should render them. It gives also information to LCMS and &digikam; on how to translate the color information from one color space to an other in order to keep the colors as accurate as possible across all rendring media.
+        Basically, a profile "maps" the color information and gives information on how one should render them. It gives also information to LCMS and &digikam; on how to translate the color information from one color space to an other in order to keep the colors as accurate as possible across all rendering media.
     </para>
 
     <para>
diff --git a/digikam/using-tagsmngr.docbook b/digikam/using-tagsmngr.docbook
index d76df04..4f6331a 100644
--- a/digikam/using-tagsmngr.docbook
+++ b/digikam/using-tagsmngr.docbook
@@ -1,12 +1,61 @@
 <sect1 id="using-tagsmngr"> <title>The &digikam; Tags Manager</title>
 <anchor id="tagsmngr.anchor"/>
 
-    <sect2 id="tagsmngr-mainwindow"> <title>The Tags Manager Window</title>
+        <para>
+            There are certain possibilities to manage tags from the context menu on tags in the &digikam; sidebars like <guilabel>New Tag...</guilabel> or <guilabel>Delete Tag</guilabel>. The Tag Manager offers a more comfortable and comprehensive way to organize your tags. For general information about tags, why and how to use them see <link linkend="using-mainwindow-tagsview">Tags View</link> in the Main &digikam; Window chapter.
+        </para>
 
         <para>
-            TODO
+            <mediaobject>
+                <imageobject><imagedata fileref="&path;using-tagsmngr.png" format="PNG" /></imageobject>
+            </mediaobject>
         </para>
+        
+    <sect2 id="tagsmngr-toolbar"> <title>The Tags Manager Toolbar</title>
+        
+        <para>
+            The toolbar at the top offers
+            <itemizedlist>
+                <listitem><para>an adaptive search field to find certain tags in a big tree</para></listitem>
+                <listitem><para>a button to add a tag as a sub-tag to the current (last clicked) tag</para></listitem>
+                <listitem><para>a button to delete a tag or a selection of tags</para></listitem>
+                <listitem><para>the drop down menu <guilabel>Organize</guilabel> which contains
+                    <itemizedlist>
+                        <listitem><para><guilabel>Edit Tag Title</guilabel></para></listitem>
+                        <listitem><para><guilabel>Reset Tag Icon</guilabel> to the standard tag icon</para></listitem>
+                        <listitem><para><guilabel>Create Tag from Address Book</guilabel></para></listitem>
+                        <listitem><para><guilabel>Invert Selection</guilabel>, useful if you want to select most but not all of your tags</para></listitem>
+                        <listitem><para><guilabel>Expand Tag Tree</guilabel> expands all of the nodes of the tag tree</para></listitem>
+                        <listitem><para><guilabel>Expand Selected Nodes</guilabel></para></listitem>
+                        <listitem><para><guilabel>Remove Tag from Images</guilabel> un-assigns selected tag(s) from all images</para></listitem>
+                        <listitem><para><guilabel>Delete Unassigned Tags</guilabel>, useful to clean up your tag tree</para></listitem>
+                    </itemizedlist>
+                </para></listitem>
+                <listitem><para>and the drop down menu <guilabel>Sync Export</guilabel> which contains
+                    <itemizedlist>
+                        <listitem><para><guilabel>Write Tags from Database to Image</guilabel></para></listitem>
+                        <listitem><para><guilabel>Read Tags from Image</guilabel> (and write them to the database)</para></listitem>
+                        <listitem><para><guilabel>Wipe all Tags from Database only</guilabel></para></listitem>
+                    </itemizedlist>
+                </para></listitem>
+            </itemizedlist>
+        </para>
+
+    </sect2>
 
+    <sect2 id="tagsmngr-mainwindow"> <title>The Tags Manager Window</title>
+        <para>
+            The Tags Manager window consists of two parts, the Quick Access List to the left and the Tag Tree (or parts of it) to the right. On the right sidebar you fold out additionally the properties dialog for the selected tag.
+        </para>
+        
+        <para>
+            The Quick Access List allows you to display only a certain node (and it's sub-nodes) in the tag tree window. Select a tag in the tag tree and click <guilabel>Add to List</guilabel>. The tag will appear in the Quick Access List. If you select it there the tag tree will show only that node which you can still expand to see the sub-nodes. Note that the tag tree will also show only a limited number of tags while using the search field. It will show only those tags that contain the string in the search field.
+        </para>
+        
+        <para>
+            The Tag Properties dialog allows you to change the name of the tag, the icon used in the Tags tree and the shortcut.
+        </para>
+        
     </sect2>
 
 </sect1>