Initial revision
[geeqie.git] / README
1 ###################################################################
2 ##                          GQview 0.7.0      (07/03/99)         ##
3 ##      This software is Copyright (C) 1999 by John Ellis.       ##
4 ##  Use this software at your own risk. I am not responsible for ##
5 ##        anything this software may do to your computer.        ##
6 ## This software falls under the GNU Public License. Please read ##
7 ##              the COPYING file for more information            ##
8 ###################################################################
9
10 Author: John Ellis
11 e-mail: gqview@email.com
12 homepage: gqview.netpedia.net
13           www.geocities.com/SiliconValley/Haven/5235/ (mirror always up to date)
14
15 ======== Requirements
16
17   GTK+-1.2.0: ftp://ftp.gtk.org/pub/gtk
18   Imlib 1.9: ftp://ftp.labs.redhat.com/pub/imlib
19
20 ======== Notes and changes for this release
21
22   Changes:
23     > Now use autoconf/make, resulting in a configure script.
24     > Now supports i18n, added translations: de ja pt_BR ru
25     > Remove 'save settings on exit', they are now always saved.
26     > Copy/move dialogs now include drop down history.
27     - Icons now update when size is configured.
28     - When dragging files, and the action was a move, refresh the filelist.
29     * Icons sizes are now properly remembered when the config dialog is opened
30       then closed without re-selecting the size.
31
32   Notes:
33    known bug: When starting up with tools floating, then unfloat the tools and
34               attempt to do drag and drop, BOOM! endless loop of errors on
35               GTK+-1.2.3 (hint: could use a little help figuring this out)
36
37 ======== Installation
38
39   Compilation: ./configure ; make
40   General install: make install
41   GNOME install: make gnome-install is deprecated!, configure finds gnome for
42                  you now. 
43   Removal: make uninstall
44
45 ======== Description / Features
46
47   GQview is a graphics file viewer. Basic features:
48     - Single click image viewing / navigation.
49     - Zoom functions.
50     - Thumbnails, with optional caching and .xvpics support.
51     - Multiple file selection for move, copy, delete, rename, drag and drop.
52     - Drag and drop.
53     - Slideshow.
54     - Full screen.
55     - Ability to open images in external editors (configurable).
56
57 ======== Documentation (brief)
58
59   Keyboard commands:
60     [PageDown]                         next image
61     [PageUp]                           previous image
62     [Home]                             first image in list
63     [End]                              last image in list
64     [Tab]                              tab completion in path entry window
65     [Escape],                          cancel completion in path entry window
66     [Escape]                           stop generating thumbnails
67
68   Keyboard commands valid when image has focus (image has black rectangle)
69     arrow keys                         pan image
70     [Shift] - arrow keys               pan image faster
71     [Space]                            next image
72     [Backspace]                        previous image
73
74   File menu related:
75     [Ctrl] - N                         New directory
76     [Ctrl] - C                         Copy file
77     [Ctrl] - M                         Move file
78     [Ctrl] - R                         Rename file
79     [Ctrl] - D, [Delete]               Delete file
80     [Ctrl] - Q, Q                      Exit
81
82   Edit menu related:
83     [Ctrl] - 1 .. 8                    run external editor
84     [Ctrl] - O                         configure Options
85     [Ctrl] - S                         Save options
86     [Ctrl] - T                         Maintain thumbnails
87
88   View menu related:
89     +, =                               zoom in
90     -                                  zoom out
91     Z                                  zoom to original size
92     X                                  zoom to fit
93     T                                  toggle thumbnail display
94     R                                  refresh list
95     F                                  (Un)float file selection area
96     H                                  (Un)hide file selection area
97     [Ctrl] = F                         Toggle full screen
98     S                                  Toggle slide show
99
100 ======== Thanks go to the following for fixes, additions, and patches:
101
102   Oleg Andrjushenko <oandr@itec.cn.ua>
103       for Russian translation
104
105   Vitor Fernandes <vitor_fernandes@SoftHome.net>
106       for Brazilian Portuguese translation
107
108   Shingo Akagaki <akagaki@ece.numazu-ct.ac.jp>a
109       for Japanese translation
110
111   Matthias Warkus <mawarkus@t-online.de>
112       for German translation.
113
114   Diederen Damien <D.Diederen@student.ulg.ac.be>
115       for .xvpics thumbnail reading support.
116
117 ========
118