From 8c48a86f4dab20aac798bb2407db7dd548893e59 Mon Sep 17 00:00:00 2001 From: Daniel Friesel Date: Tue, 30 Mar 2010 11:35:39 +0200 Subject: More detailed --bg-* documentation --- man/feh.1 | 25 +++++++++++++++---------- src/options.c | 15 +++++++++------ 2 files changed, 24 insertions(+), 16 deletions(-) diff --git a/man/feh.1 b/man/feh.1 index a4ae7b1..353df60 100644 --- a/man/feh.1 +++ b/man/feh.1 @@ -285,24 +285,29 @@ Show/Don't show filesize in thumbnail/index mode. Show/Don't show image dimensions in thumbnail/index mode. .TP 5 .B --bg-tile FILE +Set FILE as your desktop background, tiled if neccessary. +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 "`cat $HOME/.fehbg`" to your X startup script (e.g. ~/.xsession). +Note that you only need to do this for non E window managers. .TP 5 .B --bg-center FILE +Set FILE as centered desktop background .TP 5 .B --bg-scale FILE +Set FILE as scaled desktop background. +This will fill the whole background with FILE, but its aspect ratio will not +be preserved. .TP 5 .B --bg-fill FILE +Like --bg-scale, but preserves aspect ratio by zooming the image until it +fits. Either a horizontal or a vertical part of the image will be cut off. .TP 5 .B --bg-seamless FILE -Set your desktop background to FILE. 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 "`cat $HOME/.fehbg`" to your -X startup script (e.g. ~/.xsession). Note that -you only need to do this for non E window -managers. +Like --bg-tile, but with blurry corners so that it is (in some cases ;-)) +less obvious that the image is too small for the screen. .TP 5 .B -M, --menu-font FONT Use FONT for the font in menus. diff --git a/src/options.c b/src/options.c index fc62971..9afa33a 100644 --- a/src/options.c +++ b/src/options.c @@ -967,11 +967,7 @@ void show_usage(void) " --index-name BOOL Show/Don't show filename in index/thumbnail mode\n" " --index-size BOOL Show/Don't show filesize in index/thumbnail mode\n" " --index-dim BOOL Show/Don't show dimensions in index/thumbnail mode\n" -" --bg-tile FILE\n" -" --bg-center FILE\n" -" --bg-scale FILE\n" -" --bg-fill FILE\n" -" --bg-seamless FILE Set your desktop background to FILE. Feh can\n" +" --bg-tile FILE Set FILE as tiled desktop background. Feh can\n" " use enlightenment IPC if you are running it,\n" " or will fall back to X methods.\n" " Feh stores the commandline necessary to restore\n" @@ -980,7 +976,14 @@ void show_usage(void) " add the line \"eval `cat $HOME/.fehbg`\" to your\n" " X startup script (e.g. ~/.xsession). Note that\n" " you only need to do this for non E window\n" -" managers.\n" +" managers\n" +" --bg-center FILE Set FILE as centered desktop background\n" +" --bg-scale FILE Set FILE as scaled desktop background. This will\n" +" fill the whole background, but the images' aspect\n" +" ratio may not be preserved\n" +" --bg-fill FILE Like --bg-scale, but preserves aspect ratio by\n" +" zooming the image until it fits\n" +" --bg-seamless FILE Like --bg-tile, but with blurry corners\n" " -C, --fontpath PATH Specify an extra directory to look in for fonts,\n" " can be used multiple times to add multiple paths.\n" " -M, --menu-font FONT Use FONT for the font in menus.\n" -- cgit v1.2.3