~ubuntu-branches/ubuntu/trusty/fluxbox/trusty-proposed

« back to all changes in this revision

Viewing changes to doc/fbsetbg.1.in

  • Committer: Package Import Robot
  • Author(s): Paul Tagliamonte
  • Date: 2010-08-12 21:16:02 UTC
  • mfrom: (0.1.1) (1.1.10)
  • Revision ID: package-import@ubuntu.com-20100812211602-3tsmzl9in5nmwz7z
Tags: 1.1.1+git20100807.0cc08f9-1
* debian/ dir has been cleaned out, complete repackage
  of most files.
* pulled new archive from git.fluxbox.org HEAD, saved as
  tar.gz.
* Added in fluxbox.* files from the old dfsg tree.
* Added in system.fluxbox-menu file from the old dfsg tree
* Added the source/format file to bump package source
  version from 1.0 to 3.0 (quilt). 
* Changed rules file to match the old dfsg setup so that
  fluxbox behaves nicely.
* Removed entries from copyright that no longer apply.
* Added theme based on Denis Brand ( naran )'s old theme.
* Added a background I whipped up.
* Changed compile flags to point to debian theme by default
* Adding a patch to have fluxbox use x-terminal-emulator
  over xterm. Closes: #591694 (LP: #580485)
* Adding a patch to allow titlebar-window dragging.
* Changed the flags in rules to pull from a script. This script
  lets us un-hardcode what theme is default. Be sure there
  is a theme pack!
* Added comments to my patches.
* Removing debian/docs, empty file.
* Fixing fluxbox.desktop to remove all the warnings from
  desktop-file-validate
* Fixing libtool issue by running an update before
  configure in the rules script.
* Added a compile flag script to auto-detect what platform
  we are running on, and apply the correct theme. This
  should solve Ubuntnu issues later on.
* adding in a get-orig-source rule
* fixing the upstream version number to pinpoint
  the commit ( thanks, lfaraone ).
* adding a rule for get-orig-source. ( thanks again,
  lfaraone ).
* Updated rules to actually allow us to do a build from it
* Removed Denis from the uploaders ( as per an email
  conversation )
* Removing madduck from the uploaders ( thanks for asking,
  lfaraone. ). Thanks for your hard work, madduck.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
'\" t
 
2
.\"     Title: fbsetbg
 
3
.\"    Author: [see the "AUTHORS" section]
 
4
.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
 
5
.\"      Date: 01/14/2010
 
6
.\"    Manual: Fluxbox Manual
 
7
.\"    Source: fbsetbg.txt
 
8
.\"  Language: English
 
9
.\"
 
10
.TH "FBSETBG" "1" "01/14/2010" "fbsetbg\&.txt" "Fluxbox Manual"
 
11
.\" -----------------------------------------------------------------
 
12
.\" * set default formatting
 
13
.\" -----------------------------------------------------------------
 
14
.\" disable hyphenation
 
15
.nh
 
16
.\" disable justification (adjust text to left margin only)
 
17
.ad l
 
18
.\" -----------------------------------------------------------------
 
19
.\" * MAIN CONTENT STARTS HERE *
 
20
.\" -----------------------------------------------------------------
 
21
.SH "NAME"
 
22
fbsetbg \- Set a background wallpaper or pattern
 
23
.SH "SYNOPSIS"
 
24
.sp
 
25
\fBfbsetbg\fR [\fB\-uU\fR \fIwallpapersetter\fR] [\fB\-fFcCtTaA\fR] \fIwallpaper\fR
 
26
.sp
 
27
\fBfbsetbg\fR [\fB\-uU\fR \fIwallpapersetter\fR] \fB\-rR\fR \fIpath\fR
 
28
.sp
 
29
\fBfbsetbg\fR \fB\-bB\fR \fIfbsetrootoptions\&...\fR
 
30
.sp
 
31
\fBfbsetbg\fR [\-\fBl\fR|\fBh\fR|\fBi\fR|\fBp\fR]
 
32
.SH "DESCRIPTION"
 
33
.sp
 
