More detailed --bg-* documentation

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.

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"