###################################################################
##                          GQview 1.2.0     (December 12, 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]

  Changes:

    - Updated translations cs, de, fi.
    * Fixed locale path in configure,rpm script.

  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                         Exit

  Edit menu related:
    [Ctrl] - 1 .. 8                    run external editor
    [Ctrl] - A                         select all files
    [Ctrl] - [Shift] - A               unselect all files
    [Ctrl] - P                         display image properties window
    [Ctrl] - O                         configure Options
    [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 thumbnails in list view
    [Ctrl] - L                         display files as list view
    [Ctrl] - I                         display files as icon view
    [Ctrl] - T                         toggle tree view of directories
    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] - P                         display image properties window

    [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] - P                         display image properties window

    [Ctrl] - W                         close window

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

  Mouse image control:

    Button 1                           view next image
    Button 2                           view previous image
    Button 3                           context menu

    Button 1 drag                      scroll/pan image
    Button 2 drag                      drag and drop within gqview,
                                       and to many external applications

    Wheel up/down                      change to previous/next image
    Wheel up/down + [Shift]            scroll image up/down
    Wheel up/down + [Control]          zoom image in/out


======== 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.2.0)
    Language     Comp (%)  Trans   Fuzzy Untrans
    --------------------------------------------
    cs               100     393       0       0
    da                72     286      33      74
    de               100     393       0       0
    es                84     332      34      27
    et                97     384       3       6
    fi               100     393       0       0
    fr                97     385       3       5
    hu                83     329      33      31
    it                84     332      34      27
    ja                70     278      46      69
    nl                84     332      34      27
    no                84     332      34      27
    pl                78     309      51      33
    pt_BR             84     332      34      27
    ro                97     385       3       5
    ru                84     332      34      27
    sk                84     332      34      27
    sl                77     306      52      35
    th                82     323      35      35
    tr                31     124     126     143
    uk                88     347      26      20
    zh_CN.GB2312      84     332      34      27
    zh_TW             84     332      34      27
    --------------------------------------------


======== 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> and
     Michal Bukovjan <bukm@centrum.cz>
         for Czech translation

     Phanumas Thanyaboon <maskung@hotmail.com>
         for Thai translation

     Harald Ersch <hersch@romatsa.ro>
         for Romanian 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.


========


