contrib/awesome/awsetbg.1
2009-01-10 16:26:20 +01:00

113 lines
2.5 KiB
Groff

.\" Title: awsetbg
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\" Date: 01/10/2009
.\" Manual:
.\" Source:
.\"
.TH "AWSETBG" "1" "01/10/2009" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
awsetbg - awesome wrapper tool to set background
.SH "SYNOPSIS"
\fBawsetbg\fR [\-fctaFCTA wallpaper] [\-uU wallpapersetter] [\-m #] [\-bB fbsetrootoptions \&...] [\-rR path] [\-l]
.sp
.SH "DESCRIPTION"
\fBawsetbg\fR is a wrapper that tries to find a suitable background setting application and then tries to set the wallpaper using that application\. You do not have to configure \fBawsetbg\fR, since it just uses te first application it find\.
.sp
Furthermore, it remembers the last wallpaper set, so you do not have to edit anything to change the wallpaper\.
.sp
.SH "OPTIONS"
.PP
\fB\-f\fR file
.RS 4
Set fullscreen wallpaper\.
.RE
.PP
\fB\-c\fR file
.RS 4
Set centered wallpaper\.
.RE
.PP
\fB\-t\fR file
.RS 4
Set centered wallpaper\.
.RE
.PP
\fB\-a\fR file
.RS 4
Set maximized wallpaper, preserving aspect\. If the application chosen do not support this option, fullscreen is used as fallback\.
.RE
.PP
\fB\-u\fR wallpapersetter
.RS 4
Use the specified wallpaper setter tool\.
.RE
.PP
\fB\-r\fR directory
.RS 4
Set a random wallpaper from this directory\.
.RE
.PP
\fB\-F, \-C, \-T, \-A, \-U, \-R\fR
.RS 4
Same as the lowercaser option, but without remembering\.
.RE
.PP
\fB\-l\fR
.RS 4
Set the previous wallpaper\. If the random feature was the last used, it will set another random wallpaper from this same directory\.
.RE
.PP
\fB\-i\fR
.RS 4
Display useful information about the best application to set the wallpaper found\.
.RE
.PP
\fB\-p\fR
.RS 4
Display useful tips\.
.RE
.PP
\fB\-h\fR
.RS 4
Display help message\.
.RE
.SH "FILES"
$XDG_CACHE_HOME/awesome/lastwallpaper or $HOME/\.cache/awesome/lastwallpaper files contains the last wallpaper set to use with the \-l option\.
.sp
.SH "ENVIRONMENT VARIABLES"
.PP
\fBwpsetters\fR
.RS 4
Wallpaper setters to use\.
.RE
.PP
\fBDISPLAY\fR
.RS 4
Display you want to set the wallpaper on\.
.RE
.SH "SEE ALSO"
awesome(1)
.sp
.SH "AUTHORS"
Julien Danjou <\fIjulien@danjou\.info\fR\&[1]> and others\. awsetbg is derived from fbsetbg which was written by Han Boetes <\fIhan@fluxbox\.org\fR\&[2]>\.
.sp
.SH "WWW"
\fIhttp://awesome\.naquadah\.org\fR
.sp
.SH "NOTES"
.IP " 1." 4
julien@danjou.info
.RS 4
\%mailto:julien@danjou.info
.RE
.IP " 2." 4
han@fluxbox.org
.RS 4
\%mailto:han@fluxbox.org
.RE