###################################################################
##                          GQview 1.1.5          (July 2, 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 (untested) Xinerama support.
    - When a new directory is selected, the first image in that directory is
      now viewed (for old behavior see README notes, below).
    - Tree view now auto expands to display subdirectories of the active path.
    - Translation updates for et and uk.
    - Added skip all button to the overwrite files dialog.
    * Fixed 'fit window to image when tools float' option.
    * Fixed the cause of panes resizing to top left when toggling tools.
    * Fixed several bugs that cause a crash when refreshing the file listing.
    * Fixed scrolling bugs in file view.
    * Fixed miscellaneous smaller bugs.

  Notes:

    From version 1.1.5 onward, changing the active directory path will change
    the viewed image to the first in that path. For older behavior (image only
    changes from user command) set lazy_image_sync: true in the gqviewrc file.

    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
    [Ctrl] - T                         Toggle tree view of directories.
    [Ctrl] - I                         Toggle icon view of files.
    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.

======== Additional comments:

  To enable the old behavior of lazy image update when changing directories,
  edit ~/.gqview/gqviewrc and set lazy_image_sync to true.

======== Translation status:

    (as of 1.1.5)
    Language     Comp (%)  Trans   Fuzzy Untrans  Warn
    --------------------------------------------------
    cs                91     355      18      14
    da                74     288      30      69
    de                86     334      31      22
    es                86     334      31      22
    et                98     382       1       4
    fi                86     334      31      22
    fr                88     344      23      20
    hu                85     331      30      26
    it                86     334      31      22
    ja                72     280      43      64
    nl                86     334      31      22
    no                86     334      31      22
    pl                80     311      48      28
    pt_BR             86     334      31      22
    ru                86     334      31      22
    sk                86     334      31      22
    sl                79     308      50      30
    th                83     324      32      31
    tr                32     126     124     138
    uk                90     349      23      15
    zh_CN.GB2312      86     334      31      22
    zh_TW             86     334      31      22
    --------------------------------------------------

======== 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

     Ftih 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

     Mtys 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

     Phanumas Thanyaboon <maskung@hotmail.com>
         for Thai 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.

     Jrg Mensmann <joerg.mensmann@gmx.de>
         for Xinerama support patch.

     All those that not listed here.


========


