awesome: update to 3.1.1

This commit is contained in:
Bartlomiej Palmowski 2009-01-10 16:26:20 +01:00
parent 0c52c1eaf8
commit 753f44e4a5
9 changed files with 750 additions and 38 deletions

View File

@ -2,38 +2,123 @@ drwxr-xr-x root/root usr/
drwxr-xr-x root/root usr/bin/
-rwxr-xr-x root/root usr/bin/awesome
-rwxr-xr-x root/root usr/bin/awesome-client
-rwxr-xr-x root/root usr/bin/awesome-menu
-rwxr-xr-x root/root usr/bin/awesome-message
-rwxr-xr-x root/root usr/bin/awsetbg
drwxr-xr-x root/root usr/etc/
drwxr-xr-x root/root usr/etc/xdg/
drwxr-xr-x root/root usr/etc/xdg/awesome/
-rw-r--r-- root/root usr/etc/xdg/awesome/rc.lua
drwxr-xr-x root/root usr/man/
drwxr-xr-x root/root usr/man/man1/
-rw-r--r-- root/root usr/man/man1/awesome-client.1.gz
-rw-r--r-- root/root usr/man/man1/awesome-menu.1.gz
-rw-r--r-- root/root usr/man/man1/awesome-message.1.gz
-rw-r--r-- root/root usr/man/man1/awesome.1.gz
-rw-r--r-- root/root usr/man/man1/awsetbg.1.gz
drwxr-xr-x root/root usr/man/man5/
-rw-r--r-- root/root usr/man/man5/awesomerc.5.gz
drwxr-xr-x root/root usr/share/
drwxr-xr-x root/root usr/share/awesome/
-rw-r--r-- root/root usr/share/awesome/awesomerc
drwxr-xr-x root/root usr/share/awesome/icons/
-rw-r--r-- root/root usr/share/awesome/icons/awesome16.png
-rw-r--r-- root/root usr/share/awesome/icons/awesome32.png
-rw-r--r-- root/root usr/share/awesome/icons/awesome48.png
-rw-r--r-- root/root usr/share/awesome/icons/awesome64.png
drwxr-xr-x root/root usr/share/awesome/icons/layouts/
-rw-r--r-- root/root usr/share/awesome/icons/layouts/dwindle.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/dwindlew.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/floating.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/floatingw.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/max.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/maxw.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/spiral.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/spiralw.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/tile.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/tilebottom.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/tilebottomw.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/tileleft.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/tileleftw.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/tiletop.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/tiletopw.png
-rw-r--r-- root/root usr/share/awesome/icons/layouts/tilew.png
drwxr-xr-x root/root usr/share/awesome/icons/invaders/
-rw-r--r-- root/root usr/share/awesome/icons/invaders/enemy_1.png
-rw-r--r-- root/root usr/share/awesome/icons/invaders/enemy_2.png
-rw-r--r-- root/root usr/share/awesome/icons/invaders/enemy_3.png
-rw-r--r-- root/root usr/share/awesome/icons/invaders/player.png
drwxr-xr-x root/root usr/share/awesome/lib/
drwxr-xr-x root/root usr/share/awesome/lib/awful/
-rw-r--r-- root/root usr/share/awesome/lib/awful/client.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/client.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/completion.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/completion.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/hooks.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/hooks.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/init.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/init.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/layout.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/layout.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/menu.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/menu.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/placement.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/placement.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/prompt.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/prompt.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/screen.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/screen.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/tag.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/tag.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/titlebar.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/titlebar.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/util.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/util.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/awful/widget.lua
-rw-r--r-- root/root usr/share/awesome/lib/awful/widget.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/beautiful.lua
-rw-r--r-- root/root usr/share/awesome/lib/beautiful.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/invaders.lua
-rw-r--r-- root/root usr/share/awesome/lib/invaders.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/naughty.lua
-rw-r--r-- root/root usr/share/awesome/lib/naughty.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/revelation.lua
-rw-r--r-- root/root usr/share/awesome/lib/revelation.lua.in
-rw-r--r-- root/root usr/share/awesome/lib/tabulous.lua
-rw-r--r-- root/root usr/share/awesome/lib/tabulous.lua.in
drwxr-xr-x root/root usr/share/awesome/themes/
drwxr-xr-x root/root usr/share/awesome/themes/default/
-rw-r--r-- root/root usr/share/awesome/themes/default/background.png
drwxr-xr-x root/root usr/share/awesome/themes/default/layouts/
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/dwindle.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/dwindlew.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/fairh.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/fairhw.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/fairv.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/fairvw.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/floating.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/floatingw.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/magnifier.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/magnifierw.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/max.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/maxw.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/spiral.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/spiralw.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/tile.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/tilebottom.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/tilebottomw.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/tileleft.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/tileleftw.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/tiletop.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/tiletopw.png
-rw-r--r-- root/root usr/share/awesome/themes/default/layouts/tilew.png
-rw-r--r-- root/root usr/share/awesome/themes/default/submenu.png
drwxr-xr-x root/root usr/share/awesome/themes/default/taglist/
-rw-r--r-- root/root usr/share/awesome/themes/default/taglist/squarefw.png
-rw-r--r-- root/root usr/share/awesome/themes/default/taglist/squarew.png
drwxr-xr-x root/root usr/share/awesome/themes/default/tasklist/
-rw-r--r-- root/root usr/share/awesome/themes/default/tasklist/floating.png
-rw-r--r-- root/root usr/share/awesome/themes/default/tasklist/floatingw.png
-rw-r--r-- root/root usr/share/awesome/themes/default/theme
-rw-r--r-- root/root usr/share/awesome/themes/default/theme.in
drwxr-xr-x root/root usr/share/awesome/themes/default/titlebar/
-rw-r--r-- root/root usr/share/awesome/themes/default/titlebar/close.png
-rw-r--r-- root/root usr/share/awesome/themes/default/titlebar/closer.png
drwxr-xr-x root/root usr/share/awesome/themes/sky/
-rw-r--r-- root/root usr/share/awesome/themes/sky/awesome-icon.png
drwxr-xr-x root/root usr/share/awesome/themes/sky/layouts/
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/dwindle.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/fairh.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/fairv.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/floating.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/fullscreen.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/magnifier.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/max.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/spiral.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/tile.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/tilebottom.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/tileleft.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/layouts/tiletop.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/sky-background.png
-rw-r--r-- root/root usr/share/awesome/themes/sky/theme
-rw-r--r-- root/root usr/share/awesome/themes/sky/theme.in
drwxr-xr-x root/root usr/share/xsessions/
-rw-r--r-- root/root usr/share/xsessions/awesome.desktop

