Remove useless variable and code.
[geeqie.git] / README
diff --git a/README b/README
index 6b4401a..9e12393 100644 (file)
--- a/README
+++ b/README
@@ -1,7 +1,7 @@
 ###################################################################
 ###################################################################
-##                          Geeqie 1.0alpha1                    ##
+##                            Geeqie 1.1                         ##
 ##                                                               ##
 ##                                                               ##
-##              Copyright (C) 2008 The Geeqie Team               ##
+##              Copyright (C) 2008 - 2012 The Geeqie Team        ##
 ##              Copyright (C) 1999 - 2006 John Ellis.            ##
 ##                                                               ##
 ##                      Use at your own risk!                    ##
 ##              Copyright (C) 1999 - 2006 John Ellis.            ##
 ##                                                               ##
 ##                      Use at your own risk!                    ##
@@ -17,9 +17,9 @@ possible to contact gqview author and the only maintainer.
 Geeqie projects goal is to move the development forward and 
 also integrate the existing patches.
 
 Geeqie projects goal is to move the development forward and 
 also integrate the existing patches.
 
-Geeqie is currently in alpha state. Everybody is encouraged 
-to try the new features, however for stable software look at 
-the original project.
+Geeqie is currently considered stable. 
+Please report any crash or odd behavior to the bugtracker:
+https://sourceforge.net/tracker/?group_id=222125&atid=1054680
 
 For more info see:
 http://geeqie.sourceforge.net
 
 For more info see:
 http://geeqie.sourceforge.net
@@ -48,145 +48,31 @@ geeqie-devel@lists.sourceforge.net
 ======== Requirements
 
   Required libraries:
 ======== Requirements
 
   Required libraries:
-    GTK+ 2.4.x: ftp://ftp.gtk.org/pub/gtk
+    GTK+ 2.20: ftp://ftp.gtk.org/pub/gtk
 
   Optional libraries:
     lcms, for color management support: http://www.littlecms.com
         (disable with configure option: '--without-lcms')
     exiv2, for enhanced exif support: http://www.exiv2.org/
         (disable with configure option: '--without-exiv2')
 
   Optional libraries:
     lcms, for color management support: http://www.littlecms.com
         (disable with configure option: '--without-lcms')
     exiv2, for enhanced exif support: http://www.exiv2.org/
         (disable with configure option: '--without-exiv2')
+        - due to fast development, newer versions work significantly better
+        FIXME: minimal version ?
     lirc, for remote control support: http://www.lirc.org/
        (disable with configure option: '--disable-lirc')
     lirc, for remote control support: http://www.lirc.org/
        (disable with configure option: '--disable-lirc')
-
+    libchamplain - experimental map support, dissabled by default
+        http://projects.gnome.org/libchamplain/
+        WARNING: this library has a lot of dependencise
+        
 ======== Notes and changes for this release            [section:release_notes]
 
 ======== Notes and changes for this release            [section:release_notes]
 
