###################################################################
##                          GQview 0.10.1    (February 26, 2001) ##
##      This software is Copyright (C) 2001 by John Ellis.       ##
##  Use this software at your own risk. I am not responsible for ##
##        anything this software may do to your computer.        ##
## This software falls under the GNU Public License. Please read ##
##              the COPYING file for more information            ##
###################################################################

Author: John Ellis
e-mail: gqview@email.com
homepage: http://gqview.sourceforge.net

======== Requirements

  GTK+ 1.2.x: ftp://ftp.gtk.org/pub/gtk
  gdk-pixbuf >= 0.9.0: ftp://ftp.gnome.org
  libpng: (by now most systems have this by default)

======== Notes and changes for this release

  Known BUGS:
    - The TILES zoom scaling method has bugs and can cause app crashes.
      TILES is safe to select for thumbnails, but is not recommended for
      the image scaling mode.
      (gdk-pixbuf has bugs in some of it's scaling functions under some
      conditions, see rants in ChangeLog and image.c for details)

  Changes:
    > Thumbnails can now be optionally stored in a .thumbnails
      subdirectory (off by default).
    > The find duplicates window now caches image information with the
      thumbnails.
    - Thumbnails and cached data are now moved when their parent is moved.
    - The find duplicates window now gives a (very) rough estimate of time
      remaining for the current operation.
    * Fixed image loader bug that was causing thumbnails to fail for some
      file types, noteably xpm and tiff.
    * Similarity comparison now works for images with dimensions less
      than 32 by 32.
    * Fixed cause of recursive slideshow failing to work when the main
      filelist was empty but still contained directories.
    * Fixed compile problems for some systems (hopefully).
    * Fixed occasional gtk-warnings in find duplicates window.

======== Installation

  Compilation: ./configure ; make
  General install: make install
  Removal: make uninstall

    - To build an RPM binary use 'rpm -tb gqview-x.x.x.tar.gz'.

======== Description / Features

  GQview is a graphics file viewer. Basic features:
    - Single click image viewing / navigation.
    - Zoom functions.
    - Thumbnails, with optional caching and .xvpics support.
    - Multiple file selection for move, copy, delete, rename, drag and drop.
    - Drag and drop.
    - Slideshow.
    - Full screen.
    - Ability to open images in external editors (configurable).
    - Collections.
    - Comparison of images to find duplicates by name, size, date,
      dimensions, or image content similarity.

