Simplify util_clip_region()
[geeqie.git] / doc / docbook / GuideImageManagementDelete.xml
1 <?xml version="1.0" encoding="utf-8"?>\r
2 <section id="GuideImageManagementDelete">\r
3   <title>Delete</title>\r
4   <para>\r
5     To delete a file in Geeqie select\r
6     <menuchoice>\r
7       <shortcut>\r
8         <keycombo>\r
9           <keycap>Ctrl</keycap>\r
10           <keycap>D</keycap>\r
11         </keycombo>\r
12       </shortcut>\r
13       <guimenu>File</guimenu>\r
14       <guimenuitem>Delete</guimenuitem>\r
15     </menuchoice>\r
16     . Delete is also available in the context menu of all images and files. If\r
17     <link linkend="Delete">Enable delete key</link>\r
18     is enabled in Options, pressing the\r
19     <keycap>Delete</keycap>\r
20     key can also be used to delete files.\r
21   </para>\r
22   <para>\r
23     The behavior when starting a delete operation depends on the\r
24     <link linkend="Delete">Confirm file delete</link>\r
25     option in Options. If the option is enabled a dialog will appear to confirm the operation, if it is not enabled the files will be deleted without further interaction. In all cases if the file is unable to be deleted you will be notified by a dialog.\r
26   </para>\r
27   <para />\r
28   <section id="Confirmdeletedialog">\r
29     <title>Confirm delete dialog</title>\r
30     <para>\r
31       The dialog that appears when delete confirmation is enabled will show the file or files to be deleted. To delete the file press\r
32       <keycap>Enter</keycap>\r
33       or activate the Delete button. Pressing\r
34       <keycap>Escape</keycap>\r
35       or activating the Cancel button will close the dialog and abort the operation.\r
36     </para>\r
37     <para>When deleting multiple files, the dialog will include two arrow buttons to step the image preview through the list of files to be deleted. Initially the preview will be blank, activate the right arrow to display the first file.</para>\r
38     <para>\r
39       The dialog will also display the status of the\r
40       <link linkend="Delete">Safe Delete</link>\r
41       feature. Use this to determine if a file to be deleted will be immediately lost, or if the file can possibly be recovered from the Safe Delete folder.\r
42     </para>\r
43     <para>\r
44       If a file is unable to be deleted, a dialog will appear to notify you. If multiple files were selected and any remain, the dialog will include a Continue button, activating this button or pressing Enter will delete the remaining files. Pressing\r
45       <keycap>Escape</keycap>\r
46       or activating the Cancel button will close the dialog and the remaining files will not be deleted.\r
47     </para>\r
48     <para />\r
49   </section>\r
50   <section id="SafeDelete">\r
51     <title>Safe Delete</title>\r
52     <para>\r
53       Geeqie includes a feature to temporarily store deleted files in a selected folder, to use this feature enable\r
54       <link linkend="Delete">Safe Delete</link>\r
55       on the advanced tab of the preferences dialog.\r
56     </para>\r
57   </section>\r
58 </section>\r