-  Changes:
-
-    + Add support for color profiles (requires lcms, see Notes).
-    + Add ability to delete a folder and it's contents (with restrictions).
-    - Add support for jpegs embedded in pentax and olympus raw files.
-    - Add icons for image state, enabled with I keyboard shortcut.
-    - For pan view calendar only show months that contain an image.
-    - Make scrolling with overlays (full screen info display) a bit smoother.
-    - Make sort menus display choices as radio group instead of checkbox.
-    - Use white background for transparent images when printing.
-    * Escape filename characters "`$\ before passing them to the system shell
-      when running an editor command.
-    * Fix occasional crash in icon view when removing files.
-    * Always use aligned memory access in EXIF parser, fixes crash
-      with BUS error on sparc.
-    * Fix progress bar warning when removing files while loading thumbnails.
-    * Fix image count in full screen information overlay when in slideshow.
-    * Fix memory leak when unable to start a slideshow.
-
-  Notes:
-
-    For translation status list, see further below.
-
-    Version in parenthesis indicates first appearance of feature or change.
-
-!!! FIXME Geeqie changes !!!
-       
-    Below are GQView releases:
-    (2.1.5) Add support for color profiles when lcms is installed. To
-    disable color profiles and use of lcms, run configure
-    with '--without-lcms'.
-
-    (2.1.1) Add support for viewing jpeg images and EXIF embedded within
-    raw files for Canon (.crw, .cr2) Fujifilm (.raf), and Nikon (.nef).
-    Note that not all cameras that support a raw format will necessarily
-    save a usable jpeg in the raw file (for example some Nikon cameras only
-    store a tiny thumbnail within the raw .nef file).
-
-    (1.5.6) The "shared thumbnail cache" is a proposal to unify the method
-    of storing thumbnails, so that they are compatible between different
-    applications. Using this option will allow GQview to share it's
-    thumbnails with, and use thumbnails from, other applications. Current
-    releases of GNOME (through nautilus and gthumb) and the gimp use this
-    new thumbnailing system. The latest draft of the thumbnail standard
-    is located on freedesktop.org in the standards section, and links to:
-
-      http://triq.net/~jens/thumbnail-spec/index.html
-
-    The shared thumbnail standard and GQview's classic mechanism can
-    not be used at the same time, enabling the "use shared thumbnail cache"
-    option will disable the use of classic thumbnails and use the new
-    shared thumbnails.
-
-    (1.5.6) Collections contained in $HOME/.gqview/collections are now
-    updated when moving or renaming files, even if the collection is not
-    open at the time.
-
-    (1.5.6) The new option to the keep the full screen window above other
-    windows is only available when using at least GTK+ 2.4.0
-
-    (1.5.5) Dialog buttons are now ordered as recommended by the GNOME HIG.
-    The GNOME Human Interface Guidelines live at:
-       http://developer.gnome.org/projects/gup/hig/
-    To restore the old button order you must be using GTK 2.6 and set
-    the "gtk-alternative-button-order" key to TRUE in the gtkrc file:
-       $HOME/.gtkrc-2.0
-    by changing or adding this line:
-       gtk-alternative-button-order = 1
-
-    (1.5.5) The dithering option is now a hidden option, to change it
-    please refer to section 10.7 of the manual (help -> contents).
-
-    (1.5.0) Keywords and comments can now be entered for a file. Two places
-    allow keyword and comment entry. The first is via the new image details
-    sidebar accessed with (Ctrl-K), and the second is a details tab in the
-    properties dialog. If multiple files are selected, two buttons are
-    available: One allows adding the keywords to the selected files, the
-    other replaces existing keywords with the new keywords.
-
-    Keyword and comment metadata is stored in $(HOME)/.gqview/metadata, and
-    mirrors the existing filesystem tree. Metadata filenames have a suffix
-    of .meta appended. If 'cache into .thumbnails' is enabled, metadata is
-    stored locally to the original file in a hidden subfolder ".metadata".
-    If write permissions do not allow local saving of metadata, GQview falls
-    back to the default $(HOME)/.gqview/metadata location.
-
-    (1.5.0) Search dialog (F3 key) types:
-       Path       searches files in the entered folder.
-       Comments   searches all file metadata stored in ~/.gqview/metadata.
-       Results    searches the current list of results, allowing refinement.
-
-    (1.3.6) Drag and drop has been significantly improved, with a few
-    changes. Button 1 will now initiate a drag, button 2 will still work
-    for this, the difference is button 2 will not change the selection.
-
-    (1.3.6) A middle button click will now toggle selection of clicked item.
-
-    (1.3.5) UTF-8 and filenames: GQview works fine if your filenames
-    correctly match the prefered locale encoding (LANG environment
-    variable), and prints errors on the console when they do not.
-
-    (1.3.3) Safe delete does not include undo, you will need to go to the
-    trash folder and retrieve the file(s) manually. The files can be viewed
-    by clicking the view button near the safe delete option in the preferences
-    window. Files moved to the trash folder are prefixed with a 6 digit
-    number. Lower numbers are older, and deleted (permanently) first when the
-    trash size limit is reached.
-
-    (1.3.2) New in 1.3.2 are sidebars for exif data display and a sort
-    manager. Exif (ctrl + E) should be self explanatory. The Sort manager is a
-    directory list that allows copying or moving the displayed image to that
-    destination with one click of the button - very helpful when visually
-    sorting many images into subdirectories. To edit, reorder, or remove items
-    in the sort list, use the right click menu. The keyboard can also be used
-    by moving the focus to the desired button, then pressing menu/ctrl+f10 key
-    to display the popup menu, or shift+up/shift+down keys to change the
-    button location in the list. Items can also be added to the list by
-    dragging a directory onto the list.
+See http://geeqie.wiki.sourceforge.net/new_features
+
 
   Code hackers:
 
     If you plan on making any major changes to the code that will be offered
     for inclusion to the main source, please contact us first - so that we
 
   Code hackers:
 
     If you plan on making any major changes to the code that will be offered
     for inclusion to the main source, please contact us first - so that we
