diff options
author | Jim Ramsay <i.am@jimramsay.com> | 2009-02-18 16:36:04 (GMT) |
---|---|---|
committer | Jim Ramsay <i.am@jimramsay.com> | 2009-05-26 20:16:07 (GMT) |
commit | 4b4fa5bdeb1b987e621fb964c3da7a90a241d2d8 (patch) | |
tree | 86602f1483d282b7130d6a593a9411ba3ef6c9ef | |
parent | 0ac042c1ce65cf65ef965f8fc6be80f8a44a9d4b (diff) | |
download | fluxbox-4b4fa5bdeb1b987e621fb964c3da7a90a241d2d8.zip fluxbox-4b4fa5bdeb1b987e621fb964c3da7a90a241d2d8.tar.bz2 |
Moved fbsetbg(1) to asciidoc format
-rw-r--r-- | doc/Makefile.am | 13 | ||||
-rw-r--r-- | doc/asciidoc/Makefile | 2 | ||||
-rw-r--r-- | doc/asciidoc/fbsetbg.txt | 117 | ||||
-rw-r--r-- | doc/fbsetbg.1 | 118 | ||||
-rw-r--r-- | doc/fbsetbg.1.in | 333 |
5 files changed, 459 insertions, 124 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am index da18c58..b4ffd9f 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am | |||
@@ -2,12 +2,15 @@ | |||
2 | # Makefile.am for fluxbox/doc | 2 | # Makefile.am for fluxbox/doc |
3 | 3 | ||
4 | SUBDIRS = ru | 4 | SUBDIRS = ru |
5 | CLEANFILES = fluxbox.1 fbrun.1 fluxbox-apps.5 fluxbox-keys.5 fluxbox-menu.5 fluxbox-remote.1 fluxbox-style.5 | 5 | CLEANFILES = fluxbox.1 fbrun.1 fbsetbg.1 fluxbox-apps.5 \ |
6 | fluxbox-keys.5 fluxbox-menu.5 fluxbox-remote.1 fluxbox-style.5 | ||
6 | MAINTAINERCLEANFILES = Makefile.in | 7 | MAINTAINERCLEANFILES = Makefile.in |
7 | man_MANS = fbsetroot.1 fbrun.1 fbsetbg.1 startfluxbox.1 \ | 8 | man_MANS = fluxbox.1 fbrun.1 fbsetbg.1 fluxbox-apps.5 \ |
8 | fluxbox.1 fluxbox-apps.5 fluxbox-keys.5 fluxbox-menu.5 fluxbox-remote.1 fluxbox-style.5 | 9 | fluxbox-keys.5 fluxbox-menu.5 fluxbox-remote.1 fluxbox-style.5 \ |
9 | EXTRA_DIST=fbsetroot.1 fbsetbg.1 startfluxbox.1 CODESTYLE \ | 10 | fbsetroot.1 startfluxbox.1 |
10 | fluxbox.1.in fbrun.1.in fluxbox-apps.5.in fluxbox-keys.5.in fluxbox-menu.5.in fluxbox-remote.1.in fluxbox-style.5.in | 11 | EXTRA_DIST=fbsetroot.1 startfluxbox.1 CODESTYLE \ |
12 | fluxbox.1.in fbrun.1.in fbsetbg.1.in fluxbox-apps.5.in \ | ||
13 | fluxbox-keys.5.in fluxbox-menu.5.in fluxbox-remote.1.in fluxbox-style.5.in | ||
11 | distclean-local: | 14 | distclean-local: |
12 | rm -f *\~ | 15 | rm -f *\~ |
13 | 16 | ||
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> | ||
diff --git a/doc/fbsetbg.1 b/doc/fbsetbg.1 deleted file mode 100644 index 2f83282..0000000 --- a/doc/fbsetbg.1 +++ /dev/null | |||
@@ -1,118 +0,0 @@ | |||
1 | .\" $Id$ | ||
2 | .\" | ||
3 | .\" Copyright (c) 2004, Han Boetes <han@fluxbox.org> | ||
4 | .\" | ||
5 | .\" Permission to use, copy, modify, and distribute this documentation for | ||
6 | .\" any purpose with or without fee is hereby granted, provided that the | ||
7 | .\" above copyright notice and this permission notice appear in all copies. | ||
8 | .\" | ||
9 | .\" THE DOCUMENTATION IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL | ||
10 | .\" WARRANTIES WITH REGARD TO THIS DOCUMENTATION INCLUDING ALL IMPLIED | ||
11 | .\" WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE | ||
12 | .\" AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL | ||
13 | .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR | ||
14 | .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER | ||
15 | .\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR | ||
16 | .\" PERFORMANCE OF THIS DOCUMENTATION | ||
17 | .\" | ||
18 | .Dd May 4, 2004 | ||
19 | .Dt FBSETBG 1 | ||
20 | .Os | ||
21 | .Sh NAME | ||
22 | .Nm fbsetbg | ||
23 | .Nd "set a background/wallpaper" | ||
24 | .Sh SYNOPSIS | ||
25 | .Nm fbsetbg | ||
26 | .Bk -words | ||
27 | .Op Fl fctaFCTA Ar wallpaper | ||
28 | .Op Fl uU Ar wallpapersetter | ||
29 | .Op Fl bB Ar fbsetrootoptions ... | ||
30 | .Op Fl rR Ar path | ||
31 | .Op Fl l | ||
32 | .Ek | ||
33 | .Sh DESCRIPTION | ||
34 | .Nm | ||
35 | is a wrapper that tries to find a suitable background-setting app and | ||
36 | then tries to set the wallpaper using that app. You don't have to | ||
37 | configure fbsetbg. It just uses the first app it can find. | ||
38 | .Pp | ||
39 | Furthermore it supports remembering the last set wallpaper so you don't | ||
40 | have to edit the style or init-file to change the wallpaper. | ||
41 | .Pp | ||
42 | It aims to provide clear error messages in a window that make debugging | ||
43 | problems easy. | ||
44 | .Sh OPTIONS | ||
45 | .Bl -tag -width Ds | ||
46 | .It Fl f Ar file | ||
47 | Set fullscreen wallpaper. | ||
48 | .It Fl c Ar file | ||
49 | Set centered wallpaper. | ||
50 | .It Fl t Ar file | ||
51 | Set tiled wallpaper. | ||
52 | .It Fl a Ar file | ||
53 | Set maximized wallpaper, preserving aspect (if your bgsetter doesn't | ||
54 | support this option fbsetbg falls back to | ||
55 | .Fl f | ||
56 | ). | ||
57 | .It Fl u Ar wallpapersetter | ||
58 | Use specified wallpapersetter, use no argument to forget. | ||
59 | .It Fl b Ar fbsetrootoptions | ||
60 | Forward the options to fbsetroot. | ||
61 | .It Fl r Ar directory | ||
62 | Set random wallpaper from a directory. | ||
63 | .It Fl F , C , T , A , U , B , R | ||
64 | Same as the uncapsed option but without remembering. | ||
65 | .It Fl l | ||
66 | Set previous wallpaper. Or, if the random feature was last used, set | ||
67 | another random wallpaper from the same directory. | ||
68 | .It Fl i | ||
69 | Display usefull information about best wallpapersetter found. | ||
70 | .It Fl p | ||
71 | Display some usefull tips. | ||
72 | .It Fl h | ||
73 | Display a help message. | ||
74 | .El | ||
75 | .Sh FILES | ||
76 | .Bl -tag -width "~/.fluxbox/lastwallpaper" -compact | ||
77 | .It Pa ~/.fluxbox/lastwallpaper | ||
78 | .El | ||
79 | In this file the wallpaper you set will be stored, for the | ||
80 | .Fl l | ||
81 | option. | ||
82 | .Sh ENVIRONMENT VARIABLES | ||
83 | .Pp fbsetbg supports the following environmental variables: | ||
84 | .Ar wpsetters | ||
85 | Wallpapersetters to use. | ||
86 | .Pp | ||
87 | .Ar DISPLAY | ||
88 | The display you want to set the wallpaper on. | ||
89 | .Sh EXAMPLES | ||
90 | .Pp | ||
91 | To use | ||
92 | .Ar feh | ||
93 | as wallpapersetter and set | ||
94 | .Ar wallpapper.jpg | ||
95 | from the current directory as wallpaper. | ||
96 | .Bd -literal -offset indent | ||
97 | $ wpsetters=feh fbsetbg wallpaper.jpg | ||
98 | .Ed | ||
99 | .Pp | ||
100 | Recall the last set wallpaper on display | ||
101 | .Ar :0.0 | ||
102 | with the stored options. | ||
103 | .Bd -literal -offset indent | ||
104 | $ DISPLAY=:0.0 fbsetbg -l | ||
105 | .Ed | ||
106 | .Sh SEE ALSO | ||
107 | .Xr fbsetroot 1 , | ||
108 | .Xr fluxbox 1 | ||
109 | .Sh ONLINE DOCUMENTATION: | ||
110 | Much more extensive documentation for | ||
111 | .Nm | ||
112 | is provided on: | ||
113 | http://www.xs4all.nl/~hanb/software/fbsetbg/fbsetbg.html | ||
114 | .Sh BUGS | ||
115 | .Nm | ||
116 | is not foolproof. | ||
117 | .Sh AUTHOR | ||
118 | The author of fbsetbg is Han Boetes <han@fluxbox.org> | ||
diff --git a/doc/fbsetbg.1.in b/doc/fbsetbg.1.in new file mode 100644 index 0000000..45505a8 --- /dev/null +++ b/doc/fbsetbg.1.in | |||
@@ -0,0 +1,333 @@ | |||
1 | .\" Title: fbsetbg | ||
2 | .\" Author: [see the "AUTHORS" section] | ||
3 | .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> | ||
4 | .\" Date: 02/18/2009 | ||
5 | .\" Manual: Fluxbox Manual | ||
6 | .\" Source: fbsetbg.txt 1.1.2 | ||
7 | .\" Language: English | ||
8 | .\" | ||
9 | .TH "FBSETBG" "1" "02/18/2009" "fbsetbg\&.txt 1\&.1\&.2" "Fluxbox Manual" | ||
10 | .\" ----------------------------------------------------------------- | ||
11 | .\" * (re)Define some macros | ||
12 | .\" ----------------------------------------------------------------- | ||
13 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
14 | .\" toupper - uppercase a string (locale-aware) | ||
15 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
16 | .de toupper | ||
17 | .tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ | ||
18 | \\$* | ||
19 | .tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz | ||
20 | .. | ||
21 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
22 | .\" SH-xref - format a cross-reference to an SH section | ||
23 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
24 | .de SH-xref | ||
25 | .ie n \{\ | ||
26 | .\} | ||
27 | .toupper \\$* | ||
28 | .el \{\ | ||
29 | \\$* | ||
30 | .\} | ||
31 | .. | ||
32 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
33 | .\" SH - level-one heading that works better for non-TTY output | ||
34 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
35 | .de1 SH | ||
36 | .\" put an extra blank line of space above the head in non-TTY output | ||
37 | .if t \{\ | ||
38 | .sp 1 | ||
39 | .\} | ||
40 | .sp \\n[PD]u | ||
41 | .nr an-level 1 | ||
42 | .set-an-margin | ||
43 | .nr an-prevailing-indent \\n[IN] | ||
44 | .fi | ||
45 | .in \\n[an-margin]u | ||
46 | .ti 0 | ||
47 | .HTML-TAG ".NH \\n[an-level]" | ||
48 | .it 1 an-trap | ||
49 | .nr an-no-space-flag 1 | ||
50 | .nr an-break-flag 1 | ||
51 | \." make the size of the head bigger | ||
52 | .ps +3 | ||
53 | .ft B | ||
54 | .ne (2v + 1u) | ||
55 | .ie n \{\ | ||
56 | .\" if n (TTY output), use uppercase | ||
57 | .toupper \\$* | ||
58 | .\} | ||
59 | .el \{\ | ||
60 | .nr an-break-flag 0 | ||
61 | .\" if not n (not TTY), use normal case (not uppercase) | ||
62 | \\$1 | ||
63 | .in \\n[an-margin]u | ||
64 | .ti 0 | ||
65 | .\" if not n (not TTY), put a border/line under subheading | ||
66 | .sp -.6 | ||
67 | \l'\n(.lu' | ||
68 | .\} | ||
69 | .. | ||
70 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
71 | .\" SS - level-two heading that works better for non-TTY output | ||
72 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
73 | .de1 SS | ||
74 | .sp \\n[PD]u | ||
75 | .nr an-level 1 | ||
76 | .set-an-margin | ||
77 | .nr an-prevailing-indent \\n[IN] | ||
78 | .fi | ||
79 | .in \\n[IN]u | ||
80 | .ti \\n[SN]u | ||
81 | .it 1 an-trap | ||
82 | .nr an-no-space-flag 1 | ||
83 | .nr an-break-flag 1 | ||
84 | .ps \\n[PS-SS]u | ||
85 | \." make the size of the head bigger | ||
86 | .ps +2 | ||
87 | .ft B | ||
88 | .ne (2v + 1u) | ||
89 | .if \\n[.$] \&\\$* | ||
90 | .. | ||
91 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
92 | .\" BB/BE - put background/screen (filled box) around block of text | ||
93 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
94 | .de BB | ||
95 | .if t \{\ | ||
96 | .sp -.5 | ||
97 | .br | ||
98 | .in +2n | ||
99 | .ll -2n | ||
100 | .gcolor red | ||
101 | .di BX | ||
102 | .\} | ||
103 | .. | ||
104 | .de EB | ||
105 | .if t \{\ | ||
106 | .if "\\$2"adjust-for-leading-newline" \{\ | ||
107 | .sp -1 | ||
108 | .\} | ||
109 | .br | ||
110 | .di | ||
111 | .in | ||
112 | .ll | ||
113 | .gcolor | ||
114 | .nr BW \\n(.lu-\\n(.i | ||
115 | .nr BH \\n(dn+.5v | ||
116 | .ne \\n(BHu+.5v | ||
117 | .ie "\\$2"adjust-for-leading-newline" \{\ | ||
118 | \M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] | ||
119 | .\} | ||
120 | .el \{\ | ||
121 | \M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] | ||
122 | .\} | ||
123 | .in 0 | ||
124 | .sp -.5v | ||
125 | .nf | ||
126 | .BX | ||
127 | .in | ||
128 | .sp .5v | ||
129 | .fi | ||
130 | .\} | ||
131 | .. | ||
132 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
133 | .\" BM/EM - put colored marker in margin next to block of text | ||
134 | .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
135 | .de BM | ||
136 | .if t \{\ | ||
137 | .br | ||
138 | .ll -2n | ||
139 | .gcolor red | ||
140 | .di BX | ||
141 | .\} | ||
142 | .. | ||
143 | .de EM | ||
144 | .if t \{\ | ||
145 | .br | ||
146 | .di | ||
147 | .ll | ||
148 | .gcolor | ||
149 | .nr BH \\n(dn | ||
150 | .ne \\n(BHu | ||
151 | \M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] | ||
152 | .in 0 | ||
153 | .nf | ||
154 | .BX | ||
155 | .in | ||
156 | .fi | ||
157 | .\} | ||
158 | .. | ||
159 | .\" ----------------------------------------------------------------- | ||
160 | .\" * set default formatting | ||
161 | .\" ----------------------------------------------------------------- | ||
162 | .\" disable hyphenation | ||
163 | .nh | ||
164 | .\" disable justification (adjust text to left margin only) | ||
165 | .ad l | ||
166 | .\" ----------------------------------------------------------------- | ||
167 | .\" * MAIN CONTENT STARTS HERE * | ||
168 | .\" ----------------------------------------------------------------- | ||
169 | .SH "Name" | ||
170 | fbsetbg \- Set a background wallpaper or pattern | ||
171 | .SH "Synopsis" | ||
172 | .sp | ||
173 | \fBfbsetbg\fR [\fB\-uU\fR \fIwallpapersetter\fR] [\fB\-fFcCtTaA\fR] \fIwallpaper\fR | ||
174 | .sp | ||
175 | \fBfbsetbg\fR [\fB\-uU\fR \fIwallpapersetter\fR] \fB\-rR\fR \fIpath\fR | ||
176 | .sp | ||
177 | \fBfbsetbg\fR \fB\-bB\fR \fIfbsetrootoptions\&...\fR | ||
178 | .sp | ||
179 | \fBfbsetbg\fR [\-\fBl\fR|\fBh\fR|\fBi\fR|\fBp\fR] | ||
180 | .SH "DESCRIPTION" | ||
181 | .sp | ||
182 | \fBfbsetbg(1)\fR 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\&. | ||
183 | .sp | ||
184 | Furthermore it supports remembering the last set wallpaper so you don\'t have to edit the style or init\-file to change the wallpaper\&. | ||
185 | .sp | ||
186 | It aims to provide clear error messages in a window that make debugging problems easy\&. | ||
187 | .SH "OPTIONS" | ||
188 | .PP | ||
189 | \fB\-f\fR \fIfile\fR | ||
190 | .RS 4 | ||
191 | Set fullscreen wallpaper\&. | ||
192 | .RE | ||
193 | .PP | ||
194 | \fB\-c\fR \fIfile\fR | ||
195 | .RS 4 | ||
196 | Set centered wallpaper\&. | ||
197 | .RE | ||
198 | .PP | ||
199 | \fB\-t\fR \fIfile\fR | ||
200 | .RS 4 | ||
201 | Set tiled wallpaper\&. | ||
202 | .RE | ||
203 | .PP | ||
204 | \fB\-a\fR \fIfile\fR | ||
205 | .RS 4 | ||
206 | Set maximized wallpaper, preserving aspect (if your bgsetter doesn\'t support this option fbsetbg falls back to | ||
207 | \fB\-f\fR)\&. | ||
208 | .RE | ||
209 | .PP | ||
210 | \fB\-u\fR \fIwallpapersetter\fR | ||
211 | .RS 4 | ||
212 | Use specified wallpapersetter, use no argument to forget\&. | ||
213 | .RE | ||
214 | .PP | ||
215 | \fB\-b\fR \fIfbsetrootoptions\fR | ||
216 | .RS 4 | ||
217 | Forward the options to fbsetroot\&. | ||
218 | .RE | ||
219 | .PP | ||
220 | \fB\-r\fR \fIdirectory\fR | ||
221 | .RS 4 | ||
222 | Set random wallpaper from a directory\&. | ||
223 | .RE | ||
224 | .PP | ||
225 | \fB\-F\fR, \fB\-C\fR, \fB\-T\fR, \fB\-A\fR, \fB\-U\fR, \fB\-B\fR, \fB\-R\fR | ||
226 | .RS 4 | ||
227 | Same as the lowercase option but without remembering\&. | ||
228 | .RE | ||
229 | .PP | ||
230 | \fB\-l\fR | ||
231 | .RS 4 | ||
232 | Set previous wallpaper\&. Or, if the random feature was last used, set another random wallpaper from the same directory\&. | ||
233 | .RE | ||
234 | .PP | ||
235 | \fB\-i\fR | ||
236 | .RS 4 | ||
237 | Display usefull information about best wallpapersetter found\&. | ||
238 | .RE | ||
239 | .PP | ||
240 | \fB\-p\fR | ||
241 | .RS 4 | ||
242 | Display some usefull tips\&. | ||
243 | .RE | ||
244 | .PP | ||
245 | \fB\-h\fR | ||
246 | .RS 4 | ||
247 | Display a help message\&. | ||
248 | .RE | ||
249 | .SH "FILES" | ||
250 | .PP | ||
251 | \fB~/\&.fluxbox/lastwallpaper\fR | ||
252 | .RS 4 | ||
253 | In this file the wallpaper you set will be stored, for the | ||
254 | \fB\-l\fR | ||
255 | option\&. | ||
256 | .RE | ||
257 | .SH "ENVIRONMENT" | ||
258 | .PP | ||
259 | \fBwpsetters\fR | ||
260 | .RS 4 | ||
261 | Wallpapersetters to use\&. This can be a space\-delimited list of the applications to try, or just a single name\&. | ||
262 | .RE | ||
263 | .PP | ||
264 | \fBDISPLAY\fR | ||
265 | .RS 4 | ||
266 | The display you want to set the wallpaper on\&. | ||
267 | .RE | ||
268 | .SH "EXAMPLES" | ||
269 | .sp | ||
270 | To use \fBfeh(1)\fR as wallpapersetter and set \fBwallpapper\&.jpg\fR from the current directory as wallpaper\&. | ||
271 | .sp | ||
272 | .if n \{\ | ||
273 | .RS 4 | ||
274 | .\} | ||
275 | .fam C | ||
276 | .ps -1 | ||
277 | .nf | ||
278 | .BB lightgray | ||
279 | $ wpsetters=feh fbsetbg wallpaper\&.jpg | ||
280 | .EB lightgray | ||
281 | .fi | ||
282 | .fam | ||
283 | .ps +1 | ||
284 | .if n \{\ | ||
285 | .RE | ||
286 | .\} | ||
287 | .sp | ||
288 | Recall the last set wallpaper on display \fB:0\&.0\fR with the stored options\&. | ||
289 | .sp | ||
290 | .if n \{\ | ||
291 | .RS 4 | ||
292 | .\} | ||
293 | .fam C | ||
294 | .ps -1 | ||
295 | .nf | ||
296 | .BB lightgray | ||
297 | $ DISPLAY=:0\&.0 fbsetbg \-l | ||
298 | .EB lightgray | ||
299 | .fi | ||
300 | .fam | ||
301 | .ps +1 | ||
302 | .if n \{\ | ||
303 | .RE | ||
304 | .\} | ||
305 | .SH "SEE ALSO" | ||
306 | .sp | ||
307 | fluxbox(1), fbsetroot(1) | ||
308 | .SH "ONLINE DOCUMENTATION" | ||
309 | .PP | ||
310 | Much more extensive documentation for \fBfbsetbg(1)\fR is provided on: | ||
311 | .RS 4 | ||
312 | |||
313 | \m[blue]\fBhttp://www\&.xs4all\&.nl/~hanb/software/fbsetbg/fbsetbg\&.html\fR\m[] | ||
314 | .RE | ||
315 | .SH "BUGS" | ||
316 | .sp | ||
317 | \fBfbsetbg(1)\fR is not foolproof\&. | ||
318 | .SH "AUTHORS" | ||
319 | .sp | ||
320 | The author of fbsetbg is Han Boetes <\m[blue]\fBhan@fluxbox\&.org\fR\m[]\&\s-2\u[1]\d\s+2> | ||
321 | .sp | ||
322 | This manpage was updated to asciidoc format by Jim Ramsay <\m[blue]\fBi\&.am@jimramsay\&.com\fR\m[]\&\s-2\u[2]\d\s+2> | ||
323 | .SH "Notes" | ||
324 | .IP " 1." 4 | ||
325 | han@fluxbox.org | ||
326 | .RS 4 | ||
327 | \%mailto:han@fluxbox.org | ||
328 | .RE | ||
329 | .IP " 2." 4 | ||
330 | i.am@jimramsay.com | ||
331 | .RS 4 | ||
332 | \%mailto:i.am@jimramsay.com | ||
333 | .RE | ||