diff options
Diffstat (limited to 'doc/asciidoc')
-rw-r--r-- | doc/asciidoc/Makefile | 2 | ||||
-rw-r--r-- | doc/asciidoc/fbsetbg.txt | 117 |
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 @@ | |||
2 | # create manpages from the asciidoc files | 2 | # create manpages from the asciidoc files |
3 | # | 3 | # |
4 | 4 | ||
5 | SRC1 = fluxbox.txt fluxbox-remote.txt fbrun.txt | 5 | SRC1 = fluxbox.txt fluxbox-remote.txt fbrun.txt fbsetbg.txt |
6 | SRC5 = fluxbox-keys.txt fluxbox-apps.txt fluxbox-style.txt fluxbox-menu.txt | 6 | SRC5 = fluxbox-keys.txt fluxbox-apps.txt fluxbox-style.txt fluxbox-menu.txt |
7 | 7 | ||
8 | MAN = $(SRC1:.txt=.1.in) $(SRC5:.txt=.5.in) | 8 | 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 @@ | |||
1 | fbsetbg(1) | ||
2 | ========== | ||
3 | Jim Ramsay <i.am@jimramsay.com> | ||
4 | v1.1.2, 18 February 2009 | ||
5 | :man source: fbsetbg.txt | ||
6 | :man version: {revision} | ||
7 | :man manual: Fluxbox Manual | ||
8 | |||
9 | NAME | ||
10 | ---- | ||
11 | fbsetbg - Set a background wallpaper or pattern | ||
12 | |||
13 | SYNOPSIS | ||
14 | -------- | ||
15 | *fbsetbg* [*-uU* 'wallpapersetter'] [*-fFcCtTaA*] 'wallpaper' | ||
16 | |||
17 | *fbsetbg* [*-uU* 'wallpapersetter'] *-rR* 'path' | ||
18 | |||
19 | *fbsetbg* *-bB* 'fbsetrootoptions...' | ||
20 | |||
21 | *fbsetbg* [-*l*|*h*|*i*|*p*] | ||
22 | |||
23 | DESCRIPTION | ||
24 | ----------- | ||
25 | *fbsetbg(1)* is a wrapper that tries to find a suitable background-setting app | ||
26 | and then tries to set the wallpaper using that app. You don't have to configure | ||
27 | fbsetbg. It just uses the first app it can find. | ||
28 | |||
29 | Furthermore it supports remembering the last set wallpaper so you don't have to | ||
30 | edit the style or init-file to change the wallpaper. | ||
31 | |||
32 | It aims to provide clear error messages in a window that make debugging problems | ||
33 | easy. | ||
34 | |||
35 | OPTIONS | ||
36 | ------- | ||
37 | *-f* 'file':: | ||
38 | Set fullscreen wallpaper. | ||
39 | |||
40 | *-c* 'file':: | ||
41 | Set centered wallpaper. | ||
42 | |||
43 | *-t* 'file':: | ||
44 | Set tiled wallpaper. | ||
45 | |||
46 | *-a* 'file':: | ||
47 | Set maximized wallpaper, preserving aspect (if your bgsetter | ||
48 | doesn't support this option fbsetbg falls back to *-f*). | ||
49 | |||
50 | *-u* 'wallpapersetter':: | ||
51 | Use specified wallpapersetter, use no argument to forget. | ||
52 | |||
53 | *-b* 'fbsetrootoptions':: | ||
54 | Forward the options to fbsetroot. | ||
55 | |||
56 | *-r* 'directory':: | ||
57 | Set random wallpaper from a directory. | ||
58 | |||
59 | *-F*, *-C*, *-T*, *-A*, *-U*, *-B*, *-R*:: | ||
60 | Same as the lowercase option but without remembering. | ||
61 | |||
62 | *-l*:: | ||
63 | Set previous wallpaper. Or, if the random feature was last used, | ||
64 | set another random wallpaper from the same directory. | ||
65 | |||
66 | *-i*:: | ||
67 | Display usefull information about best wallpapersetter found. | ||
68 | |||
69 | *-p*:: | ||
70 | Display some usefull tips. | ||
71 | |||
72 | *-h*:: | ||
73 | Display a help message. | ||
74 | |||
75 | FILES | ||
76 | ----- | ||
77 | *~/.fluxbox/lastwallpaper*:: | ||
78 | In this file the wallpaper you set will be stored, for the *-l* option. | ||
79 | |||
80 | ENVIRONMENT | ||
81 | ----------- | ||
82 | *wpsetters*:: | ||
83 | Wallpapersetters to use. This can be a space-delimited list of the applications | ||
84 | to try, or just a single name. | ||
85 | |||
86 | *DISPLAY*:: | ||
87 | The display you want to set the wallpaper on. | ||
88 | |||
89 | EXAMPLES | ||
90 | -------- | ||
91 | To use *feh(1)* as wallpapersetter and set *wallpapper.jpg* from the current | ||
92 | directory as wallpaper. | ||
93 | |||
94 | $ wpsetters=feh fbsetbg wallpaper.jpg | ||
95 | |||
96 | Recall the last set wallpaper on display *:0.0* with the stored options. | ||
97 | |||
98 | $ DISPLAY=:0.0 fbsetbg -l | ||
99 | |||
100 | SEE ALSO | ||
101 | -------- | ||
102 | fluxbox(1), fbsetroot(1) | ||
103 | |||
104 | ONLINE DOCUMENTATION | ||
105 | -------------------- | ||
106 | Much more extensive documentation for *fbsetbg(1)* is provided on::: | ||
107 | http://www.xs4all.nl/~hanb/software/fbsetbg/fbsetbg.html | ||
108 | |||
109 | BUGS | ||
110 | ---- | ||
111 | *fbsetbg(1)* is not foolproof. | ||
112 | |||
113 | AUTHORS | ||
114 | ------- | ||
115 | The author of fbsetbg is Han Boetes <han@fluxbox.org> | ||
116 | |||
117 | This manpage was updated to asciidoc format by Jim Ramsay <i.am@jimramsay.com> | ||