Include a Other Software section in Help file
[geeqie.git] / geeqie.1
index 301f4ee..828239e 100644 (file)
--- a/geeqie.1
+++ b/geeqie.1
@@ -51,6 +51,10 @@ Start with blank file list.
 Set main window location.
 .br
 .B
+.IP \-n,\-\-new-instance
+Open a new instance of Geeqie.
+.br
+.B
 .IP \-r,\-\-remote
 Send following commands to open window.
 .br
@@ -81,6 +85,10 @@ Print version.
 .B
 .IP \-h,\-\-help
 Print command line options.
+.br
+.B
+.IP \-\-disable-clutter
+Disable use of Clutter library (i.e. GPU accel.).
 
 .SH REMOTE OPTIONS
 .B
@@ -144,7 +152,7 @@ Hide tools.
 Quit.
 .br
 .B
-.IP \-\-config-load:<FILE>
+.IP \-\-config-load:<FILE>|layout\ ID
 Load configuration from FILE.
 .br
 .B
@@ -156,16 +164,60 @@ Get list of sidecars of FILE.
 Get destination path of FILE.
 .br
 .B
-.IP \-\-file:<FILE>
-Open FILE, bring Geeqie window to the top.
+.IP file:<FILE>|<URL>
+Open FILE or URL, bring Geeqie window to the top.
 .br
 .B
-.IP \-\-File:<FILE>
-Open FILE, do not bring Geeqie window to the top.
+.IP \-\-file:<FILE>|<URL>
+Open FILE or URL, bring Geeqie window to the top.
+.br
+.B
+.IP File:<FILE>|<URL>
+Open FILE or URL, do not bring Geeqie window to the top.
+.br
+.B
+.IP \-\-File:<FILE>|<URL>
+Open FILE or URL, do not bring Geeqie window to the top.
 .br
 .B
 .IP \-\-tell
-Print filename of current image.
+Print filename [and Collection] of current image.
+.br
+.B
+.IP \-\-pixel\-info
+Print X, Y and RGB of mouse pointer on current image.
+.br
+.B
+.IP \-\-get\-rectangle
+Get rectangle co-ordinates.
+.br
+.B
+.IP \-\-get\-render\-intent
+Get render intent.
+.br
+.B
+.IP \-\-get\-filelist:[<FOLDER>]
+Get list of files and class.
+.br
+.B
+.IP \-\-get\-filelist-recurse:[<FOLDER>]
+Get list of file and class recursive.
+.br
+.B
+.IP \-\-get\-collection:<COLLECTION>
+Get collection content.
+.br
+.B
+.IP \-\-get\-collection\-list
+Get collection list.
+.br
+.B
+.IP \-\-get\-file\-info
+Get file info.
+.br
+.B
+.IP view:<FILE>
+Open FILE in new window.
 .br
 .B
 .IP \-\-view:<FILE>
@@ -184,6 +236,26 @@ Add FILE to command line collection list.
 Bring the Geeqie window to the top.
 .br
 .B
+.IP \-\-raise
+Bring the Geeqie window to the top.
+.br
+.B
+.IP \-\-id:<ID>
+Window ID for following commands.
+.br
+.B
+.IP \-\-new-window
+Open new window.
+.br
+.B
+.IP \-\-close-window
+Close window.
+.br
+.B
+.IP \-\-geometry=[XxY][+XOFF+YOFF]
+Set window geometry.
+.br
+.B
 .IP \-ct:clear|clean,\-\-cache-thumbs:clear|clean
 Clear or clean thumbnail cache.
 .br
@@ -215,6 +287,14 @@ Render thumbnails recursively (see Help).
 .IP \-\-lua:<FILE>,<lua-script>
 Run lua script on FILE.
 .br
+.B
+.IP \-\-PWD:<PWD>
+Use PWD as working directory for following commands.
+.br
+.B
+.IP \-\-print0
+Terminate returned data with null character instead of newline.
+.br
 
 .SH USAGE
 Key naming is similar to that of \fBemacs\fP(1): \fIC-key\fP indicates that control should be held, and key should be pressed; \fIS-key\fP  indicates that shift should be held and key should be pressed; these two can be combined, also, into \fIC-S-key\fP.
@@ -628,6 +708,59 @@ delete selected files
 close window
 .br
 
+.SH FILES
+The following data lists the locations Geeqie uses for various actions. The
+uppercase symbols are environment variables. If they are not set on your system
+the fallback locations are listed in parentheses. Geeqie will first attempt to
+load a configuration file from:
+
+.B /etc/geeqie/geeqierc.xml
+
+It will then continue with the following locations.
+Most of Geeqie's configuration files are contained in the folder, and sub-folders of:
+
+.B $XDG_CONFIG_HOME/geeqie/
+.B ($~/.config/geeqie/)
+
+Geeqie's standard configuration file is:
+
+.B .../geeqierc.xml
+
+An alternative configuration file may be used by executing:
+
+.B geeqie -r --config-load:<filename>
+
+Geeqie-created desktop files used by Plugins are in the folder:
+
+.B .../applications
+
+Lua script files for Lua Extensions are in the folder:
+
+.B .../lua
+
+Historic data such as last several folders visited, bookmarks, and recently used collections, as well as default print settings are contained in this text file:
+
+.B .../history
+
+Keyboard shortcut maps are contained in this text file:
+
+.B .../accels
+
+The location for Collections is in the folder:
+
+.B $XDG_DATA_HOME/geeqie/collections
+.br
+.B ($~/.local/share/geeqie/collections)
+
+The lirc Infra-red controller configuration file must be located at:
+
+.B $HOME/.lircrc
+
+Thumbnails are stored in a location specified in Thumbnail Preferences
+
+Metadata is stored either in the image file or in the location specified in Safe Delete
+
+The safe delete folder is specified in the Metadata tab of main Preferences
 
 .SH LICENSE
 Copyright (C) 1999-2004 by John Ellis.