Eliminate some GitHub action warnings
[geeqie.git] / geeqie.1
index a6ca723..45d716b 100644 (file)
--- a/geeqie.1
+++ b/geeqie.1
@@ -1,5 +1,5 @@
 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
-.TH GEEQIE "1" "June 2023" "Geeqie 2.1 GTK3" "User Commands"
+.TH GEEQIE "1" "April 2024" "Geeqie 2.4+git20240413-fc816858 GTK3" "User Commands"
 .SH NAME
 Geeqie - GTK based multiformat image viewer
 .SH SYNOPSIS
@@ -11,13 +11,13 @@ zooming, panning, thumbnails and sorting images into collections.
 
 Generated for version:
 .PP
-Geeqie 2.1
+Geeqie 2.4+git20240413\-fc816858
 .SS "Valid options:"
 .TP
 \fB\-\-blank\fR
 start with blank file list
 .TP
-\fB\-\-cache\-maintenance\fR <path>
+\fB\-\-cache\-maintenance=\fR<path>
 run cache maintenance in non\-GUI mode
 .TP
 \fB\-\-disable\-clutter\fR
@@ -35,21 +35,21 @@ show this message
 \fB\-l\fR, \fB\-\-list\fR [files] [collections] open collection window for command line
 .TP
 \fB\-n\fR, \fB\-\-new\-instance\fR
-open a new instance of Geeqie
+open a new instance of Geeqie *
 .TP
-\fB\-o\fR:, \fB\-\-log\-file\fR:<file>
+\fB\-o\fR, \fB\-\-log\-file=\fR<file>
 save log data to file
 .TP
 \fB\-r\fR, \fB\-\-remote\fR
 send following commands to open window
 .TP
-\fB\-rh\fR, \fB\-\-remote\-help\fR
+\fB\-\-remote\-help\fR
 print remote command list
 .TP
 \fB\-s\fR, \fB\-\-slideshow\fR
 start in slideshow mode
 .TP
-+t, \fB\-\-with\-tools\fR
+\fB\-T\fR, \fB\-\-with\-tools\fR
 force show of tools
 .TP
 \fB\-t\fR, \fB\-\-without\-tools\fR
@@ -58,47 +58,59 @@ force hide of tools
 \fB\-v\fR, \fB\-\-version\fR
 print version info
 .TP
-+w, \fB\-\-show\-log\-window\fR
+\fB\-w\fR, \fB\-\-show\-log\-window\fR
 show log window
 .TP
 \fB\-\-debug\fR[=\fI\,level\/\fR]
 turn on debug output
 .TP
-\fB\-g\fR:, \fB\-\-grep\fR:<regexp>
+\fB\-g\fR, \fB\-\-grep=\fR<regexp>
 filter debug output
+.PP
+* Normally a single set of configuration files is used for all instances.
+However, the environment variables XDG_CONFIG_HOME, XDG_CACHE_HOME, XDG_DATA_HOME
+can be used to modify this behavior on an individual basis e.g.
+.PP
+XDG_CONFIG_HOME=/tmp/a XDG_CACHE_HOME=/tmp/b geeqie
 .SS "Remote command list:"
 .TP
+\fB\-\-action=\fR<ACTION>
+execute keyboard action (See Help/Reference/Remote Keyboard Actions)
+.TP
+\fB\-\-action\-list\fR
+list available keyboard actions (some are redundant)
+.TP
 \fB\-b\fR   \fB\-\-back\fR
 previous image
 .TP
 \fB\-\-close\-window\fR
 close window
 .TP
-\fB\-\-config\-load\fR:<FILE>|layout ID
+\fB\-\-config\-load=\fR<FILE>|layout ID
 load configuration from FILE
 .TP
-\fB\-cm\fR  \fB\-\-cache\-metadata\fR
+\fB\-\-cache\-metadata\fR
 clean the metadata cache
 .TP
-\fB\-cr\fR: \fB\-\-cache\-render\fR:<folder>
+\fB\-\-cache\-render=\fR<folder>
 render thumbnails
 .TP
-\fB\-crr\fR: \fB\-\-cache\-render\-recurse\fR:<folder>
+\fB\-\-cache\-render\-recurse=\fR<folder>
 render thumbnails recursively
 .TP
-\fB\-crs\fR: \fB\-\-cache\-render\-shared\fR:<folder>
+\fB\-\-cache\-render\-shared=\fR<folder>
 render thumbnails (see Help)
 .TP
-\fB\-crsr\fR: \fB\-\-cache\-render\-shared\-recurse\fR:<folder>
+\fB\-\-cache\-render\-shared\-recurse=\fR<folder>
 render thumbnails recursively (see Help)
 .TP
-\fB\-cs\fR: \fB\-\-cache\-shared\fR:clear|clean
-clear or clean shared thumbnail cache
+\fB\-\-cache\-shared\fR=\fI\,clean\/\fR|clear
+clean or clear shared thumbnail cache
 .TP
-\fB\-ct\fR: \fB\-\-cache\-thumbs\fR:clear|clean
-clear or clean thumbnail cache
+\fB\-\-cache\-thumbs\fR=\fI\,clean\/\fR|clear
+clean or clear thumbnail cache
 .TP
-\fB\-d\fR   \fB\-\-delay=\fR<[H:][M:][N][.M]>
+\fB\-d\fR   \fB\-\-delay=\fR<[H=][M=][N][.M]>
 set slide show delay to Hrs Mins N.M seconds
 .TP
 \fB\-\-first\fR
@@ -107,43 +119,37 @@ first image
 \fB\-f\fR   \fB\-\-fullscreen\fR
 toggle full screen
 .TP