-    can avoid duplication of effort. A good example is porting any part of
-    GQview that uses deprecated widgets to GTK2 widgets, there are already
-    several such patches floating around. This is especially true if the
-    change is listed in the TODO!
+    can avoid duplication of effort. 
                                                          The Geeqie Team
 
   Known bugs:
                                                          The Geeqie Team
 
   Known bugs:
@@ -199,17 +85,6 @@ geeqie-devel@lists.sourceforge.net
   General install: make install
   Removal: make uninstall
 
   General install: make install
   Removal: make uninstall
 
-!!! FIXME !!!
-    - To build an RPM binary:
-
-         on RedHat 6.x, 7.x use 'rpm -tb gqview-x.x.x.tar.gz'.
-         on RedHat 8 and 9 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
 
   Geeqie is a graphics file viewer. Basic features:
 ======== Description / Features
 
   Geeqie is a graphics file viewer. Basic features:
@@ -226,9 +101,17 @@ geeqie-devel@lists.sourceforge.net
     - Comparison of images to find duplicates by name, size, date,
       dimensions, or image content similarity.
     - EXIF support.
     - Comparison of images to find duplicates by name, size, date,
       dimensions, or image content similarity.
     - EXIF support.
+    
+  Geeqie 1.1:
+    - support for stereoscopic images
+      - input: side-by-side (JPS) and MPO format
+      - output: single image, anaglyph, SBS, mirror, SBS half size (3DTV)
 
 ======== Documentation (brief)                         [section:documentation]
 
 
 ======== Documentation (brief)                         [section:documentation]
 
+This sections lists default hotkeys. Most of the hotkeys can be redefined 
+in the Preferences dialog.
+
   Keyboard commands:
     [PageDown], [Keypad PageDown]      next image
     [PageUp], [Keypad PageUp]          previous image
   Keyboard commands:
     [PageDown], [Keypad PageDown]      next image
     [PageUp], [Keypad PageUp]          previous image
@@ -255,10 +138,11 @@ geeqie-devel@lists.sourceforge.net
     [Ctrl] - R                         rename file
     [Ctrl] - D, [Delete]               delete file
     [Ctrl] - W                         close window
     [Ctrl] - R                         rename file
     [Ctrl] - D, [Delete]               delete file
     [Ctrl] - W                         close window
-    [Ctrl] - Q                         exit GQview
+    [Ctrl] - Q                         exit Geeqie
 
   Edit menu related:
 
   Edit menu related:
-    [Ctrl] - 1 .. 0                    run external editor
+    1 .. 6                             toggle mark
+    [Ctrl] - 1..6                      select mark
     [Ctrl] - A                         select all files
     [Ctrl] - [Shift] - A               unselect all files
     [Ctrl] - P                         display image properties window
     [Ctrl] - A                         select all files
     [Ctrl] - [Shift] - A               unselect all files
     [Ctrl] - P                         display image properties window
