annotate doc/docbook/GuideImageManagementCopyMove.xml @ 1773:2ae81598b254

scripts for converting wiki documentation to docbook

<?xml version="1.0" encoding="utf-8"?>
<section id="GuideImageManagementCopyMove">
    <title>
      Copy and Move
    </title>
    <para>
      To copy an file in Geeqie press Ctrl + C, to move an file press Ctrl + M. These operations also appear under File in the main menu, and in the context menu of all images and files.
    </para>
    <para>
      The Copy and Move operations and dialogs behave the same in Geeqie, with the only difference being the final result. The remaining text of this page applies equally to the Copy and Move operations, for the remainder of this page these will be referred to as a Copy/Move operation.
    </para>
    <para>
      Initiating a Copy/Move operation will display a dialog to select the destination folder to Copy/Move the selected file, after the destination folder is selected Geeqie will proceed to Copy/Move the images to the destination. If an error occurs or a file exists with the same name as one of the files being Copy/Moved, a dialog will appear prompting how to handle the situation.
    </para>
    <para/><section id="TheCopyMovedialog"><title>
      The Copy/Move dialog
    </title>
    <para>
      This is the dialog that is displayed when initiating a Copy/Move operation. The dialog contains a row of buttons near the top, vertical list of bookmarks along the left side, a vertical list of folders in the current path, a text entry field, and a row of buttons along the bottom.
    </para>
    <variablelist><varlistentry><term>
        Home button
      </term><listitem><para>
        Activate this button to change the active path to your home folder.
      </para></listitem></varlistentry><varlistentry><term>
        New Folder button
      </term><listitem><para>
        Activate this to create a new empty folder as a sub folder of the active path. The new folder will appear in the folder list ready for you to type in the desired name.
      </para></listitem></varlistentry><varlistentry><term>
        Show Hidden check box
      </term><listitem><para>
        Enabling this check box will cause hidden folders to appear in the folder list.
      </para></listitem></varlistentry><varlistentry><term>
        Bookmark list
      </term><listitem><para>
        This list on the left side of the window allows you to save links to folders that are frequently used. Activating a bookmark will change the active path to that pointed to by the link. To add items to the bookmark list highlight a folder and press Ctrl + B, select “Add bookmark” from the folder's context menu, or drag a folder onto the bookmark list.<?db2html element="br"?>
        The bookmark has a context menu that can be displayed by clicking the right mouse button, or pressing the Menu key when a bookmark has the focus. From the context menu you can edit a bookmark, move it up or down in the list, or remove the bookmark from the list. A bookmark can also be moved by pressing Shift + Up or Shift + Down while it has the focus.
      </para></listitem></varlistentry><varlistentry><term>
        Folder list
      </term><listitem><para>
        This is the list that displays the folders contained in the active path. To change the active path to a folder displayed in this list double click the primary mouse button or highlight the folder with the keyboard and press Enter or Spacebar. This list has a context menu that allows renaming or bookmarking the selected folder. A folder can also be dragged onto the bookmark list to add a bookmark.
      </para></listitem></varlistentry><varlistentry><term>
        Path entry
      </term><listitem><para>
        This text entry displays the active path of the dialog. The path can be directly edited using this entry. Tab completion is supported, and the drop down arrow will display a list of recently selected folders.
      </para></listitem></varlistentry><varlistentry><term>
        Copy/Move button
      </term><listitem><para>
        The name of this button will differ depending on the selected operation, activating it will start the operation with the folder displayed in the path entry as the destination.
      </para></listitem></varlistentry><varlistentry><term>
        Cancel button
      </term><listitem><para>
        Activate this button to close the dialog, the operation will be aborted.
      </para></listitem></varlistentry></variablelist>
    <para/></section><section id="Theerrordialog"><title>
      The error dialog
    </title>
    <para>
      If a problem occurs because Geeqie is unable to Copy or Move a selected file a dialog will appear to notify the user. The dialog will also ask if the operation should continue if one or more files remain to be Copied or Moved.
    </para>
    <para/></section><section id="Theoverwritedialog"><title>
      The overwrite dialog
    </title>
    <para>
      If a file with the same name exists in the selected destination a dialog will appear to notify the user and ask how to resolve the conflict. The dialog will also display the source and destination images. The following possible solutions will be offered:
    </para>
    <variablelist><varlistentry><term>
        Auto rename
      </term><listitem><para>
        Enabling this check box to have Geeqie select a unique name for the destination file, the proposed new name will appear in the rename entry field.
      </para></listitem></varlistentry><varlistentry><term>
        Rename
      </term><listitem><para>
        Enable this check box to manually enter a new name for the file.
      </para></listitem></varlistentry><varlistentry><term>
        Overwrite
      </term><listitem><para>
        Activate this will overwrite the existing file, or rename it if one of the rename check boxes are enabled.
      </para></listitem></varlistentry><varlistentry><term>
        Overwrite all
      </term><listitem><para>
        Activating this will perform the same operation as the Yes button, however any further file name conflicts will be handled quietly in the same method as is selected for the current file.
      </para></listitem></varlistentry><varlistentry><term>
        Skip
      </term><listitem><para>
        This button will skip doing anything to the file in question, and resume the operation with the next file. The source file will remain untouched.
      </para></listitem></varlistentry><varlistentry><term>
        Skip All
      </term><listitem><para>
        This will perform the same as the Skip button, however any further file name conflicts will be quietly ignored for all remaining files.
      </para></listitem></varlistentry><varlistentry><term>
        Cancel
      </term><listitem><para>
        This will close the dialog and stop the operation, all remaining files will be ignored.
      </para></listitem></varlistentry></variablelist>
  <para/></section></section>