From 030fc5918984956c172e50f22ab1e2f5a324cf99 Mon Sep 17 00:00:00 2001 From: Daniel Friesel Date: Fri, 25 Jun 2010 12:21:58 +0200 Subject: Shorten + Update --help text --- src/help.raw | 396 +++++++++++++++++++---------------------------------------- 1 file changed, 129 insertions(+), 267 deletions(-) diff --git a/src/help.raw b/src/help.raw index 0598e37..2cb4517 100644 --- a/src/help.raw +++ b/src/help.raw @@ -1,198 +1,100 @@ -Usage : " PACKAGE " [OPTIONS]... FILES... - Where a FILE is an image file or a directory. - Multiple files are supported. - Urls are supported. They must begin with http:// or ftp:// and you must - have wget installed to download the files for viewing. - Options can also be specified in the in the feh configuration file. See - man feh for more details - -h, --help display this help and exit - -v, --version output version information and exit - -V, --verbose output useful information, progress bars, etc - -q, --quiet Don't report non-fatal errors for failed loads - Verbose and quiet modes are not mutually exclusive, - the first controls informational messages, the - second only errors. - -T, --theme THEME Load options from config file with name THEME - see man feh for more info. - -_, --rcfile FILE Use FILE to parse themes and options from, - instead of the default ~/.fehrc, /etc/fehrc files. +" PACKAGE " version " VERSION " + +Usage : " PACKAGE " [options] + + This is just a short option summary. Please consult the manual for details. + +OPTIONS + -h, --help Show help and exit + -v, --version Show version information and exit + -V, --verbose Show progress bars and other extra information + -q, --quiet Hide non-fatal errors. May be used with --verbose + -T, --theme THEME Load options with name THEME + -_, --rcfile FILE Use FILE to parse themes and options from -r, --recursive Recursively expand any directories in FILE to the content of those directories. (Take it easy) - -z, --randomize When viewing multiple files in a slideshow, - randomise the file list before displaying + -z, --randomize Randomize the filelist --no-jump-on-resort Don't jump to the first image when the filelist - is resorted. - -g, --geometry STRING Limit (and don't change) the window size. Takes - an X-style geometry string like 640x480. - Note that larger images will be zoomed out to fit - but you can see them at 1:1 by clicking the zoom - button. - -f, --filelist FILE This option is similar to the playlists used by - music software. If FILE exists, it will be read - for a list of files to load, in the order they - appear. The format is a list of image filenames, - absolute or relative to the current directory, - one filename per line. - If FILE doesn't exist, it will be created from the - internal filelist at the end of a viewing session. - This is best used to store the results of complex - sorts (-Spixels for example) for later viewing. - Any changes to the internal filelist (such as - deleting a file or it being pruned for being - unloadable) will be saved to FILE when feh exits. - You can add files to filelists by specifying them - on the commandline when also specifying the list. + is resorted + -g, --geometry STRING Limit the window size to STRING, like \"640x480\" + -f, --filelist FILE Load/save images from/to the FILE filelist -|, --start-at POSITION Start at POSITION in the filelist - -p, --preload Preload images. This doesn't mean hold them in - RAM, it means run through and eliminate unloadable - images first. Otherwise they will be removed as you - flick through. - -., --scale-down Automatically scale down images too big for the - screen. Currently only works with -P + -p, --preload Remove unlaodable files from the internal filelist + before attempting to display anything + -., --scale-down Automatically scale down images to fit the screen + size -F, --full-screen Make the window fullscreen - -Z, --auto-zoom Zoom picture to screen size in fullscreen mode, - is affected by the option --stretch + -Z, --auto-zoom Zoom picture to screen size in fullscreen mode --zoom PERCENT Zooms images by a PERCENT, when in full screen mode or when window geometry is fixed. If combined with --auto-zoom, zooming will be limited to the the size. - -w, --multiwindow Disable slideshow mode. With this setting, - instead of opening multiple files in slideshow - mode, multiple windows will be opened. + -w, --multiwindow Open all files at once, one window per image -x, --borderless Create borderless windows - -d, --draw-filename Draw the filename at the top-left of the image. - -^, --title TITLE Use TITLE as the window title in slideshow mode. - -D, --slideshow-delay NUM For slideshow mode, specifies time delay (seconds, - can be a decimal) between automatically changing - slides. - --cycle-once exit feh after one loop through a slideshow - -R, --reload NUM Use this option to tell feh to reload an image - after NUM seconds. Useful for viewing webcams - via http, or even on your local machine. - -Q, --builtin Use builtin http grabber to grab remote files - instead of wget. - mechanism, useful if don't have wget. - -k, --keep-http When viewing files using http, feh normally - deletes the local copies after viewing, or, - if caching, on exit. This option prevents this - so that you get to keep the local copies. - They will be in the current working directory - with \"feh\" in the name. - --caption-path PATH Path to directory containing image captions. - This turns on caption viewing, and if captions - are found in PATH, which is relative to the - directory of each image, they are overlayed - on the displayed image. - e.g with caption path \"captions\", and viewing - image images/foo.jpg, caption will be looked for - as \"images/captions/foo.jpg.txt\" - -j, --output-dir Output directory for saved files. Really only - useful with the -k flag. - -G, --wget-timestamp When viewing http images with reload set (eg - webcams), try to only reload the image if the - remote file has changed. - -l, --list Don't display images. Analyse them and display an - 'ls' style listing. Useful in scripts hunt out - images of a certain size/resolution/type etc. - -L, --customlist FORMAT Use FORMAT as the format specifier for list - output. FORMAT is a printf-like string containing - image info specifiers. See FORMAT SPECIFIERS. - -U, --loadable Don't display images. Just print out their name - if imlib2 can successfully load them. - -u, --unloadable Don't display images. Just print out their name - if imlib2 can NOT successfully load them. - -S, --sort SORT_TYPE The file list may be sorted according to image - parameters. Allowed sort types are: name, - filename, width, height, pixels, size, format. - For sort modes other than name or filename, a - preload run will be necessary, causing a delay - proportional to the number of images in the list - -n, --reverse Reverse the sort order. Use this to invert the order - of the filelist. Eg to sort in reverse width order, - use -nSwidth - -A, --action ACTION Specify a string as an action to perform on the - image. In slideshow or multiwindow modes, the action - in list mode, or loadable|unloadable modes, the - action will be run for each file. - The action will be executed by /bin/sh. Use - format specifiers to refer to image info. See - FORMAT SPECIFIERS for examples - Eg. -A \"mv %f ~/images/%%n\" - In slideshow mode, the next image will be shown - after running the command, in multiwindow mode, - the window will be closed. - --action1 ACTION These extra action options allow you to specify - --action2 ACTION multiple additional actions which can be invoked - ... using the appropriate number key 1-9 - --action9 ACTION - --draw-actions Show the defined actions and what they do - -m, --montage Enable montage mode. Montage mode creates a new - image consisting of a grid of thumbnails of the - images specified using FILE... When montage mode - is selected, certain other options become - available. See MONTAGE MODE OPTIONS - -c, --collage Same as montage mode, but the thumbnails are - distributed randomly. You must specify width and - height or supply a background image or both - -i, --index Enable Index mode. Index mode is similar to - montage mode, and accepts the same options. It - creates an index print of thumbails, printing the - images name beneath each thumbnail. Index mode - enables certain other options, see INDEX MODE - OPTIONS - -t, --thumbnails As --index, but clicking an image will open it in - a new viewing window + -d, --draw-filename Show the filename in the image window + -^, --title TITLE Set window title (see FORMAT SPECIFIERS) + -D, --slideshow-delay NUM Set delay between automatically changing slides + --cycle-once Exit after one loop through the slideshow + -R, --reload NUM Reload images after NUM seconds + -Q, --builtin Use builtin http client instead of wget + -k, --keep-http Keep local copies when viewing HTTP/FTP files + --caption-path PATH Path to caption directory, enables caption display + -j, --output-dir With -k: Output directory for saved files + -G, --wget-timestamp Try to only reload a file if it changed. Also, + don't add \"?1234...\" timestamp to file URL + -l, --list list mode: ls-style output with image information + -L, --customlist FORMAT list mode with custom output, see FORMAT SPECIFIERS + -U, --loadable List all loadable files. No image display + -u, --unloadable List all unloadable files. No image display + -S, --sort SORT_TYPE Sort files by: + name, filename, width, height, pixels, size or format + -n, --reverse Reverse sort order + -A, --action ACTION Specify action to perform when pressing . + Executed by /bin/sh, may contain FORMAT SPECIFIERS + --action[1-9] Extra actions triggered by pressing keys <1>to <9>. + --draw-actions Show the defined actions in the image window + -m, --montage Enable montage mode + -c, --collage Montage mode with randomly distributed thumbnails + -i, --index Create an index print of all images + -t, --thumbnails Show images as clickable thumbnails --cache-thumbnails Enable thumbnail caching for thumbnail mode. Only works with thumbnails <= 256x256 pixels --thumb-redraw N Redraw thumbnail window every N images - -~, --thumb-title STRING Set window title for images opened from thumbnail mode. - Supports format specifiers, see there. - -I, --fullindex Same as index mode, but below each thumbnail you - get image name, size and dimensions + -~, --thumb-title STRING Title for windows opened from thumbnail mode + -I, --fullindex Index mode with additional image information --index-name BOOL Show/Don't show filename in index/thumbnail mode --index-size BOOL Show/Don't show filesize in index/thumbnail mode --index-dim BOOL Show/Don't show dimensions in index/thumbnail mode - --bg-tile FILE Set FILE as tiled desktop background. Feh can - use enlightenment IPC if you are running it, - or will fall back to X methods. - Feh stores the commandline necessary to restore - the background you chose in ~/.fehbg. So to have - feh-set backgrounds restored when you restart X, - add the line \"eval `cat $HOME/.fehbg`\" to your - X startup script (e.g. ~/.xsession). Note that - you only need to do this for non E window - managers + --bg-tile FILE Set FILE as tiled desktop background --bg-center FILE Set FILE as centered desktop background --bg-scale FILE Set FILE as scaled desktop background. This will fill the whole background, but the images' aspect ratio may not be preserved --bg-fill FILE Like --bg-scale, but preserves aspect ratio by - zooming the image until it fits + zooming the image until it fits. May cut off + corners --bg-seamless FILE Like --bg-tile, but with blurry corners -C, --fontpath PATH Specify an extra directory to look in for fonts, can be used multiple times to add multiple paths. -M, --menu-font FONT Use FONT for the font in menus. --menu-style FILE Use FILE as the style descriptor for menu text. -), --menu-bg BG Use BG for the background image in menus. - --menu-border INT Specify number of pixels that define the menu - background's border. Borders are not stretched - when images are scaled. + --menu-border INT Set border of menu images -B, --image-bg STYLE Set background for transparent images and the like. Accepted values: white, black, default -N, --no-menus Don't load or show any menus. -0, --reload-button B Use button B to reload the image (defaults to 0) -1, --pan-button B Use button B pan the image (hold button down, move - the mouse to move the image around. Advancesto the + the mouse to move the image around. Advances to the next image when the mouse is not moved (defaults to 1, usually the left button). -2, --zoom-button B Use button B to zoom the current image in any mode (defaults to 2, usually the middle button). - -3, --menu-button B Use CTRL+Button B to activate the menu in any + -3, --menu-button B Click button B to activate the menu in any mode. Set to 0 for any button. This option is disabled if the -N or --no-menus option is set (defaults to 3, usually the right button). - --menu-ctrl-mask Require CTRL+Button for menu activation in - any mode (default=off). + --menu-ctrl-mask Require CTRL+Button for menu activation -4, --prev-button B Use button B to switch to the previous image (defaults to 4, which usually is ). -5, --next-button B Use button B to switch to the next image @@ -205,127 +107,87 @@ Usage : " PACKAGE " [OPTIONS]... FILES... any mode (default=1). --no-blur-ctrl-mask Don't require CTRL+Button for blurring in any mode -- just use the button (default=off). - --no-xinerama Disable Xinerama support. Only useful if - you have Xinerama compiled in. - --no-screen-clip Disable window clipping based on screen - size. WARNING: with this option disabled, - image windows could become very large, making - them unmanageable in certain window managers. - --hide-pointer In full screen mode, hide the X mouse pointer. - FORMAT SPECIFIERS - %f image path/filename - %n image name - %s image size (bytes) - %p image pixel size - %w image width - %h image height - %t image format - %P prints feh - %v prints the version - %m prints the mode (slideshow, multiwindow...) - %l prints the total number of files in the filelist - %u prints the current file number - %% prints a % - \\n prints a newline - Eg. feh -A \"mv %f ~/images/%n\" * - MONTAGE MODE OPTIONS - -X, --ignore-aspect By default, the montage thumbnails will retain - their aspect ratios, while fitting in --thumb-width - and --thumb-height. This option will force them to - be the size set by --thumb-width and --thumb-height - This will prevent any whitespace in the final - montage - -s, --stretch Normally, if an image is smaller than the specified - thumbnail size, it will not be enlarged. If this - option is set, the image will be scaled up to fit - the thumbnail size. (Aspect ratio will be maintained - unless --ignore-aspect is specified) + --no-xinerama Disable Xinerama support + --no-screen-clip Do not limit window size to screen size + --hide-pointer Hide the pointer + +MONTAGE MODE OPTIONS + -X, --ignore-aspect Set thumbnail to specified width/height without + retaining aspect ratio + -s, --stretch Scale up images if they are smaller than the + specified thumbnail size -y, --thumb-width NUM Set thumbnail width in pixels -E, --thumb-height NUM Set thumbnail height in pixels - Thumbnails default to 20x20 pixels -W, --limit-width NUM Limit the width of the montage in pixels -H, --limit-height NUM Limit the height of the montage in pixels - These options can be used together (to define the - image size exactly), or separately. If only one is - specified, theother is calculated from the number - of files specified and the size of the thumbnails. - The default is to limit width to 800 pixels and - calculate the height - -b, --bg FILE|trans Use FILE as a background for your montage. With - this option specified, the size of the montage will - default to the size of FILE if no size restrictions - are specified. Alternatively, if FILE is \"trans\", - make the background transparent. - -a, --alpha NUM When drawing thumbnails onto the background, apply - them with a transparency level of NUM (0-255). + (at least one of these two must be specified) + -b, --bg FILE|trans Set montage background + -a, --alpha NUM Set thumbnail transparency level (0 .. 255) -o, --output FILE Save the created montage to FILE -O, --output-only FILE Just save the created montage to FILE - WITHOUT displaying it (use in scripts) - -e, --font FONT Use FONT to print the information under each - thumbnail. FONT should be defined in the form - fontname/size(points). eg -e myfont/12 - INDEX MODE OPTIONS + WITHOUT displaying it + -e, --font FONT Set font for thumbnail information, in the form + fontname/pointsize + +INDEX MODE OPTIONS -@, --title-font FONT Use FONT to print a title on the index, if no font is specified, a title will not be printed - SLIDESHOW KEYS - The default mode for viewing mulitple images is Slideshow mode - When viewing a slideshow, the following keys may be used: - p, P, , Goto previous slide - n, N, , Goto next slide - r, R Reload image (good for webcams) - v, V Toggle fullscreen - m, M Show popup menu - c, C Caption entry mode. If --caption-path has been - specified, then this enables caption editing. - The caption will turn yellow and be editable, - hit enter to confirm and save the caption, or - hit escape to cancel and revert the caption. - w, W Size window to current image dimensions - h, H Pause the slideshow (only useful when using - timed reloading or image changes) - z, Z Jump to a random position in the current filelist - a, A Toggle action display (--draw-actions) - d, D Toggle filename display (--draw-filename) - s, S Save current image to unique filename - f, F Save current filelist to unique filename - <, > In place editing, rotate 90 degrees right/left - Goto first slide - Goto last slide - Quit the slideshow - +, = Increase reload delay - -, _ Decrease reload delay - Remove the currently viewed file from the filelist - Delete the currently viewed file and remove it - from the filelist - x, X Close current window - q, Q Quit the slideshow - Move the image to the left - Move the image to the right - Move the image up - Move the image down - Antialias the image - Zoom in - Zoom out - Zoom to 100% - Zoom to fit the window - ,0 Run action specified by --action option - 1-9 Run action 1-9 specified by --action[1-9] options - MOUSE ACTIONS - When viewing an image, a click of mouse button 1 moves to the next image - (slideshow mode only), a drag of mouse button 1 pans the image, if the - viewable window is smaller than the image, button 2 zooms (click and drag - left->right to zoom in, right->left to zoom out, click once to restore - 1x zoom), and mouse button 3 pans. - Ctrl+button 1 blurs or sharpens the image (drag left to blur and right to - sharpen). Ctrl+button 2 rotates the image around the center point. - Button 3 activates the context-sensitive menu. Buttons can be redefined - with the -1 through -9 (or --*-button) cmdline flags. All you people - with million button mice can remove the ctrl mask with the --no-*-ctrl-mask - options. +FORMAT SPECIFIERS + %f image path/filename + %n image name + %s image size (bytes) + %p image pixel size + %w image width + %h image height + %t image format + %P " PACKAGE " + %v " PACKAGE " version + %m current mode (slideshow, multiwindow...) + %l total number of files in the filelist + %u current file number + %% % + \\n newline -See 'man feh' for more detailed information +KEYS + p, , Go to previous slide + n, , Go to next slide + r Reload image + v Toggle fullscreen + m Show menu + c Enable caption entry mode + w Resize window to current image dimensions + h Pause/Continue the slideshow + z Jump to a random position in the current filelist + a Toggle action display (--draw-actions) + d Toggle filename display (--draw-filename) + s Save current image to unique filename + f Save current filelist to unique filename + <, > In place editing, rotate 90 degrees right/left + Go to first slide + Go to last slide + Quit the slideshow + + Increase reload delay + - Decrease reload delay + Remove the currently viewed file from the filelist + Like , but also removes the file from the + filesystem. Caution: Does _not_ ask for confirmation + x Close current window + q Quit " PACKAGE " + Move the image to the left + Move the image to the right + Move the image up + Move the image down + Antialias the image + Zoom in + Zoom out + Zoom to 100% + Zoom to fit the window + , 0 Run action specified by --action option + 1-9 Run action 1-9 specified by --action[1-9] options -This program is free software see the file COPYING for licensing info. +This program is free software, see the file COPYING for licensing info. Copyright Tom Gilbert (and various contributors) 1999-2003 + +Homepage: https://derf.homelinux.org/p/feh Email bugs to -- cgit v1.2.3