View File

@ -1,2 +1,5 @@
bc9d115e70607c51ed55d7e1d6112c5c awesome-2.3.4.tar.bz2
8a31d0842a29eff2fbf9cc04996a2486 awesome-mans-2.3.4.tar.bz2
98de84b418c7646ae4c4aa44c3e6e149 awesome-3.1.1.tar.bz2
7b2345978342aeb455806b8bb4b26c8c awesome-client.1
4eff5b99d9c8df7bd20ca2fb0e67fe98 awesome.1
836014887e4a18406d73ad7e0a2dfb4d awesomerc.5
a4f0580e7f1b9e24ff5c23992d9c456b awsetbg.1

View File

@ -1,24 +1,29 @@
# Description: tiling window manager initialy based on a dwm code rewriting
# Description: extremely fast, small, and dynamic window manager for X
# URL: http://awesome.naquadah.org/
# Maintainer: Bartlomiej Palmowski, rotwang at crux dot org dot pl
# Depends on: libconfuse cairo xorg-libxinerama pango imlib2 xorg-libxrandr
# Depends on: cmake gperf glib lua cairo pango imlib2 libev dbus
name=awesome
version=2.3.4
version=3.1.1
release=1
source=(http://awesome.naquadah.org/download/$name-$version.tar.bz2
http://maxiq.ovh.org/CRUX/$name-mans-$version.tar.bz2)
source=(http://$name.naquadah.org/download/$name-$version.tar.bz2
$name-client.1 $name.1 awsetbg.1 ${name}rc.5)
build() {
mkdir -p $PKG/usr/man/man{1,5}
cp $name{,-client}.1 awsetbg.1 $PKG/usr/man/man1
cp ${name}rc.5 $PKG/usr/man/man5
cd $name-$version
autoreconf --force --install --verbose
./configure \
--prefix=/usr \
--mandir=/usr/man \
--docdir=/usr/share/$name
make AWESOME_CFLAGS="$CFLAGS"
cmake . -DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=/usr \
-DXDG_CONFIG_DIR=/usr/etc/xdg \
-DAWESOME_MAN_PATH=/usr/man \
-DCMAKE_C_FLAGS_RELEASE="-DNDEBUG" \
-DGENERATE_MANPAGES=OFF
make
make DESTDIR=$PKG install
rm -f $PKG/usr/share/$name/{README,STYLE,UPGRADE}
cp $SRC/$name{,-{client,menu,message}}.1 $PKG/usr/man/man1
cp $SRC/${name}rc.5 $PKG/usr/man/man5
rm -rf $PKG/usr/share/doc/
}

15
awesome/README Normal file
View File

@ -0,0 +1,15 @@
README for awesome
REQUIREMENTS
cairo with xcb support is required, install xorg/xorg-xcb-util
and rebuild cairo
prt-get depinst xorg-xcb-util
prt-get update -fr -if cairo
PRE-INSTALL
POST-INSTALL
PRECAUTION

40
awesome/awesome-client.1 Normal file
View File

@ -0,0 +1,40 @@
.\" Title: awesome-client
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\" Date: 01/10/2009
.\" Manual:
.\" Source:
.\"
.TH "AWESOME\-CLIENT" "1" "01/10/2009" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
awesome-client - awesome window manager command line interface
.SH "SYNOPSIS"
awesome\-client
.sp
.SH "DESCRIPTION"
awesome\-client is the command line interface to awesome\. It communicates with awesome via a socket located in the users\(cqs HOME directory\. It permits to execute Lua code remotely\.
.sp
.SH "USAGE"
To determine which socket is to be used, it reads the DISPLAY environment variable\. awesome\-client reads commands from standard input\.
.sp
When you pipe multiple lines into awesome\-client, an empty line will flush already collected lines into awesome with an according immediate execution\.
.sp
.SH "SEE ALSO"
awesome(1) awesomerc(5)
.sp
.SH "AUTHORS"
Julien Danjou <\fIjulien@danjou\.info\fR\&[1]>
.sp
.SH "WWW"
\fIhttp://awesome\.naquadah\.org\fR
.sp
.SH "NOTES"
.IP " 1." 4
julien@danjou.info
.RS 4
\%mailto:julien@danjou.info
.RE

314
awesome/awesome.1 Normal file
View File

@ -0,0 +1,314 @@
.\" Title: awesome
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\" Date: 01/10/2009
.\" Manual:
.\" Source:
.\"
.TH "AWESOME" "1" "01/10/2009" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
awesome - awesome window manager
.SH "SYNOPSIS"
\fBawesome\fR [\fB\-v\fR | \fB\-\-version\fR] [\fB\-h\fR | \fB\-\-help\fR] [\fB\-c\fR | \fB\-\-config\fR \fIFILE\fR] [\fB\-k\fR | \fB\-\-check\fR]
.sp
.SH "DESCRIPTION"
\fBawesome\fR is a window manager for X\. It manages windows in different layouts, like floating or tiled\. Either layout can be applied dynamically, optimizing the environment for the application in use and the task performed\.
.sp
In tiled layout, windows are managed in a master and stacking area\. The master area contains the windows which currently need most attention, whereas the stacking area contains all other windows\. In floating layout windows can be resized and moved freely\. Dialog windows are always managed floating, regardless of the layout applied\. The spiral and dwindle layout are special cases of the tiled layout where the stacking area is arranged in a spiral for the former or as a rectangular fractal for the later\.
.sp
Windows are grouped by tags\. Each window can be tagged with one or multiple tags\. Selecting certain tags displays all windows with these tags\.
.sp
\fBawesome\fR can contain small wiboxes which can display anything you want: all available tags, the layout, the title of the visible windows, a text, etc\.
.sp
.SH "OPTIONS"
.PP
\fB\-v\fR, \fB\-\-version\fR
.RS 4
Print version information to standard output, then exit\.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Print help information, then exit\.
.RE
.PP
\fB\-c\fR, \fB\-\-config\fR \fIFILE\fR
.RS 4
Use an alternate configuration file instead of
\fI$XDG_CONFIG_HOME/awesome/rc\.lua\fR\.
.RE
.PP
\fB\-k\fR, \fB\-\-check\fR
.RS 4
Check configuration file syntax\.
.RE
.SH "DEFAULT MOUSE BINDINGS"
.SS "Navigation"
.PP
\fBButton1\fR on tag name
.RS 4
View tag\.
.RE
.PP
\fBButton4\fR, \fBButton5\fR on tag name
.RS 4
Switch to previous or next tag\.
.RE
.PP
\fBButton4\fR, \fBButton5\fR on root window
.RS 4
Switch to previous or next tag\.
.RE
.PP
\fBButton1\fR, \fBButton3\fR, \fBButton4\fR, \fBButton5\fR on layout symbol
.RS 4
Switch to previous or next layout\.
.RE
.SS "Layout modification"
.PP
\fBMod4 \e+ Button1\fR on tag name
.RS 4
Tag current client with this tag only\.
.RE
.PP
\fBMod4 \e+ Button3\fR on tag name
.RS 4
Toggle this tag for client\.
.RE
.PP
\fBButton3\fR on tag name
.RS 4
Add this tag to current view\.
.RE
.PP
\fBMod4 \e+ Button1\fR on client window
.RS 4
Move window\.
.RE
.PP
\fBMod4 \e+ Button3\fR on client window
.RS 4
Resize window\.
.RE
.SH "DEFAULT KEY BINDINGS"
.SS "Window manager control"
.PP
\fBMod4 + Control \e+ r\fR
.RS 4
Restart
\fBawesome\fR\.
.RE
.PP
\fBMod4 + Shift \e+ q\fR
.RS 4
Quit
\fBawesome\fR\.
.RE
.PP
\fBMod4 \e+ F1\fR
.RS 4
Run prompt\.
.RE
.PP
\fBMod4 \e+ F4\fR
.RS 4
Run Lua code prompt\.
.RE
.PP
\fBMod4 \e+ Return\fR
.RS 4
Spawn terminal emulator\.
.RE
.SS "Clients"
.PP
\fBMod4 + Control \e+ i\fR
.RS 4
Print the client class and instance\.
.RE
.PP
\fBMod4 + Shift \e+ r\fR
.RS 4
Redraw the focused window\.
.RE
.PP
\fBMod4 \e+ m\fR
.RS 4
Maximize client\.
.RE
.PP
\fBMod4 \e+ f\fR
.RS 4
Set client fullscreen\.
.RE
.PP
\fBMod4 + Shift \e+ c\fR
.RS 4
Kill focused client\.
.RE
.PP
\fBMod4 \e+ t\fR
.RS 4
Mark a client\.
.RE
.SS "Navigation"
.PP
\fBMod4 \e+ j\fR
.RS 4
Focus next client\.
.RE
.PP
\fBMod4 \e+ k\fR
.RS 4
Focus previous client\.
.RE
.PP
\fBMod4 \e+ u\fR
.RS 4
Focus first urgent client\.
.RE
.PP
\fBMod4 \e+ Left\fR
.RS 4
View previous tag\.
.RE
.PP
\fBMod4 \e+ Right\fR
.RS 4
View next tag\.
.RE
.PP
\fBMod4 \e+ 1\-9\fR
.RS 4
Switch to tag 1\-9\.
.RE
.PP
\fBMod4 + Control \e+ j\fR
.RS 4
Focus next screen\.
.RE
.PP
\fBMod4 + Control \e+ k\fR
.RS 4
Focus previous screen\.
.RE
.PP
\fBMod4 \e+ Escape\fR
.RS 4
Focus previously selected tag set\.
.RE
.SS "Layout modification"
.PP
\fBMod4 + Shift \e+ j\fR
.RS 4
Switch client with next client\.
.RE
.PP
\fBMod4 + Shift \e+ k\fR
.RS 4
Switch client with previous client\.
.RE
.PP
\fBMod4 \e+ o\fR
.RS 4
Send client to next screen\.
.RE
.PP
\fBMod4 \e+ h\fR
.RS 4
Decrease master width factor by 5%\.
.RE
.PP
\fBMod4 \e+ l\fR
.RS 4
Increase master width factor by 5%\.
.RE
.PP
\fBMod4 + Shift \e+ h\fR
.RS 4
Increase number of master windows by 1\.
.RE
.PP
\fBMod4 + Shift \e+ l\fR
.RS 4
Decrease number of master windows by 1\.
.RE
.PP
\fBMod4 + Control \e+ h\fR
.RS 4
Increase number of columns for non\-master windows by 1\.
.RE
.PP
\fBMod4 + Control \e+ l\fR
.RS 4
Decrease number of columns for non\-master windows by 1\.
.RE
.PP
\fBMod4 \e+ space\fR
.RS 4
Switch to next layout\.
.RE
.PP
\fBMod4 + Shift \e+ space\fR
.RS 4
Switch to previous layout\.
.RE
.PP
\fBMod4 + Control \e+ space\fR
.RS 4
Toggle client floating status\.
.RE
.PP
\fBMod4 + Control \e+ Return\fR
.RS 4
Swap focused client with master\.
.RE
.PP
\fBMod4 + Control \e+ 1\-9\fR
.RS 4
Toggle tag view\.
.RE
.PP
\fBMod4 + Shift \e+ 1\-9\fR
.RS 4
Tag client with tag\.
.RE
.PP
\fBMod4 + Shift + Control \e+ 1\-9\fR
.RS 4
Toggle tag on client\.
.RE
.PP
\fBMod4 + Shift \e+ F1\-9\fR
.RS 4
Tag marked clients with tag\.
.RE
.SH "CUSTOMIZATION"
\fBawesome\fR is customized by creating a custom \fI$XDG_CONFIG_HOME/awesome/rc\.lua\fR file\.
.sp
.SH "SIGNALS"
\fBawesome\fR can be restarted by sending it a SIGHUP\.
.sp
.SH "SEE ALSO"
\fBawesomerc\fR(5) \fBawesome\-client\fR(1)
.sp
.SH "BUGS"
Of course there\(cqs no bug in \fBawesome\fR\. But there may be unexpected behaviors\.
.sp
Java applications which use the XToolkit/XAWT backend may draw gray windows only\. The XToolkit/XAWT backend breaks ICCCM\-compliance in recent JDK 1\.5 and early JDK 1\.6 versions because it assumes a reparenting window manager\. As a workaround you can use JDK 1\.4 (which doesn\(cqt contain the XToolkit/XAWT backend), or you can set the following environment variable (to use the older Motif backend instead): AWT_TOOLKIT=MToolkit
.sp
.SH "AUTHORS"
Julien Danjou <\fIjulien@danjou\.info\fR\&[1]> and others\.
.sp
.SH "WWW"
\fIhttp://awesome\.naquadah\.org\fR
.sp
.SH "NOTES"
.IP " 1." 4
julien@danjou.info
.RS 4
\%mailto:julien@danjou.info
.RE

126
awesome/awesomerc.5 Normal file
View File

@ -0,0 +1,126 @@
.\" Title: awesomerc
.\" Author:
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\" Date: 01/10/2009
.\" Manual:
.\" Source:
.\"
.TH "AWESOMERC" "5" "01/10/2009" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
awesomerc - Configuration file for the awesome window manager
.SH "SYNOPSIS"
\fBawesome\fR looks for this configuration file in this order:
.sp
.sp
.RS 4
\h'-04'\(bu\h'+03'$XDG_CONFIG_HOME/awesome/rc\.lua
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'$HOME/\.config/awesome/rc\.lua
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'XDG_CONFIG_DIRS/awesome/rc\.lua
.RE
.SH "DESCRIPTION"
The \fBrc\.lua\fR file contains configuration informations for \fBawesome\fR\. It can be used to configure the behaviour and look of awesome in a variety of ways\. It can be assimilated as a Lua program/script run at startup by \fBawesome\fR\. Therefore, it should use the awesome Lua API described in the API section\. This file is read at startup\.
.sp
.SH "AWESOME LUA API"
Documentation for the Lua API can be found in the luadoc directory\.
.sp
.SH "COLORS FORMAT"
Colors format in \fBawesome\fR are either standard X color names (blue, darkblue, lightred, etc) or hexadecimal formatted colors (#rrggbb or #rrggbbaa)\. By using hexadecimal format, you can also specifies an alpha channel: that means that #00ff00 will draw pure green, but #00ff00aa will set the alpha channel to \(oqaa\(cq and will blend the green with the color under it\.
.sp
.SH "TEXT FORMAT"
You can use and mix Pango markup and awesome markup in text string\. This allows to format the text rendered in widgets\. Pango markup documentation can be found in the Pango documentation at \fIhttp://library\.gnome\.org/devel/pango/stable/PangoMarkupFormat\.html\fR\.
.sp
List of \fBawesome\fR markup elements and their attributes:
.sp
.sp
.RS 4
\h'-04'\(bu\h'+03'bg
.sp
.RS 4
\h'-04'\(bu\h'+03'color: background color
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'image: path to a background image
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'align: background image alignment
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'resize: resize background image to text size
.RE
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'border
.sp
.RS 4
\h'-04'\(bu\h'+03'color: border color
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'width: border width
.RE
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'margin
.sp
.RS 4
\h'-04'\(bu\h'+03'left: left margin in pixel
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'right: right margin in pixel
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'top: top margin in pixel
.RE
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'text
.sp
.RS 4
\h'-04'\(bu\h'+03'align: text alignment
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'shadow: shadow color
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'shadow_offset: shadow color offset in pixel
.RE
.RE
A Pango markup example: <span weight="bold" foreground="#336699">\&...</span>\.
.sp
An \fBawesome\fR markup example: <text align="right"/>\.
.sp
.SH "SEE ALSO"
awesome(1) awesome\-client(1)
.sp
.SH "AUTHORS"
Written by Julien Danjou <\fIjulien@danjou\.info\fR\&[1]>\.
.sp
.SH "WWW"
\fIhttp://awesome\.naquadah\.org\fR
.sp
.SH "NOTES"
.IP " 1." 4
julien@danjou.info
.RS 4
\%mailto:julien@danjou.info
.RE

112
awesome/awsetbg.1 Normal file
View File

@ -0,0 +1,112 @@
.\" 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

12
awesome/pre-install Normal file
View File

@ -0,0 +1,12 @@
#!/bin/bash
pkg-config --exists cairo-xcb ||
{
echo -e "\033[31m######################################################\033[0m"
echo -e "\033[31m#\033[0m \033[1mCairo must be built with xcb support!\033[0m \033[31m#\033[0m"
echo -e "\033[31m#\033[0m \033[1mInstall xorg/xorg-xcb-util, and rebuild opt/cairo.\033[0m \033[31m#\033[0m"
echo -e "\033[31m######################################################\033[0m"
echo -e "\033[36;1mSleeping for 10 seconds before proceeding.\033[0m"
sleep 10
exit 1
}