======== Documentation (brief)

  Keyboard commands:
    [PageDown], [Keypad PageDown]      next image
    [PageUp], [Keypad PageUp]          previous image
    [Home], [Keypad Home]              first image in list
    [End], [Keypad End]                last image in list
    [Tab]                              tab completion in path entry window
    [Escape],                          cancel completion in path entry window
    [Escape]                           stop generating thumbnails

  Keyboard commands valid when image has focus (image has black rectangle)
    arrow keys, [Keypad arrows]        pan image
    [Shift] - arrow keys               pan image faster
    [Space]                            next image
    [Backspace] , B                    previous image

  File menu related:
    C                                  New Empty collection
    O                                  Open collection
    D                                  open a Find Duplicates window
    [Ctrl] - N                         New directory
    [Ctrl] - C                         Copy file
    [Ctrl] - M                         Move file
    [Ctrl] - R                         Rename file
    [Ctrl] - D, [Delete]               Delete file
    [Ctrl] - Q, Q                      Exit

  Edit menu related:
    [Ctrl] - 1 .. 8                    run external editor
    [Ctrl] - A                         select all files
    [Ctrl] - [Shift] - A               unselect all files  
    [Ctrl] - O                         configure Options
    [Ctrl] - T                         Maintain thumbnails
    [Ctrl] - W                         Set current image as wallpaper
    ]                                  rotate image clockwise
    [                                  rotate image counterclockwise
    [Shift] - R                        rotate image 180 degrees
    [Shift] - M                        mirror image (horizontal)
    [Shift] - F                        flip image (verticle)

  View menu related:
    +, =, [Keypad +]                   zoom in
    -, [Keypad -]                      zoom out
    Z, [Keypad /]                      zoom to original size
    X, [Keypad *]                      zoom to fit
    1, 2, 3, 4                         zoom to Nx (3 = 3x)
    T                                  toggle thumbnail display
    R                                  refresh list
    F                                  (Un)float file selection area
    H                                  (Un)hide file selection area
    V                                  Toggle full screen
    S                                  Toggle slide show
    P                      	       (Un)pause slideshow

  Collection windows:

    arrows, [Keypad arrows]            move selection
    [Shift] + arrows                   select multiple images
    [Ctrl] + arrows                    move without changing selection
    [Space]                            select only image with focus
    [Ctrl] + [Space]                   toggle selection of image with focus
    [Home], [Keypad Home]              move focus to top of images
    [End], [Keypad End]                move focus to end of images
      (shift and ctrl work with Home, End, PageUp/Down as with arrows)
    [Ctrl] - A                         select all images
    [Ctrl] - [Shift] - A               unselect all images

    [Delete], [Keypad Delete}          remove selected images from collection
                                       (does not delete file)
    [Ctrl] - L                         add images from main window file list

    N                                  sort collection by name
    D                                  sort collection by date
    B                                  sort collection by size (bytes)
    P                                  sort collection by location (path)

    [Enter], [Keypad Enter]            view image with focus in main window
    V                                  view image with focus in new window
    [Ctrl] - 1 .. 8                    open selected image(s) in editor

    S                                  save collection
    [Ctrl] - S                         save collection as...
    A                                  append to collection...

    [Ctrl] - W                         close window

  Find Duplicates window:

    [Ctrl] - A                         select all images
    [Ctrl] - [Shift] - A               unselect all images

    [Ctrl] - L                         add images from main window file list
    C                                  add selected images to new collection

    [Delete], [Keypad Delete}          remove selected images from list
    [Ctrl] - [Delete]                  clear window

    [Enter], [Keypad Enter]            view image with focus in main window
    V                                  view image with focus in new window
    [Ctrl] - 1 .. 8                    open selected image(s) in editor

    [Ctrl] - C                         copy selected files...
    [Ctrl] - M                         move selected files...
    [Ctrl] - R                         rename selected files...
    [Ctrl] - D                         delete selected files

    [Ctrl] - W                         close window

======== Thanks go to the following:

  Translations:

     Grzegorz Kowal <g_kowal@poczta.onet.pl> and
     Zbigniew Chyla <cyba@gnome.pl>
         for Polish translation

     Christopher R. Gabriel <cgabriel@pluto.linux.it>
         for Italian translation

    "Sandokan" <cortex@nextra.sk>
         for Slovak translation

     Rodrigo Sancho Senosiain <ruy_ikari@bigfoot.com>
         for Spanish translation

     Jean-pierre PEDRON <jppedron@club-internet.fr>
         for French translation

     Fâtih Demir <kabalak@gmx.net>
         for Turkish translation

     Kam Tik <kamtik@hongkong.com>
         for Triditional Chinese (Big5) translation

     Oleg Andrjushenko <oandr@itec.cn.ua> and
     Michael Bravo <mbravo@tag-ltd.spb.ru>
         for Russian translation

     Vitor Fernandes <vitor_fernandes@SoftHome.net>
         for Brazilian Portuguese translation

     Shingo Akagaki <akagaki@ece.numazu-ct.ac.jp>a
         for Japanese translation

     Matthias Warkus <mawarkus@t-online.de>
         for German translation.

     Matej Erman <matej.erman@guest.arnes.si>
         for Slovene translation.

     MĂtyĂs Tibor <templar@tempi.scene.hu>
         for Hungarian translation.

     Wu Yulun <migr@operamail.com>
         for simplified Chinese translation.

 Fixes, additions, and patches:

     Diederen Damien <D.Diederen@student.ulg.ac.be>
         for .xvpics thumbnail reading support.

     Nick Rusnov <nick@grawk.net>
     Ryan Murray <rmurray@debian.org>
         for man page.

     All those that I failed to list here.


========

