Standardize on Unix LF line terminators
[geeqie.git] / doc / docbook / GuideImageMarks.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <section id="GuideImageMarks">
3   <title id="titleGuideImageMarks">Marking Images</title>
4   <para>Marks are intended as a temporary method of grouping and filtering sets of images.</para>
5   <para>
6     <link linkend="Keywords" endterm="titleKeywords" />
7     are intended as a permanent method of identifying sets of images, and to this end it is possible to link any mark with any keyword.
8   </para>
9   <para>
10     The
11     <guimenu>Select</guimenu>
12     menu gives access to the marks operations of setting, filtering and intersection.
13   </para>
14   <para>There are 10 individual marks, any of which can be associated with an image simply by pressing the 0 to 9 keys on the keyboard, where key 0 represents mark 10.</para>
15   <para>
16     If the
17     <guimenu>Show Marks</guimenu>
18     menu has been selected, each image will have a set of 10 check-boxes displayed adjacent to it in the file pane in both icon and list mode. In addition a set of 10 check-boxes will be shown at the top of the files pane. Clicking any of these will filter the displayed list.
19   </para>
20   <para>Moving the mouse over any of the check-boxes at the top of the files pane will show mnemonic text for that mark. The text can be modified by right-clicking on the check box.</para>
21   <para>
22     If the
23     <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />
24     is being displayed, the currently set marks for the image are shown. It is not necessary to include an entry into the overlay template for this to happen.
25   </para>
26   <para>
27     A keyword can be associated with a single mark by right-clicking on the keyword in the sidebar panel. When a meta-data write operation for a file is triggered either
28     <link linkend="Buttons">manually</link>
29     or as defined in
30     <link linkend="GuideOptionsMetadata" endterm="titleGuideOptionsMetadata" />
31     , the keyword data indicated by the current set of mark-to-keyword links will be written.
32   </para>
33   <para>
34     The associations between keywords and marks is preserved when Geeqie is shut down. The current setting of marks can also be optionally saved - the setting is in the
35     <link linkend="Behaviour">Behavior tab of Preferences</link>
36     .
37   </para>
38   <para />
39   <para />
40 </section>