@@ -267,7 +151,7 @@ geeqie-devel@lists.sourceforge.net
     [                                  rotate image counterclockwise
     [Shift] - R                        rotate image 180 degrees
     [Shift] - M                        mirror image (horizontal)
     [                                  rotate image counterclockwise
     [Shift] - R                        rotate image 180 degrees
     [Shift] - M                        mirror image (horizontal)
-    [Shift] - F                        flip image (verticle)
+    [Shift] - F                        flip image (vertical)
     [Shift] - G                        grayscale image
 
   View menu related:
     [Shift] - G                        grayscale image
 
   View menu related:
@@ -277,8 +161,6 @@ geeqie-devel@lists.sourceforge.net
     X, [Keypad *]                      zoom to fit within window
     W                                  zoom to fit width of window
     H                                  zoom to fit height of window
     X, [Keypad *]                      zoom to fit within window
     W                                  zoom to fit width of window
     H                                  zoom to fit height of window
-    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
     T                                  toggle thumbnails in list view
     [Ctrl] - L                         display files as list view
     [Ctrl] - I                         display files as icon view
@@ -286,8 +168,8 @@ geeqie-devel@lists.sourceforge.net
     R                                  refresh list
     L                                  (Un)float file selection area
     [ctrl] - H                         (Un)hide file selection area
     R                                  refresh list
     L                                  (Un)float file selection area
     [ctrl] - H                         (Un)hide file selection area
-    [Ctrl] - K                         toggle Keywords sidebar
-    [Ctrl] - E                         toggle EXIF sidebar
+    [Ctrl] - K                         toggle sidebar with EXIF or keywords
+    [Ctrl] - E                         show EXIF window
     [Ctrl] - S                         toggle sort manager sidebar
     F, V                               toggle full screen
     S                                  toggle slide show
     [Ctrl] - S                         toggle sort manager sidebar
     F, V                               toggle full screen
     S                                  toggle slide show
@@ -322,7 +204,6 @@ geeqie-devel@lists.sourceforge.net
 
     [Enter], [Keypad Enter]            view image with focus in main window
     V                                  view image with focus in new window
 
     [Enter], [Keypad Enter]            view image with focus in main window
     V                                  view image with focus in new window
-    [Ctrl] - 1 .. 0                    open selected image(s) in editor
 
     S                                  save collection
     [Ctrl] - S                         save collection as...
 
     S                                  save collection
     [Ctrl] - S                         save collection as...
@@ -388,23 +269,8 @@ geeqie-devel@lists.sourceforge.net
 
 ======== Editor command macros                               [section:editors]
 
 
 ======== Editor command macros                               [section:editors]
 
- Any one of the following filename markers may be used:
-
-    %f  Replaced with list of selected files, may occur once.
-    %p  Command is run once for each selected file, may occur multiple times.
-   none When neither %f or %p exist, list of files is appended to command.
-
- Use of the following to display output window for the command:
-
-    %v  Display result of command in output window, must occur as first two
-        characters in the command, or immediately after the "%w" macro.
-    %V  Like v above, but when used with %p, only displays output window for
-        multiple files. The output of a single file is suppressed.
-
- Additional macros:
-
-    %w  Prevent full screen from deactivating when command is executed,
-        must occur as the first two characters.
+Editors are configured via standard desktop files, see
+https://sourceforge.net/apps/trac/geeqie/wiki/GuideEditorsConfig
 
 
 ======== Overlay Info                                        [section:overlay]
 
 
 ======== Overlay Info                                        [section:overlay]
@@ -420,7 +286,9 @@ Overlay info format string syntax is: %tag[:max_length][:extra]%
   %width%      Image width
   %height%     Image height
   %res%        Image resolution
   %width%      Image width
   %height%     Image height
   %res%        Image resolution
-  
+  %keywords%   Image keywords from metadata
+  %comment%    Image comment from metadata
+
   To access exif data use the exif name:
   %Exif.Photo.DateTimeOriginal%        Date of the original shot
 
   To access exif data use the exif name:
   %Exif.Photo.DateTimeOriginal%        Date of the original shot
 
@@ -437,6 +305,8 @@ Overlay info format string syntax is: %tag[:max_length][:extra]%
   formatted.Flash               Flash
   formatted.Resolution          Resolution
   formatted.ColorProfile        Color profile
   formatted.Flash               Flash
   formatted.Resolution          Resolution
   formatted.ColorProfile        Color profile
+  formatted.GPSPosition                GPS position
+  formatted.GPSAltitude                GPS altitude
 
   You can limit the length of displayed data using :number notation:
   %formatted.Camera:20% will truncate the displayed data to 20 characters
 
   You can limit the length of displayed data using :number notation:
   %formatted.Camera:20% will truncate the displayed data to 20 characters
@@ -451,7 +321,7 @@ Overlay info format string syntax is: %tag[:max_length][:extra]%
     "1/200 - 80 mm" if there's no ISO information in the Exif data.
 
   If a line is empty, it is removed.
     "1/200 - 80 mm" if there's no ISO information in the Exif data.
 
   If a line is empty, it is removed.
-  This allows to add lines that totally disappear when no data is available.
+  This allows one to add lines that totally disappear when no data is available.
 
   Extra string uses special character '*' to mark the position of the data.
   If no '*' is present, then extra string is just appended to data.
 
   Extra string uses special character '*' to mark the position of the data.
   If no '*' is present, then extra string is just appended to data.
@@ -463,29 +333,10 @@ Overlay info format string syntax is: %tag[:max_length][:extra]%
   "%name:<i>*</i>\n%" -> name is displayed in italics ended with a newline
   "%size:\n%"         -> size is displayed with a newline at end
   "%formatted.ISOSpeedRating:ISO *%"      -> ie. "ISO 100"
   "%name:<i>*</i>\n%" -> name is displayed in italics ended with a newline
   "%size:\n%"         -> size is displayed with a newline at end
   "%formatted.ISOSpeedRating:ISO *%"      -> ie. "ISO 100"
-  "Collection <b>*</b>\n" -> display collection name in bold prefixed by
+  "%collection: Collection <b>*</b>\n%" -> display collection name in bold prefixed by
                              "Collection " and a newline is appended
 
 
                              "Collection " and a newline is appended
 
 
-======== Additional comments:
-
-  Hidden options:
-    These options are not adjustable in the preferences window, to change
-    them edit $(HOME)/.geeqie/geeqierc while Geeqie is not running. An option
-    becomes 'hidden' 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.
-
-
-
 ======== Credits                                             [section:credits]
 
 
 ======== Credits                                             [section:credits]
 
 
@@ -548,6 +399,7 @@ Overlay info format string syntax is: %tag[:max_length][:extra]%
      Thomas Klausner <wiz@danbala.ifoer.tuwien.ac.at>
      Danny Milosavljevic <danny_milo@yahoo.com>
      Ronny Steiner <Post@SIRSteiner.de>
      Thomas Klausner <wiz@danbala.ifoer.tuwien.ac.at>
      Danny Milosavljevic <danny_milo@yahoo.com>
      Ronny Steiner <Post@SIRSteiner.de>
+     Klaus Ethgen <Klaus@Ethgen.de>
          for German translation
 
      Matej Erman <matej.erman@guest.arnes.si>
          for German translation
 
      Matej Erman <matej.erman@guest.arnes.si>
@@ -660,58 +512,14 @@ Overlay info format string syntax is: %tag[:max_length][:extra]%
      
      Carles Pina i Estany
          for copy path to clipboard patch
      
      Carles Pina i Estany
          for copy path to clipboard patch
-  
+     Kjell Morgenstern
+         for random slide show speedup patch
+
+     Klaus Ethgen <Klaus@Ethgen.de>
+         for GPS integration, Search enhancement and other patches
+
      And...
          Thanks to the users for finding Geeqie useful.
 
 
      And...
          Thanks to the users for finding Geeqie useful.
 
 
-======== Translation status:
-
-   Please send po files/patches in gzipped form to ensure data integrity.
-
-Translations statistics
-Date: Sun, 11 May 2008 12:03:37 +0200
-
-Note: completion % in the chart below may not be quite correct
-      when fuzzy translations exist but do not appear in the source.
-      For exact results, run make update-po with up to date POTFILES.in.
-      comp % = trans / (trans + fuzzy + untrans)
-
-Language      Comp(%)  Trans  Fuzzy  Untrans  Total
-fr             100.00    985      0        0    985
-be              90.56    892     25       68    985
-eu              68.53    675    150      160    985
-eo              68.22    672    153      160    985
-vi              68.02    670    156      159    985
-it              67.82    668    154      163    985
-pt_BR           67.82    668    154      163    985
-zh_TW           66.90    659    150      176    985
-sk              66.50    655    158      172    985
-fi              64.37    634    176      175    985
-nl              64.37    634    179      172    985
-sv              64.16    632    175      178    985
-bg              64.06    631    175      179    985
-ca              64.06    631    175      179    985
-cs              64.06    631    175      179    985
-de              64.06    631    175      179    985
-es              64.06    631    175      179    985
-ja              64.06    631    175      179    985
-ru              64.06    631    175      179    985
-pl              60.61    597    148      240    985
-ar              42.94    423    315      247    985
-ro              37.56    370    342      273    985
-hu              36.14    356    332      297    985
-id              19.70    194    408      383    985
-et              19.29    190    407      388    985
-uk              17.16    169    411      405    985
-nb              15.94    157    416      412    985
-zh_CN.GB2312    15.94    157    416      412    985
-th              15.13    149    413      423    985
-sl              14.72    145    419      421    985
-da              12.99    128    402      455    985
-ko              11.37    112     52      821    985
-tr               6.60     65    398      522    985
-
-
-========
-