annotate doc/docbook/GuideImageManagementDelete.xml @ 1811:f405ec9b696b default tip

Some small logic mistakes Use boolean operators for booleans and bitwise otherwise only.

<?xml version="1.0" encoding="utf-8"?>
<section id="GuideImageManagementDelete">
    <title>
      Delete
    </title>
    <para>
      To delete a file in Geeqie press Ctrl + D, or select Delete from the file menu. Delete is also available in the context menu of all images and files. If <link linkend="GuideOptionsAdvanced">Enable delete key?</link> is enabled in Options, pressing the Delete key can also be used to delete files.
    </para>
    <para>
      The behavior when starting a delete operation depends on the <link linkend="GuideOptionsAdvanced">Confirm file delete?</link> 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.
    </para>
    <para/><section id="Confirmdeletedialog"><title>
      Confirm delete dialog
    </title>
    <para>
      The dialog that appears when delete confirmation is enabled will show the file or files to be deleted. To delete the file press Enter or activate the Delete button. Pressing Escape or activating the Cancel button will close the dialog and abort the operation.
    </para>
    <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>
    <para>
      The dialog will also display the status of the <link linkend="GuideOptionsAdvanced">Safe Delete?</link> 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.
    </para>
    <para>
      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 Escape or activating the Cancel button will close the dialog and the remaining files will not be deleted.
    </para>
    <para/></section><section id="SafeDelete"><title>
      Safe Delete
    </title>
    <para>
      Geeqie includes a feature to temporarily store deleted files in a selected folder, to use this feature enable <link linkend="GuideOptionsAdvanced">Safe Delete?</link> on the advanced tab of the preferences dialog.
    </para>
    <para>
      Safe Delete includes these options:
    </para>
    <variablelist><varlistentry><term>
        Folder
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      The folder to use for temporarily retaining deleted files.
    </para>
    <variablelist><varlistentry><term>
        Maximum size
      </term><listitem><para/></listitem></varlistentry></variablelist>
    <para>
      The maximum amount of disk space to use when storing deleted files, in megabytes.
    </para>
    <para>
      When the total size of the deleted files stored in the Safe Delete folder exceeds the Maximum size, the oldest files are removed from the folder to make space for the new deleted files.
    </para>
    <para>
      Files moved to the Safe Delete folder are prefixed with a six digit number in the format: <literal>nnnnnn_FILENAME</literal>
    </para>
    <para>
      This is used to distinguish which files to remove first when clearing space for new files. The digit counter increments with each deleted file.
    </para>
    <para>
      To clear the contents of the Safe Delete folder, activate the Clear button provided for this purpose on the <link linkend="GuideOptionsAdvanced">Advanced tab?</link> in Options.
    </para>
  <para/></section></section>