summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Friesel <derf@derf.homelinux.org>2010-03-30 11:35:39 +0200
committerDaniel Friesel <derf@derf.homelinux.org>2010-03-30 11:35:39 +0200
commit8c48a86f4dab20aac798bb2407db7dd548893e59 (patch)
tree3a605879cf8811023366a76b2e94b4b2f480f48a
parent78c501656cf1ceb98675fe425cfc4cb9313dee00 (diff)
More detailed --bg-* documentation
-rw-r--r--man/feh.125
-rw-r--r--src/options.c15
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"