[digikam-doc] digikam: add grouping feature description

[Gilles Caulier]

Git commit bcf9a83c05c177b900b9f235fcf7c50aa2144d89 by Gilles Caulier, on behalf of Wolfgang Scheffner.
Committed on 20/01/2017 at 08:07.
Pushed by cgilles into branch 'master'.

add grouping feature description

M  +6    -0    digikam/menu-mainwindow.docbook
A  +-    --    digikam/using-mainwindow-group.png
M  +40   -1    digikam/using-mainwindow-imageview.docbook

https://commits.kde.org/digikam-doc/bcf9a83c05c177b900b9f235fcf7c50aa2144d89

diff --git a/digikam/menu-mainwindow.docbook b/digikam/menu-mainwindow.docbook
index 9f86b35..5c8e8e2 100644
--- a/digikam/menu-mainwindow.docbook
+++ b/digikam/menu-mainwindow.docbook
@@ -386,6 +386,12 @@
 
     </variablelist>
     </para>
+    
+    <note><para>
+        Another very useful function on items is grouping which is at the time of writing only available through the context menu on a selection of items. For details see 
+        <link linkend="using-groupimages">Grouping Photographs</link> 
+        in the chapter about the Main &digikam; Window.
+    </para></note>
 
     </sect2>
 
diff --git a/digikam/using-mainwindow-group.png b/digikam/using-mainwindow-group.png
new file mode 100644
index 0000000..56856ef
Binary files /dev/null and b/digikam/using-mainwindow-group.png differ
diff --git a/digikam/using-mainwindow-imageview.docbook b/digikam/using-mainwindow-imageview.docbook
index 261caa2..4f0ebc5 100644
--- a/digikam/using-mainwindow-imageview.docbook
+++ b/digikam/using-mainwindow-imageview.docbook
@@ -172,13 +172,52 @@
         <para>Deleting works from anywhere in any &digikam; window.</para>
 
     </sect3>
+    
+    <sect3 id="using-groupimages">
+        <title>Grouping Photographs</title>
+        
+        <para>
+            Grouping items is a very useful way to organize Photographs and/or videos that are related to each other and to adjust the way they are displayed in the image area. This function is available through the context menu on a selection of items (more than one item selected).
+        </para>
+
+        <para>
+            <mediaobject>
+                <imageobject><imagedata fileref="&path;using-mainwindow-group.png" format="PNG"/></imageobject>
+            </mediaobject>
+        </para>
+
+        <para>
+            You can put the whole selection into one group using <guilabel>Group Selected Here</guilabel> or you can create more than one group determined by time (seconds will be ignored) or by file type.
+        </para>
+
+        <para>
+            The next group in the menu is to control whether only the reference icon of the group (the first of the group according to the sorting order at the moment of grouping) is displayed or all of them. These two functions can also be accessed by the little grouping indicator (folder symbol) on the reference icon (see upper left icon on the screenshot). While the mouse pointer is hoovering over it there will pop up an information <quote>n grouped items. Group is closed/open.</quote> where n indicates the number of items in the group which are invisible if the group is closed. Clicking on the indicator toggles between open and closed. In the Table mode of the Image Area groups are indicated the way we know from many other lists and tables: with a little triangle in front of the reference item. Clicking on this triangle will fold out/in the grouped items.
+        </para>
+        
+        <para>
+            The last group in the Group context menu allows to remove individual items from the group or to disband the whole group. The content of the menu will change depending on whether you use it on a selection of still ungrouped items, on a group or on single items of a group.
+        </para>
+        
+        <para>
+            What can you do with a group? In terms of functions of &digikam; you can perform a lot of operations like copy, delete, move, rotate on the whole group by selecting only the reference icon provided the group is closed. The same way you can load the whole group into tools like Light Table or the Batch Queue Manager, even into the Image Editor where you can navigate through the group members with the page keys on your keyboard. You can assign tags and labels (see further below in this chapter) and also write descriptions (see   <link linkend="using-sidebar-captions">Captions</link>). Give it a try!
+        </para>
+        
+        <para>
+            In terms of use cases you can for instance group videos together with the .jpg - images related to them which most cameras provide. In the screenshot above exposure bracketed images are being grouped. One could do the same for archiving purposes with images used for a panorama. If you have very specific requirements for documenting of editing steps the <link linkend="using-sidebar-versions">Versions</link> function of &digikam; cannot meet you may find a solution using grouping. I can think of more use cases for grouping but I don't want to overload this section of the handbook here. Maybe a last hint for your own ideas: grouping is not restricted to items out of the same album. The whole group (open or closed) will only be visible in the album of the reference item. The other members of the group will be visible in their own albums only if the group is open. Can be confusing, use with care!
+        </para>
+        
+        <note><para>
+            Everything described in this Grouping section has nothing to do with <guilabel>Group Images</guilabel> in the View menu. That function doesn't form permanent groups of items, it only organizes the way icons are displayed in the Image Area.
+        </para></note>
+
+    </sect3>
 
 </sect2>
 
 <!--
 Local Variables:
 mode: sgml
-sgml-omittag: nil
+sgml-omittag: 
 sgml-shorttag: t
 End:
 -->