diff options
author | Jim Ramsay <i.am@jimramsay.com> | 2009-10-14 01:05:49 (GMT) |
---|---|---|
committer | Jim Ramsay <i.am@jimramsay.com> | 2009-10-14 01:05:49 (GMT) |
commit | 839ea523164caecd8c779e60539b78c2a748a81f (patch) | |
tree | 0019d04f27a1a258bc7a900e3cf77b916dca6493 /doc/asciidoc/fbsetbg.txt | |
parent | 4d3aa646c1d1d1de4fdb31f938f6ea62fd5dd21e (diff) | |
parent | 8def80cec337a986b762cdbb5e2555c6da809353 (diff) | |
download | fluxbox_lack-testing/argb.zip fluxbox_lack-testing/argb.tar.bz2 |
Merge branch 'master' into argbtesting/argbargb
Conflicts:
src/FbTk/FbWindow.cc
Diffstat (limited to 'doc/asciidoc/fbsetbg.txt')
-rw-r--r-- | doc/asciidoc/fbsetbg.txt | 119 |
1 files changed, 119 insertions, 0 deletions
diff --git a/doc/asciidoc/fbsetbg.txt b/doc/asciidoc/fbsetbg.txt new file mode 100644 index 0000000..6e91329 --- /dev/null +++ b/doc/asciidoc/fbsetbg.txt | |||
@@ -0,0 +1,119 @@ | |||
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(1)*. These can be used to set a solid, | ||
55 | pattern, or gradient background texture. | ||
56 | |||
57 | *-r* 'directory':: | ||
58 | Set random wallpaper from a directory. | ||
59 | |||
60 | *-F*, *-C*, *-T*, *-A*, *-U*, *-B*, *-R*:: | ||
61 | Same as the lowercase option but without remembering. | ||
62 | |||
63 | *-l*:: | ||
64 | Set previous wallpaper. Or, if the random feature was last used, | ||
65 | set another random wallpaper from the same directory. | ||
66 | |||
67 | *-i*:: | ||
68 | Display usefull information about best wallpapersetter found. | ||
69 | |||
70 | *-p*:: | ||
71 | Display some usefull tips. | ||
72 | |||
73 | *-h*:: | ||
74 | Display a help message. | ||
75 | |||
76 | FILES | ||
77 | ----- | ||
78 | *~/.fluxbox/lastwallpaper*:: | ||
79 | In this file the wallpaper you set will be stored, for the *-l* option. | ||
80 | |||
81 | ENVIRONMENT | ||
82 | ----------- | ||
83 | *wpsetters*:: | ||
84 | Wallpapersetters to use. This can be a space-delimited list of the applications | ||
85 | to try, or just a single name. | ||
86 | |||
87 | *DISPLAY*:: | ||
88 | The display you want to set the wallpaper on. | ||
89 | |||
90 | EXAMPLES | ||
91 | -------- | ||
92 | To use *feh(1)* as wallpapersetter and set *wallpapper.jpg* from the current | ||
93 | directory as wallpaper. | ||
94 | |||
95 | $ wpsetters=feh fbsetbg wallpaper.jpg | ||
96 | |||
97 | Recall the last set wallpaper on display *:0.0* with the stored options. | ||
98 | |||
99 | $ DISPLAY=:0.0 fbsetbg -l | ||
100 | |||
101 | ONLINE DOCUMENTATION | ||
102 | -------------------- | ||
103 | Much more extensive documentation for *fbsetbg(1)* is provided on::: | ||
104 | http://www.xs4all.nl/~hanb/software/fbsetbg/fbsetbg.html | ||
105 | |||
106 | BUGS | ||
107 | ---- | ||
108 | *fbsetbg(1)* is not foolproof. | ||
109 | |||
110 | AUTHORS | ||
111 | ------- | ||
112 | The author of fbsetbg is Han Boetes <han at fluxbox.org> | ||
113 | |||
114 | This manpage was converted to asciidoc format by Jim Ramsay <i.am at | ||
115 | jimramsay.com> for fluxbox-1.1.2 | ||
116 | |||
117 | SEE ALSO | ||
118 | -------- | ||
119 | fluxbox(1) fbsetroot(1) | ||