nilix/fluxbox
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

update from Han, new licensed, complete and correct version from the original author

Browse source
This commit is contained in:
fluxgen 2004-05-07 16:25:46 +00:00
parent d95fcc2dbb
commit d29d4dc370
1 changed files with 110 additions and 64 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

174
doc/fbsetbg.1
View file

@ -1,77 +1,123 @@
.\" $Id: fbsetbg.1,v 1.2 2004/05/07 16:25:46 fluxgen Exp $
.\" .\"
.\" Man page for fbsetbg .\" Copyright (c) 2004, Han Boetes <han@fluxbox.org>
.\" .\"
.\" Copyright (c) 2004 by Bastian Kleineidam <reflexionsniveau@web.de> .\" Permission to use, copy, modify, and distribute this documentation for
.\" any purpose with or without fee is hereby granted, provided that the
.\" above copyright notice and this permission notice appear in all copies.
.\" .\"
.TH FBSETBG 1 "16 December 2003" .\" THE DOCUMENTATION IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
.SH NAME .\" WARRANTIES WITH REGARD TO THIS DOCUMENTATION INCLUDING ALL IMPLIED
fbsetbg \- set the background wallpaper for fluxbox .\" WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
.SH SYNOPSIS .\" AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
\fBfbsetbg\fP [\fIoptions\fP]... \fIimage\fP .\" DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
.br .\" PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
\fBfbsetbg\fP \fB-l\fP .\" TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.SH DESCRIPTION .\" PERFORMANCE OF THIS DOCUMENTATION
\fBfbsetbg\fP 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 .Dd May 4, 2004
.Dt FBSETBG 1
.Os
.Sh NAME
.Nm fbsetbg
.Nd "set a background/wallpaper"
.Sh SYNOPSIS
.Nm fbsetbg
.Bk -words
.Op Fl fctaFCTA Ar wallpaper
.Op Fl uU Ar wallpapersetter
.Op Fl bB Ar bsetrootoptions ...
.Op Fl rR Ar path
.Op Fl l
.Ek
.Sh DESCRIPTION
.Nm
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. configure fbsetbg. It just uses the first app it can find.
Furthermore it provides clear error messages in a window that make debugging .Pp
problems a lot easier. Furthermore it supports remembering the last set wallpaper so you don't
.SH OPTIONS have to edit the style or init-file to change the wallpaper.
.TP .Pp
\fB-f\fP It aims to provide clear error messages in a window that make debugging
problems easy.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl f Ar file
Set fullscreen wallpaper. Set fullscreen wallpaper.
.TP .It Fl c Ar file
\fB-c\fP
Set centered wallpaper. Set centered wallpaper.
.TP .It Fl t Ar file
\fB-t\fP
Set tiled wallpaper. Set tiled wallpaper.
.TP .It Fl a Ar file
\fB-a\fP
Set maximized wallpaper, preserving aspect (if your bgsetter doesn't Set maximized wallpaper, preserving aspect (if your bgsetter doesn't
support this we fall back to \fB-f\fP). support this option fbsetbg falls back to
.TP .Fl f
\fB-u\fP ).
.It Fl u Ar wallpapersetter
Use specified wallpapersetter, use no argument to forget. Use specified wallpapersetter, use no argument to forget.
.TP .It Fl b Ar bsetrootoptions
\fB-b\fP
Forward the options to bsetroot. Forward the options to bsetroot.
.TP .It Fl r Ar directory
\fB-F\fP,\fB-C\fP,\fB-T\fP,\fB-A\fP,\fB-U\fP,\fB-B\fP Set random wallpaper from a directory.
same as uncapsed but without remembering. .It Fl F , C , T , A , U , B , R
.TP Same as the uncapsed option but without remembering.
\fB-h\fP .It Fl l
Display this help. Set previous wallpaper. Or, if the random feature was last used, set
.TP another random wallpaper from the same directory.
\fB-l\fP .It Fl i
Set previous wallpaper. Display usefull information about best wallpapersetter found.
.TP .It Fl p
\fB-i\fP Display some usefull tips.
Information about selected wallpaper command. .It Fl h
.TP Display a help message.
\fB-d\fP .El
Debug info (deprecated, use \fB-i\fP). .Sh FILES
.TP .Bl -tag -width "~/.fluxbox/lastwallpaper" -compact
\fB-p\fP .It Pa ~/.fluxbox/lastwallpaper
Tips. In this file the wallpaper you set will be stored, for the
.SH FILES .Fl l
.TP
\fB$HOME/.fluxbox/lastwallpaper\fP
In this file the wallpaper you set will be stored, for the \fB-l\fP
option. option.
.SH ENVIRONMENT .El
.TP .Sh ENVIRONMENT VARIABLES
\fBwpsetters\fP .Pp fbsetbg supports the following environmental variables:
.Ar wpsetters
Wallpapersetters to use. Wallpapersetters to use.
.TP .Pp
\fBDISPLAY\fP .Ar DISPLAY
The display you want to set the wallpaper on. The display you want to set the wallpaper on.
.SH EXAMPLES .El
\fBwpsetters=feh fbsetbg wallpaper.jpg\fP .Sh EXAMPLES
\fBDISPLAY=:0.0 fbsetbg -l\fP .Pp
.SH AUTHOR To use
This manpage was originally written by Bastian Kleineidam .Ar feh
<calvin@debian.org> for the Debian distribution of fluxbox as wallpapersetter and set
(but may be used by others). .Ar wallpapper.jpg
from the current directory as wallpaper.
The main author of fluxbox is Henrik Kinnunen <fluxgen@fluxbox.org>. .Bd -literal -offset indent
$ wpsetters=feh fbsetbg wallpaper.jpg
.Ed
.Pp
Recall the last set wallpaper on display
.Ar :0.0
with the stored options.
.Bd -literal -offset indent
$ DISPLAY=:0.0 fbsetbg -l
.Ed
.El
.Sh SEE ALSO
.Xr bsetroot 1 ,
.Xr fluxbox 1
.El
.Sh ONLINE DOCUMENTATION:
Much more extensive documentation for
.Nm
is provided on:
http://www.xs4all.nl/~hanb/software/fluxbox/fbsetbg.html
.El
.Sh BUGS
.Nm
is not foolproof.
.El
.Sh AUTHOR
The author of fbsetbg is Han Boetes <han@fluxbox.org>