# HG changeset patch
# User zas_
# Date 1226312811 0
# Node ID 7cd49c6dc3021bc8a180233a814658ac9a1927df
# Parent ba2bbc862da721f0280702091aba625f4ddb6fba
Reformatting: notes, advanced options page and more.
diff -r ba2bbc862da7 -r 7cd49c6dc302 doc/collections.html
--- a/doc/collections.html Sun Nov 09 21:53:33 2008 +0000
+++ b/doc/collections.html Mon Nov 10 10:26:51 2008 +0000
@@ -459,7 +459,7 @@
Note: When renaming or moving files within Geeqie, the contents of collections located in the folder ($HOME)/.geeqie/collections will automatically update to the new name or location.
+Note: When renaming or moving files within Geeqie, the contents of collections located in the folder ($HOME)/.geeqie/collections will automatically update to the new name or location.
diff -r ba2bbc862da7 -r 7cd49c6dc302 doc/faq.html
--- a/doc/faq.html Sun Nov 09 21:53:33 2008 +0000
+++ b/doc/faq.html Mon Nov 10 10:26:51 2008 +0000
@@ -41,73 +41,43 @@
1. Image viewing -
+1.1 How do I keep images smaller than the visible area from enlarging when the zoom is set to “fit to window” ?
+In the preferences dialog, under the “Image” tab, disable “Allow enlargement of image for zoom to fit”.
-
-
-
-
-
9. Command line -
- -9.1 How do I open an image in an existing Geeqie application ?
+Use the “-r” command line option to send commands to an existing Geeqie, for a list of commands supported by the remote switch run:
-
+
geeqie --remote-help
-
+
-
-
-
9.2 How do I set the slide show delay when starting Geeqie in slide show from the command line ?
+The delay can not be set when used with the standard -s command line switch, as -s uses the delay stored in the configuration file. For this use the remote command -ss to start the slide show after setting the delay with -d, the order of the command line is important, for example a 12 second slide show delay:
-
+
geeqie -r -d12 -ss
-
+
-
-
-
Note that if geeqie is running prior to this command, the slide show should also be stopped prior to changing the delay:
-Note that if geeqie is running prior to this command, the slide show should also be stopped prior to changing the delay:
- -
+
geeqie -r -sS -d12 -ss
-
-
-
-
-
-
-
10. Miscellaneous -
- -10.1 I want to be able to edit images with Geeqie
+ +Geeqie is an image viewer. There is, and never will be, a plan to add editing features. I recommend gimp for image editing.
-
-
-
The search will include all files that have a keyword or comment associated to it.
-Note: Only keyword and comment associations stored in the user's home folder are included in this search type.
+Note: Only keyword and comment associations stored in the user's home folder are included in this search type.
The tool bar includes buttons for often used operations. The tool bar can be hidden or shown by selecting “Hide toolbar” from the view menu.
-Note: These buttons are only displayed as an icon, the text below refers to the tool tip that appears by hovering the mouse over each button.
+Note: These buttons are only displayed as an icon, the text below refers to the tool tip that appears by hovering the mouse over each button.
A folder or file can be typed into the entry to quickly change to a desired location or image, the main window will update after pressing the Enter key. Tab completion is also available in the path entry.
-Note: Tab completion uses the tab key, press the down arrow to move the focus from the entry.
+Note: Tab completion uses the tab key, press the down arrow to move the focus from the entry.
Next to the path entry is a button with a down arrow, clicking this will display a drop down list containing the most recent locations viewed. The list is ordered such that the most recent location is at the top. Selecting a location from the drop down list will change the window to display the location.
@@ -122,9 +122,9 @@Note: Renaming a folder will not update metadata, such as keywords, or cached thumbnails for images contained in that folder, the data will be lost.
Note: Renaming a folder will not update metadata, such as keywords, or cached thumbnails for images contained in that folder, the data will be lost.
To rotate the image clockwise 90 degrees press the “]” key, to rotate counterclockwise 90 degrees press the “[“ key. To rotate the image 180 degrees use [Shift] + [R], the image can also be flipped horizontally or vertically with the respective [Shift] + [M] (mirror) and [Shift] + [F] (flip) keys.
-Note: The rotation, mirror, and flip functions will not change the image file on disk.
+Note: The rotation, mirror, and flip functions will not change the image file on disk.
Press the primary mouse button on the image and hold it, then move the mouse to pan the image in the desired direction. Releasing the mouse button will stop the panning operation. The mouse wheel can also be used to scroll the image when holding down the [Shift] key (*).
diff -r ba2bbc862da7 -r 7cd49c6dc302 doc/main_window_layout.html --- a/doc/main_window_layout.html Sun Nov 09 21:53:33 2008 +0000 +++ b/doc/main_window_layout.html Mon Nov 10 10:26:51 2008 +0000 @@ -49,7 +49,7 @@The order in which the panes are filled is determined by the three row list located below the layout selection. The three numbered rows correspond to the three numbered regions of the selected layout, to change the order of the list drag a row to the desired location within the list. To drag a row move the mouse over the selected row, press and hold the primary mouse button, then drag the row to the desired location and release the button.
-Note: In the options window the file and image panes are labeled similarly, however the folder pane is labeled as tools.
+Note: In the options window the file and image panes are labeled similarly, however the folder pane is labeled as tools.
Location: Selects the location and position of the full screen window. 'Determined by window manager' will leave the window placement up to the window manager. 'Active screen' places the window on the same screen as the Geeqie main window. 'Active monitor' does the same, but limits the full screen window size to the monitor containing the main window. The remaining choices are dependent on the multiple monitor configuration.
+Selects the location and position of the full screen window. 'Determined by window manager' will leave the window placement up to the window manager. 'Active screen' places the window on the same screen as the Geeqie main window. 'Active monitor' does the same, but limits the full screen window size to the monitor containing the main window. The remaining choices are dependent on the multiple monitor configuration.
Stay above other windows: Enable this to have Geeqie ask the window manager to keep the full screen window above other windows. Note that the window manager may ignore the request. This option is not relevant when the full screen location is determined by the window manager.
+Enable this to have Geeqie ask the window manager to keep the full screen window above other windows. Note that the window manager may ignore the request. This option is not relevant when the full screen location is determined by the window manager.
Smooth image flip: This option delays the image change in full screen until the next image is entirely decoded into memory, the result is a smoother transition between images.
+This option delays the image change in full screen until the next image is entirely decoded into memory, the result is a smoother transition between images.
Disable screen saver: This option will execute xscreensaver-command --deactivate once per minute to avoid the screen saver from activating when Geeqie is displayed full screen.
+This option will execute xscreensaver-command --deactivate once per minute to avoid the screen saver from activating when Geeqie is displayed full screen.
@@ -63,39 +70,52 @@
Confirm file delete: Prompts for confirmation before deleting files.
- -Enable Delete key: Disable this to disassociate the delete file function from the Delete key. This option does not effect the [Control] + D key sequence. May be useful in combination with “confirm file delete”, above, disabled so that accidentally hitting a single key will not result in deleted files.
+Prompts for confirmation before deleting files.
Safe Delete: Moves deleted files to a temporary folder, for easy retrieval of deleted files. Files in the temporary folder are retained until the maximum size is reached, at which point deleting additional files will result in the removal of the oldest files to reclaim the space needed for the new files.
+Disable this to disassociate the delete file function from the Delete key. This option does not effect the [Control] + D key sequence. May be useful in combination with “confirm file delete”, above, disabled so that accidentally hitting a single key will not result in deleted files.
Note: Files moved to the Safe Delete folder are prefixed with a six digit number in the format:
- -nnnnnn_FILENAME
+Moves deleted files to a temporary folder, for easy retrieval of deleted files. Files in the temporary folder are retained until the maximum size is reached, at which point deleting additional files will result in the removal of the oldest files to reclaim the space needed for the new files.
+Note: Files moved to the Safe Delete folder are prefixed with a six digit number in the format: nnnnnn_FILENAME
+ This is used by the delete feature to distinguish which files to remove first when clearing space for new files.
+ The digit counter increments with each deleted file.
This is used by the delete feature to distinguish which files to remove first when clearing space for new files. The digit counter increments with each deleted file.
+The location of the folder used by the Safe Delete feature.
Folder: The location of the folder used by the Safe Delete feature.
+The size to use for the Safe Delete folder, in megabytes.
Maximum size: The size to use for the Safe Delete folder, in megabytes.
+Removes all files contained in the Safe Delete folder.
Clear button: Removes all files contained in the Safe Delete folder.
- -View button: Changes the Geeqie main window to display the contents of the Safe Delete folder.
- +Changes the Geeqie main window to display the contents of the Safe Delete folder.
Rectangular selection in icon view: Enable this to change the selection method used when selecting multiple items in an icon view.
- -Descend folders in tree view: This will allow Geeqie to read sub folder content to determine if it should display expander indicators in the folder tree view.
+Enable this to change the selection method used when selecting multiple items in an icon view.
Note: Disable this if Geeqie wakes up auto mounted network shares, or takes too long to initially display the folder view.
+This will allow Geeqie to read sub folder content to determine if it should display expander indicators in the folder tree view.
+Note: Disable this if Geeqie wakes up auto mounted network shares, or takes too long to initially display the folder view.
+When renaming a single file, this will allow the rename entry to appear directly over the original filename.
In place renaming: When renaming a single file, this will allow the rename entry to appear directly over the original filename.
+
@@ -103,9 +123,13 @@
Progressive keyboard scrolling: This will cause image panning speed to gradually accelerate when holding down the keyboard arrows.
+This will cause image panning speed to gradually accelerate when holding down the keyboard arrows.
Mouse wheel scrolls image: The default is for the mouse wheel to change the image, and to scroll the image when shift is used in combination with the wheel. Enabling this swaps the behavior so that operating the wheel will scroll the image, and holding down shift will change the image.
+The default is for the mouse wheel to change the image, and to scroll the image when shift is used in combination with the wheel. Enabling this swaps the behavior so that operating the wheel will scroll the image, and holding down shift will change the image.
@@ -113,14 +137,20 @@
Store keywords and comments local to source images: When enabled, Geeqie attempts to store metadata such as keywords closer to the source image. The resulting location is the source image's folder, in a sub folder with the name ".metadata". When the image source folder cannot be written, Geeqie falls back to saving the medata in "$HOME/.geeqie/metadata".
+Custom similarity threshold: This setting is used by the compare method “similarity (custom)”, located in the Find Duplicates window.
+When enabled, Geeqie attempts to store metadata such as keywords closer to the source image. The resulting location is the source image's folder, in a sub folder with the name ".metadata". When the image source folder cannot be written, Geeqie falls back to saving the medata in "$HOME/.geeqie/metadata".
Offscreen cache size: Geeqie only renders the visible portion of an image. To reduce rendering the same area frequently when panning an image, some memory is used to retain the recently rendered image data. This value controls the maximum amount of memory to use.
+This setting is used by the compare method “similarity (custom)”, located in the Find Duplicates window.
Note: This setting controls the amount of memory for each image window.
+Geeqie only renders the visible portion of an image. To reduce rendering the same area frequently when panning an image, some memory is used to retain the recently rendered image data. This value controls the maximum amount of memory to use.
+Note: This setting controls the amount of memory for each image window.
+
This list contains the image formats that are understood by Geeqie. To disable a specific file type from being displayed, uncheck it's corresponding checkbox. Filters can be edited by first selecting the line containing the item to be changed, then clicking the filter or description field, making any changes, then pressing enter; press escape to cancel an active edit. The format for the filter field is a semicolon (;) seperated list of extensions, extensions must include the period (.).
-Note: Unlike all other options in the dialog, filter list changes are applied immediately.
+Note: Unlike all other options in the dialog, filter list changes are applied immediately.
Add button: Adds a new blank line to the filter list, change the parameters to match the desired file type.
diff -r ba2bbc862da7 -r 7cd49c6dc302 doc/options_general.html --- a/doc/options_general.html Sun Nov 09 21:53:33 2008 +0000 +++ b/doc/options_general.html Mon Nov 10 10:26:51 2008 +0000 @@ -91,7 +91,7 @@Note: Support for xvpics is read only, Geeqie can not generate thumbnails in this format.
Note: Random images are displayed such that each image appears once per cycle of all images. When the slide show repeat option is enabled, the image order is randomized after completing each cycle.
Refresh on file change: Geeqie will monitor currently active images and folders for changes in their modification time, and update the display if it changes.
-Note: Disable this if the system will not go into sleep mode due to occasional disk activity from the time check, or if Geeqie updates too often for folders with continuously changing content.
+Note: Disable this if the system will not go into sleep mode due to occasional disk activity from the time check, or if Geeqie updates too often for folders with continuously changing content.
Preload next image: Enabling this option will cause Geeqie to read the next logical image from disk when idle, it will also retain the previously viewed image in memory. By reading the nearest images into memory, time to display the next image is reduced.
@@ -101,7 +101,7 @@Note: This option will increase Geeqie memory requirements, and may cause performance issues with very large images. If the use of Geeqie results in the system noticeably swapping memory to disk, try disabling this feature.