###################################################################
##                          GQview 1.1.1     (February 14, 2002) ##
##                                                               ##
##      Copyright (C) 1999, 2000, 2001, 2002 by John Ellis.      ##
##                                                               ##
##                      Use at your own risk!                    ##
##                                                               ##
##  This software released under the GNU General Public License. ##
##       Please read the COPYING file for more information.      ##
###################################################################

Author: John Ellis <johne@bellatlantic.net>
e-mail: gqview@users.sourceforge.net
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            [section:release_notes]

BETA Release!
The 1.1.x series of releases are in active development.
Things may break from version to version.
Want stability? Use a 1.0 version. YOU WERE WARNED!

  Changes:

    + Added optional image icon view to main window.
    + Added optional folder tree view to main window.
    + Files can now be copied or moved by dropping images onto the folder
      list.
    - Folders can now be renamed or created from the folder pop-up menu.
    - The keys 9, 8, and 7 now zoom respectively to -2.0, -3.0, and -4.0.
    - Now displays total bytes in current folder, and of selected images.
    - Re-implemented internal maintenance to update views as files are
      moved, renamed, or deleted.
    - Doubled the bytes read per call when loading an image.
    * The window title is now updated to reflect the current image.

  Notes:

    The tools can not be floated or hidden from view - this will be fixed
    in a future release.

    The TODO file needs a clean up and sort. Yikes!

    Translations (internationalization, as of 1.0.2):
      Completed: cs, de, es, et, fi, fr, it, nl, no, pt_BR, ru, sk, uk,
                 zh_CN.GB2312, zh_TW
      Useable (>90%): hu, pl, sl
      Unknown (<90%): da, ja, tr

    For translation status list, see below.

  Known bugs:

    see the TODO file.

======== 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)                         [section:documentation]

  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)
    9, 8, 7                            zoom to -2, -3, -4, respectively
    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)
    I (*)                              sort collection by name numerically
                                   (file1 file10 file2 -> file1 file2 file10)

    [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] - C                         copy selected files...
    [Ctrl] - M                         move selected files...
    [Ctrl] - R                         rename selected files...
    [Ctrl] - D                         delete selected files

    [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

  (*) This is a compile time option enabled when strverscmp is found.

======== Translation status:
(NOTE: this was as of version 1.0.2, most likely this is out of date)
    Language     Comp (%)  Trans   Fuzzy Untrans  Warn
    --------------------------------------------------
    cs               100     340       0       0
    da                86     294       0      46
    de               100     340       0       0
    es               100     340       0       0
    et               100     340       0       0
    fi               100     340       0       0
    fr               100     340       0       0
    hu                99     337       0       3
    it               100     340       0       0
    ja                84     286      14      40
    nl               100     340       0       0
    no               100     340       0       0
    pl                93     317      17       6
    pt_BR            100     340       0       0
    ru               100     340       0       0
    sk               100     340       0       0
    sl                92     314      19       8
    tr                37     129     101     111
    uk               100     340       0       0
    zh_CN.GB2312     100     340       0       0
    zh_TW            100     340       0       0
    --------------------------------------------------

======== 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> and
     Di Maggio Salvatore <Salvatore.Dimaggio@bologna.marelli.it>
         for Italian translation

     Sandokan <cortex@nextra.sk> and
     Ivan Priesol <priesol@frki.utc.sk>
         for Slovak translation

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

     Eric Lassauge <lassauge@mail.dotcom.fr> and
     Jean-pierre Pedron <jppedron@club-internet.fr>
         for French translation

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

     Kam Tik <kamtik@hongkong.com> and
     Abel Cheung <deaddog@deaddog.ws>
         for Traditional Chinese (Big5) translation

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

     Guilherme M. Schroeder <slump@ieg.com.br> and
     Vitor Fernandes <vitor_fernandes@SoftHome.net>
         for Brazilian Portuguese translation

     Shingo Akagaki <akagaki@ece.numazu-ct.ac.jp> and
     Yuuki Ninomiya <gm@debian.or.jp> and
     Sato Satoru <ss@gnome.gr.jp>
         for Japanese translation

     Matthias Warkus <mawarkus@t-online.de> and
     Thomas Klausner <wiz@danbala.ifoer.tuwien.ac.at>
         for German translation

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

     MĂtyĂs Tibor <templar@tempi.scene.hu> and
     Egmont Koblinger <egmont@suselinux.hu>
         for Hungarian translation

     Wu Yulun <migr@operamail.com> and
     Charles Wang <charlesw1234cn@yahoo.com.cn>
         for simplified Chinese translation

     H.J.Visser <H.J.Visser@harrie.mine.nu> and
     Tino Meinen <a.t.meinen@chello.nl>
         for Dutch translation

     Lauri Nurmi <lanurmi@iki.fi>
         for Finnish translation

     Ilmar Kerm <ikerm@hot.ee>
         for Estonian translation

     Volodymyr M. Lisivka <lvm@mystery.lviv.net>
         for Ukrainian translation

     Birger Langkjer <birger.langkjer@image.dk>
         for Danish translation

     Torgeir Ness Sundli <torgeir@mp3bil.no>
         for Norwegian translation

     Jan Raska <jan_raska@hotmail.com>
         for Czech 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.

     Martin Pool <mbp@samba.org>
         for sort by number, misc. improvements

     All those that I failed to list here.


========