-\fB\-\-file\fR:<FILE>|<URL>
+\fB\-\-file=\fR<FILE>|<URL>
 open FILE or URL, bring Geeqie window to the top
 .TP
-file:<FILE>|<URL>
-open FILE or URL, bring Geeqie window to the top
-.TP
-\fB\-\-File\fR:<FILE>|<URL>
+\fB\-\-File=\fR<FILE>|<URL>
 open FILE or URL, do not bring Geeqie window to the top
 .TP
-File:<FILE>|<URL>
-open FILE or URL, do not bring Geeqie window to the top
-.TP
-\fB\-fs\fR  \fB\-\-fullscreen\-start\fR
+\fB\-\-fullscreen\-start\fR
 start full screen
 .TP
-\fB\-fS\fR  \fB\-\-fullscreen\-stop\fR
+\fB\-\-fullscreen\-stop\fR
 stop full screen
 .TP
 \fB\-\-geometry=\fR<GEOMETRY>
 set window geometry
 .TP
-\fB\-\-get\-collection\fR:<COLLECTION>
+\fB\-\-get\-collection=\fR<COLLECTION>
 get collection content
 .TP
 \fB\-\-get\-collection\-list\fR
 get collection list
 .TP
-\fB\-\-get\-destination\fR:<FILE>
+\fB\-\-get\-destination=\fR<FILE>
 get destination path of FILE (See Plugins Configuration)
 .TP
 \fB\-\-get\-file\-info\fR
 get file info
 .TP
-\fB\-\-get\-filelist\fR:[<FOLDER>]
+\fB\-\-get\-filelist\fR=\fI\,[\/\fR<FOLDER>]
 get list of files and class
 .TP
-\fB\-\-get\-filelist\-recurse\fR:[<FOLDER>]
+\fB\-\-get\-filelist\-recurse\fR=\fI\,[\/\fR<FOLDER>]
 get list of files and class recursive
 .TP
 \fB\-\-get\-rectangle\fR
@@ -155,22 +161,25 @@ get render intent
 \fB\-\-get\-selection\fR
 get list of selected files
 .TP
-\fB\-\-get\-sidecars\fR:<FILE>
+\fB\-\-get\-sidecars=\fR<FILE>
 get list of sidecars of FILE
 .TP
-\fB\-\-id\fR:<ID>
+\fB\-\-get\-window\-list\fR
+get window list
+.TP
+\fB\-\-id=\fR<ID>
 window id for following commands
 .TP
 \fB\-\-last\fR
 last image
 .TP
-\fB\-\-list\-add\fR:<FILE>
+\fB\-\-list\-add=\fR<FILE>
 add FILE to command line collection list
 .TP
 \fB\-\-list\-clear\fR
 clear command line collection list
 .TP
-\fB\-\-lua\fR:<FILE>,<lua script>
+\fB\-\-lua=\fR<FILE>,<lua script>
 run lua script on FILE
 .TP
 \fB\-\-new\-window\fR
@@ -185,7 +194,7 @@ print pixel info of mouse pointer on current image
 \fB\-\-print0\fR
 terminate returned data with null character instead of newline
 .TP
-\fB\-\-PWD\fR:<PWD>
+\fB\-\-PWD=\fR<PWD>
 use PWD as working directory for following commands
 .TP
 \fB\-q\fR   \fB\-\-quit\fR
@@ -194,43 +203,37 @@ quit
 \fB\-\-raise\fR
 bring the Geeqie window to the top
 .TP
-raise
-bring the Geeqie window to the top
-.TP
-\fB\-\-selection\-add\fR:[<FILE>]
+\fB\-\-selection\-add\fR=\fI\,[\/\fR<FILE>]
 adds the current file (or the specified file) to the current selection
 .TP
 \fB\-\-selection\-clear\fR
 clears the current selection
 .TP
-\fB\-\-selection\-remove\fR:[<FILE>]
+\fB\-\-selection\-remove\fR=\fI\,[\/\fR<FILE>]
 removes the current file (or the specified file) from the current selection
 .TP
 \fB\-s\fR   \fB\-\-slideshow\fR
 toggle slide show
 .TP
-\fB\-\-slideshow\-recurse\fR:<FOLDER>
+\fB\-\-slideshow\-recurse=\fR<FOLDER>
 start recursive slide show in FOLDER
 .TP
-\fB\-ss\fR  \fB\-\-slideshow\-start\fR
+\fB\-\-slideshow\-start\fR
 start slide show
 .TP
-\fB\-sS\fR  \fB\-\-slideshow\-stop\fR
+\fB\-\-slideshow\-stop\fR
 stop slide show
 .TP
 \fB\-\-tell\fR
 print filename [and Collection] of current image
 .TP
-+t   \fB\-\-tools\-show\fR
+\fB\-T\fR   \fB\-\-tools\-show\fR
 show tools
 .TP
 \fB\-t\fR   \fB\-\-tools\-hide\fR
 hide tools
 .TP
-\fB\-\-view\fR:<FILE>
-open FILE in new window
-.TP
-view:<FILE>
+\fB\-\-view=\fR<FILE>
 open FILE in new window
 .IP
 All other command line parameters are used as plain files if they exist.
@@ -239,7 +242,7 @@ The name of a collection, with or without either path or extension (.gqv) may be
 .SH BUGS
 Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues
 .SH COPYRIGHT
-Copyright (C) 1999-2004 by John Ellis. Copyright (C) 2004-2023 by The Geeqie Team. Use this software  at  your
+Copyright (C) 1999-2004 by John Ellis. Copyright (C) 2004-2024 by The Geeqie Team. Use this software  at  your
 own  risk! This  software released under the GNU General Public License. Please read the COPYING file for more
 information.
 .SH "SEE ALSO"