Moved fbsetbg(1) to asciidoc format

2 files changed, 118 insertions, 1 deletions

diff --git a/doc/asciidoc/Makefile b/doc/asciidoc/Makefile
index 70db7ef..e169230 100644
--- a/doc/asciidoc/Makefile
+++ b/doc/asciidoc/Makefile
@@ -2,7 +2,7 @@
 # create manpages from the asciidoc files
 #
 
-SRC1 = fluxbox.txt fluxbox-remote.txt fbrun.txt
+SRC1 = fluxbox.txt fluxbox-remote.txt fbrun.txt fbsetbg.txt
 SRC5 = fluxbox-keys.txt fluxbox-apps.txt fluxbox-style.txt fluxbox-menu.txt
 
 MAN = $(SRC1:.txt=.1.in) $(SRC5:.txt=.5.in)
diff --git a/doc/asciidoc/fbsetbg.txt b/doc/asciidoc/fbsetbg.txt
new file mode 100644
index 0000000..03626b2
--- /dev/null
+++ b/doc/asciidoc/fbsetbg.txt
@@ -0,0 +1,117 @@
+fbsetbg(1)
+==========
+Jim Ramsay <i.am@jimramsay.com>
+v1.1.2, 18 February 2009
+:man source:   fbsetbg.txt
+:man version:  {revision}
+:man manual:   Fluxbox Manual  
+
+NAME
+----
+fbsetbg - Set a background wallpaper or pattern
+
+SYNOPSIS
+--------
+*fbsetbg* [*-uU* 'wallpapersetter'] [*-fFcCtTaA*] 'wallpaper'
+
+*fbsetbg* [*-uU* 'wallpapersetter'] *-rR* 'path'
+
+*fbsetbg* *-bB* 'fbsetrootoptions...'
+
+*fbsetbg* [-*l*|*h*|*i*|*p*]
+
+DESCRIPTION
+-----------
+*fbsetbg(1)* is a wrapper that tries to find a suitable background-setting app
+and then tries to set the wallpaper using that app. You don't have to configure
+fbsetbg. It just uses the first app it can find.
+
+Furthermore it supports remembering the last set wallpaper so you don't have to
+edit the style or init-file to change the wallpaper.
+
+It aims to provide clear error messages in a window that make debugging problems
+easy.
+
+OPTIONS
+-------
+*-f* 'file'::
+Set fullscreen wallpaper.
+
+*-c* 'file'::
+Set centered wallpaper.
+
+*-t* 'file'::
+Set tiled wallpaper.
+
+*-a* 'file'::
+Set maximized wallpaper, preserving aspect (if your bgsetter
+doesn't support this option fbsetbg falls back to *-f*).
+
+*-u* 'wallpapersetter'::
+Use specified wallpapersetter, use no argument to forget.
+
+*-b* 'fbsetrootoptions'::
+Forward the options to fbsetroot.
+
+*-r* 'directory'::
+Set random wallpaper from a directory.
+
+*-F*, *-C*, *-T*, *-A*, *-U*, *-B*, *-R*::
+Same as the lowercase option but without remembering.
+
+*-l*::
+Set previous wallpaper. Or, if the random feature was last used,
+set another random wallpaper from the same directory.
+
+*-i*::
+Display usefull information about best wallpapersetter found.
+
+*-p*::
+Display some usefull tips.
+
+*-h*::
+Display a help message.
+
+FILES
+-----
+*~/.fluxbox/lastwallpaper*::
+In this file the wallpaper you set will be stored, for the *-l* option.
+
+ENVIRONMENT
+-----------
+*wpsetters*::
+Wallpapersetters to use. This can be a space-delimited list of the applications
+to try, or just a single name.
+
+*DISPLAY*::
+The display you want to set the wallpaper on.
+
+EXAMPLES
+--------
+To use *feh(1)* as wallpapersetter and set *wallpapper.jpg* from the current
+directory as wallpaper.
+
+        $ wpsetters=feh fbsetbg wallpaper.jpg
+
+Recall the last set wallpaper on display *:0.0* with the stored options.
+
+        $ DISPLAY=:0.0 fbsetbg -l
+
+SEE ALSO
+--------
+fluxbox(1), fbsetroot(1)
+
+ONLINE DOCUMENTATION
+--------------------
+Much more extensive documentation for *fbsetbg(1)* is provided on:::
+http://www.xs4all.nl/~hanb/software/fbsetbg/fbsetbg.html
+
+BUGS
+----
+*fbsetbg(1)* is not foolproof.
+
+AUTHORS
+-------
+The author of fbsetbg is Han Boetes <han@fluxbox.org>
+
+This manpage was updated to asciidoc format by Jim Ramsay <i.am@jimramsay.com>