###################################################################
##                          GQview 1.2.2         (March 4, 2003) ##
##                                                               ##
##            Copyright (C) 1999 - 2003 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.10: ftp://ftp.gtk.org/pub/gtk
  gdk-pixbuf >= 0.16.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 French and Spanish translations.
    - Added Vietnamese translation.
    - Tweaked behavior of 'view in new window' to honor multiple selections.
    * Fixed copy and move overwrite dialog logic.

  Notes:

    For GQview 1.2.2, the requirements are now more realistic, a minimum
    of GTK+ 1.2.10 and gdk-pixbuf 0.16.0 are now required to build. This is to
    avoid bugs caused by earlier versions of the underlying libraries.

    For translation status list, see below.

    Starting with 1.2.1, the 'place mouse under dialogs' option is no longer
    available from within the application's preferences. To enable this option
    edit the ~/.gqview/gqviewrc file while GQview is not running, and set
    the display_dialogs_under_mouse: line to true.

  Known bugs:

    see the TODO file.

======== Installation

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

    - To build an RPM binary:

         on RedHat 6.x, 7.x use 'rpm -tb gqview-x.x.x.tar.gz'.
         on RedHat 8.x use 'rpmbuild -tb gqview-x.x.x.tar.gz'.
         on other rpm distros, it depends on which version of rpm is used, if
         the option fails with the rpm command, try rpmbuild.

      Where the resulting package is placed is distribution specific, for
      example in RedHat it is placed in /usr/src/redhat/RPMS/{architecture}/

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

  Advanced options:
    These options are not adjustable in the preferences window, to change
    them edit $(HOME)/.gqview/gqviewrc while GQview is not running. An option
    becomes 'advanced' when it is removed from the user's visibility, and
    only remains so that those few users that really want it will not complain
    about it's removal :)

  lazy_image_sync: false
    Set true to enable the old behavior of lazy image updates when changing
    directories. (viewed image will remain until a new file is selected)

  display_dialogs_under_mouse: false
    Set true to force dialogs to display under the current mouse position,
    note that this goes against the preference set for the window manager.

======== Translation status:

    (as of 1.2.2)
    Language     Comp (%)  Trans   Fuzzy Untrans  Warn
    --------------------------------------------------
    cs               100     393       0       0
    da                72     286      33      74
    de               100     393       0       0
    es               100     393       0       0
    et                97     384       3       6
    fi               100     393       0       0
    fr               100     393       0       0
    hu                83     329      33      31
    it                84     332      34      27
    ja               100     393       0       0
    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                98     388       0       5
    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
    vi               100     393       0       0
    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> and
     Ariel Fermani <the_end@bbs.frc.utn.edu.ar>
         for Spanish translation

     Eric Lassauge <lassauge@mail.dotcom.fr> and
     Jean-Pierre Pedron <jppedron@club-internet.fr> and
     Pascal Bleser <pascal.bleser@atosorigin.com>
         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

     Junichi Uekawa <dancer@debian.org> and
     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

     pclouds <pclouds@gmx.net>
         for Vietnamese 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.


========