34
\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\(cqt have to configure fbsetbg\&. It just uses the first app it can find\&.
 
35
.sp
 
36
Furthermore it supports remembering the last set wallpaper so you don\(cqt have to edit the style or init\-file to change the wallpaper\&.
 
37
.sp
 
38
It aims to provide clear error messages in a window that make debugging problems easy\&.
 
39
.SH "OPTIONS"
 
40
.PP
 
41
\fB\-f\fR \fIfile\fR
 
42
.RS 4
 
43
Set fullscreen wallpaper\&.
 
44
.RE
 
45
.PP
 
46
\fB\-c\fR \fIfile\fR
 
47
.RS 4
 
48
Set centered wallpaper\&.
 
49
.RE
 
50
.PP
 
51
\fB\-t\fR \fIfile\fR
 
52
.RS 4
 
53
Set tiled wallpaper\&.
 
54
.RE
 
55
.PP
 
56
\fB\-a\fR \fIfile\fR
 
57
.RS 4
 
58
Set maximized wallpaper, preserving aspect (if your bgsetter doesn\(cqt support this option fbsetbg falls back to
 
59
\fB\-f\fR)\&.
 
60
.RE
 
61
.PP
 
62
\fB\-u\fR \fIwallpapersetter\fR
 
63
.RS 4
 
64
Use specified wallpapersetter, use no argument to forget\&.
 
65
.RE
 
66
.PP
 
67
\fB\-b\fR \fIfbsetrootoptions\fR
 
68
.RS 4
 
69
Forward the options to
 
70
\fBfbsetroot(1)\fR\&. These can be used to set a solid, pattern, or gradient background texture\&.
 
71
.RE
 
72
.PP
 
73
\fB\-r\fR \fIdirectory\fR
 
74
.RS 4
 
75
Set random wallpaper from a directory\&.
 
76
.RE
 
77
.PP
 
78
\fB\-F\fR, \fB\-C\fR, \fB\-T\fR, \fB\-A\fR, \fB\-U\fR, \fB\-B\fR, \fB\-R\fR
 
79
.RS 4
 
80
Same as the lowercase option but without remembering\&.
 
81
.RE
 
82
.PP
 
83
\fB\-l\fR
 
84
.RS 4
 
85
Set previous wallpaper\&. Or, if the random feature was last used, set another random wallpaper from the same directory\&.
 
86
.RE
 
87
.PP
 
88
\fB\-i\fR
 
89
.RS 4
 
90
Display useful information about best wallpapersetter found\&.
 
91
.RE
 
92
.PP
 
93
\fB\-p\fR
 
94
.RS 4
 
95
Display some useful tips\&.
 
96
.RE
 
97
.PP
 
98
\fB\-h\fR
 
99
.RS 4
 
100
Display a help message\&.
 
101
.RE
 
102
.SH "FILES"
 
103
.PP
 
104
\fB~/\&.fluxbox/lastwallpaper\fR
 
105
.RS 4
 
106
In this file the wallpaper you set will be stored, for the
 
107
\fB\-l\fR
 
108
option\&.
 
109
.RE
 
110
.SH "ENVIRONMENT"
 
111
.PP
 
112
\fBwpsetters\fR
 
113
.RS 4
 
114
Wallpapersetters to use\&. This can be a space\-delimited list of the applications to try, or just a single name\&.
 
115
.RE
 
116
.PP
 
117
\fBDISPLAY\fR
 
118
.RS 4
 
119
The display you want to set the wallpaper on\&.
 
120
.RE
 
121
.SH "EXAMPLES"
 
122
.sp
 
123
To use \fBfeh(1)\fR as wallpapersetter and set \fBwallpapper\&.jpg\fR from the current directory as wallpaper\&.
 
124
.sp
 
125
.if n \{\
 
126
.RS 4
 
127
.\}
 
128
.nf
 
129
$ wpsetters=feh fbsetbg wallpaper\&.jpg
 
130
.fi
 
131
.if n \{\
 
132
.RE
 
133
.\}
 
134
.sp
 
135
Recall the last set wallpaper on display \fB:0\&.0\fR with the stored options\&.
 
136
.sp
 
137
.if n \{\
 
138
.RS 4
 
139
.\}
 
140
.nf
 
141
$ DISPLAY=:0\&.0 fbsetbg \-l
 
142
.fi
 
143
.if n \{\
 
144
.RE
 
145
.\}
 
146
.SH "ONLINE DOCUMENTATION"
 
147
.PP
 
148
Much more extensive documentation for \fBfbsetbg(1)\fR is provided on
 
149
.RS 4
 
150
 
 
151
\m[blue]\fBhttp://www\&.xs4all\&.nl/~hanb/software/fbsetbg/fbsetbg\&.html\fR\m[]
 
152
.RE
 
153
.SH "BUGS"
 
154
.sp
 
155
\fBfbsetbg(1)\fR is not foolproof\&.
 
156
.SH "AUTHORS"
 
157
.sp
 
158
The author of fbsetbg is Han Boetes <han at fluxbox\&.org>
 
159
.sp
 
160
This manpage was converted to asciidoc format by Jim Ramsay <i\&.am at jimramsay\&.com> for fluxbox\-1\&.1\&.2
 
161
.SH "SEE ALSO"
 
162
.sp
 
163
fluxbox(1) fbsetroot(1)