###################################################################
##                          GQview 0.5.0      (11/11/98)         ##
##      This software is Copyright (C) 1998 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            ##
###################################################################

  code written by: John Ellis
  e-mail: gqview@geocities.com
  homepage: www.geocities.com/SiliconValley/Haven/5235/

  GQview is a graphics file viewer.  It requires gtk 1.0.5 and
  gdk_imlib (Imlib 1.6) to compile.

  === library locations ===
  GTK+-1.0.6: ftp://ftp.gtk.org/pub/gtk
  Imlib 1.8: ftp://ftp.labs.redhat.com/pub/imlib
  ==========================

======== Installation / Compiling

  To compile run make
    (the Makefile may have to be edited)

  To compile with GTK 1.1.x:
       uncomment the     DEFS = -DHAVE_GTK_1_1=1     line in the Makefile.
   and if using a a gtk -->>  newer than the 1.1.3 _release_ <<-- :
       uncomment the     DEFS = -DHAVE_GTK_1_1_4=1   line in the Makefile.

  Make options:
     make install         compile and install binary
     make gnome-install   compile, install binary, and install gnome link/icon
     make uninstall       remove binary
     make gnome-uninstall remove binary and gnome link/icon
     make clean           remove object *.o and binaries from source dir

  to use GTK themes:
    the theme file should be $HOME/gtkrc
    Note: themes not tested lately, have had reports of problems.

  Gnome users:
   A pixmap and desktop file have been provided to install this program in
   gnome. Assuming gnome is installed in /usr, copy gqview.png into
   /usr/share/pixmaps and gqview.desktop into /usr/share/apps/Graphics Or, if
   compiling from source, use 'make gnome-install'.

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

  When using the program, everything is done with a single click. When
  'zoom fit' is selected a '~' will appear in the zoom box in the lower right
  corner. Zoom fit does not enlarge an image, if an image is smaller than the
  window, it is displayed at original size.

  Thumbnails are can be cached to disk to speed loading on future thumbnail
  views. By default thumbnail caching is disabled, to enable it check the box
  on the General tab in the options dialog.

  Keyboard commands:
    ], [Space],     [PageDown]         next image
    [, [Backspace], [PageUp]           previous image
    [Home]                             first image in list
    [End]                              last image in list
    arrow keys                         pan image
    [Ctrl] - arrow keys                pan image faster
    [Tab]                              change focus to path entry window, and
                                       do tab completion in that window
    [Escape],   [Ctrl] - P             remove focus from path entry window
    [Escape]                           stop generating thumbnails

   File menu related:
    [Ctrl] - N                         New directory
    [Ctrl] - C                         Copy file
    [Ctrl] - M                         Move file
    [Ctrl] - R                         Rename file
    [Ctrl] - D, [Delete]               Delete file
    [Ctrl] - Q                         Quit
   Edit menu related:
    [Ctrl] - 1 .. 8                    run external editor
    [Ctrl] - O                         configure Options
    [Ctrl] - S                         Save options
    [Ctrl] - T                         Maintain thumbnails
   View menu related:
    =                                  zoom in
    -                                  zoom out
    Z                                  zoom to original size
    X                                  zoom to fit
    T                                  toggle thumbnail display
    R                                  refresh list
    F                                  (Un)float file selection area
    H                                  (Un)hide file selection area

  Known issues:
  - When starting GQview and tools are restored floating, file count label is
    initially garbled.

======== Version history:

0.5.0  (11-11-98)
  > Add path entry window with tab completion.
  > Add tab completion to all areas where a path can be typed.
  > Add option to save window positions.
  - Pressing '+' zooms image. Previously only '=' was bound, causing problems
    for some keyboard layouts.
  - Add border to floating tools window for better appearance on some WM's.

0.4.3  (10-09-98)
  * Fix bug when 'fit window to image' is on, tools float/hide, and the next
    image selected has the same dimensions, it would not display.
  * More fixes dealing with 'fit window to image'

0.4.2  (10-07-98)
  > Add 'fit window to image' option when tools float or hide.
  > Add copy and move dialogs.
  > Add option to hide the tools completely.
  > Save settings on exit option added, and option to restore tool state.
  - Pressing the [ESC] key will now stop loading of thumbnails.
  - [CTRL] - M is now moves files, purging old thumbnails is now [CTRL] - T.
  - Add save button to config dialog.
  - New configuration tab: image, moved relevent options there.

0.4.1  (9-11-98)
  > Scrollbars removed, now you can pan the image by pressing and dragging the
    mouse on the image. The arrow keys will pan too (use [Ctrl] to pan faster)
  > The file selection area and status line can be 'floated' into a separate
    window, this allows the image window to display more of the image.
  > The file delete confirmation dialog can now be disabled in the options
    window.
  > The beginnings of keyboard support ( see the keyboard chart, above )
  - Now if a thumbnail is older than it's parent image, the thumbnail is
    recreated, so that changed images have their thumbnail properly updated.
  - While loading thumbnails GQview is now responsive to commands, slowly, but
    it works. You can now load images, delete files, etc. while the thumbnails
    are being generated. The thumbnail generation can be interrupted too by
    simply turning them off.
  * The code that determines the user's HOME directory has been rewritten, now
    hopefully users of nis will be happy. If the directory is not found or
    cannot be determined, GQview exits semi-gracefully.
  * Fixed some bugs here and there.

0.4.0  (8-15-98)
  > Thumbnail caching added ($HOME/.gqview_thmb).
  - patch from Joshua Thomas Green applied for those that want to compile
    with GTK 1.1.x (the development version), just uncomment one line in the
    Makefile.
  - patch from Joel Young applied to the .spec file of the RPM version.

0.3.4  (7-30-98)
  * Fixed problem loading files into external editors when a space was in the
    pathname.

0.3.3  (5-15-98)
  - Changes to file listing code for speed improvement in large directories.
  * Fixed a bug that would cause a thumbnail's height or width to be zero when
    an image has a large aspect ratio.
  * Fixed some memory leaks in the file listing code.
  - Other small changes including source re-organization.
  - Added a pixmap file to use as an icon (gqview.xpm).

0.3.2  (5-7-98)
  * Fixed a bug which made the first editor slot useless from config dialog.

0.3.1  (5-4-98)
  - Changed filelist code to properly implement Glist.
  - Moved definitions of variables and #includes to better places.

0.3.0  (4-24-98)
  > New feature! Thumbnails displayed in the file list(us 't' to toggle).
  > Thumbnails size can be selected (General Options).
  > Rewrite (again) of the file list (to support adding/removing entries
    without re-reading the entire directory listing, [still need to convert
    the directory list, however]).
  - minor display layout changes (to accomodate the progress bar).
  - if a file format cannot be determined, a generic 'unknown image' picture
    is displayed.
  - added display for the number of files listed.
  - added '-debug' command line option for debug output (preliminary)

0.2.1  (4-8-98)
  > Added a handle, now the file lists are sizeable.
  - renamed menu item Exit to Quit.
  - Added missing file includes that were exposed with GTK+ 0.99.10 release.

0.2.0  (3-19-98)
  > External editors can be specified in the configuration window (max 8).
      Under the "external editors" tab.
  - Popup menu for filelist (delete, rename, and edit).
  - Filelist highlight now follows currently viewed image.
  - A few minor fixes.

0.1.1  (3-3-98)
  > Updated code to compile with GTK+-0.99.4
     (will not work with previous versions of GTK)
  - Command line no longer requires a complete path to a file if it is in
    the current working directory. (or must be relative to it)
  - When moving to the next (or previous) image, the file list
    scrolls to include the current image's name.

0.1.0  (2-28-98)
  > Added menu bar.
  > Added keyboard shorcuts.
  > Configuration can be saved (to .gqviewrc in user's home dir)
  > Command line support. (specify startup directory or file to view)
  > Can set startup directory in options window (can be disabled)
  > Added custom filtering options to support more formats
     (Imlib supports almost anything your system can read using
      ImageMagick or Netpbm, if available).
  > File operations: create directory, rename file, delete file.
  > clicking mouse on image:
      button one: next image
      button two: previous image
      button three: popup menu (zoom, file operations, edit image)
  > Added option to load image into The Gimp.
  - Fixed a bug in the history list truncating routine. (GQview would crash)
  - Other minor improvements and fixes.

0.0.3  (2-18-98)
  > Source code clean up! The source code has been organized
    and is now readable (some code still needs organizing, but
    at least now the code can be followed).
  > Makefile rewritten, it may still need editing for some systems.
    The '-g' gcc option was removed for the released code, this makes
    the binary about 1/3 smaller (it removes some debugging facilities)
  - Fixed the transparency problem. This removes the garbage displayed
    where an image is transparent, unfortunately for now it is set to purple.

0.0.2  (2-14-98)
  > Rewrote directory and file list handling, the lists
    can now be of any length.
  > Lists are now sorted.
  > History list no longer expands out of control as the
    directory path gets longer, entries are truncated at
    32 characters and '/...' is prepended.
  > Added configuration window, including:
    - show or hide dot files
    - select default zoom mode for new image
    - disable file filtering
    - choose file types to filter
    - about tab for version and contact info

0.0.1  (2-10-98)
  > No history, first release!

=== enjoy! ===
