Find a file
Aldo Cortesi 65fd8d48f0 The beginnings of a more flexible widget configuration.
The problem is as follows. In the end, different types of widget are going to
have distinct configurable options. This means that we need to have a
different section type for every widget type, if we are ever to make the
configuration nice. In fact, a configuration syntax like this would suit us
very well:

    textbox name {
        foo = bar
    }
    focuslist name2 {
        bar = voing
    }

This is all very well, but libconfuse has a limitation - there is no "nice"
way to retrieve the order of disparate sections (i.e. sections of different
types), and order is important to us. This patch goes to some effort to
retrieve the section order by extracting an array of widgets, and sorting them
based on line number.
2007-12-16 12:57:03 +01:00
layouts Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
widgets Simplify widget draw interface. 2007-12-16 12:54:42 +01:00
.gitignore remove dual-config: awesomerc is now preprocessed and compiled in awesome 2007-12-13 11:16:43 +01:00
AUTHORS add Nikos Ntarmos in AUTHORS 2007-11-14 17:21:12 +01:00
awesome-client-common.c fix memory allocation when DISPLAY is not set 2007-12-04 10:17:02 +01:00
awesome-client.1.txt minor documentation fix 2007-12-15 07:36:06 +01:00
awesome-client.c remove some useless #include 2007-12-05 14:31:15 +01:00
awesome-client.h add display name in socket path 2007-10-29 17:29:58 +01:00
awesome.1.txt remove default reloadconfig un manpage 2007-12-15 19:22:47 +01:00
awesome.c Various doc comment fixes. 2007-12-16 12:13:07 +01:00
awesome.doxygen set version to devel 2007-09-18 23:30:10 +02:00
awesome.h Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
awesomerc add uicb_focus_history and bind with -1 to Mod4+Tab by default 2007-12-15 20:32:49 +01:00
awesomerc.1.txt rename description 2007-12-15 07:42:18 +01:00
client.c Various doc comment fixes. 2007-12-16 12:13:07 +01:00
client.h Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
common.h Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
config.c The beginnings of a more flexible widget configuration. 2007-12-16 12:57:03 +01:00
config.h Simplify widget draw interface. 2007-12-16 12:54:42 +01:00
config.mk Widget-ise the statusbar. 2007-12-15 10:15:42 +01:00
draw.c Refactor statusbar.c 2007-12-15 09:48:13 +01:00
draw.h Refactor draw.c 2007-12-15 09:30:29 +01:00
event.c Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
event.h Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
focus.c Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
focus.h Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
layout.c Various doc comment fixes. 2007-12-16 12:13:07 +01:00
layout.h Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
LICENSE chance license to GPLv2 2007-09-12 14:29:51 +02:00
Makefile Widget-ise the statusbar. 2007-12-15 10:15:42 +01:00
mouse.c Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
mouse.h rename uicb_*mouse to uicb_client_*mouse 2007-11-14 18:14:23 +01:00
README remove useless information about statusbar for now 2007-10-12 18:44:07 +02:00
rules.c get_client_screen_from_rules() is not needed; deleting 2007-11-13 22:50:54 +01:00
rules.h get_client_screen_from_rules() is not needed; deleting 2007-11-13 22:50:54 +01:00
screen.c Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
screen.h Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
statusbar.c Simplify widget draw interface. 2007-12-16 12:54:42 +01:00
statusbar.h Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
STYLE add a rule to STYLE 2007-11-12 19:11:14 +01:00
tag.c Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
tag.h Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
uicb.c Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
uicb.h Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
util.c prefix eprint() with awesome: 2007-12-13 15:20:42 +01:00
util.h Comment typos. 2007-12-14 08:47:21 +01:00
widget.c Simplify widget draw interface. 2007-12-16 12:54:42 +01:00
widget.h Fix compilation warning related to parsing of statusbar widgets config. 2007-12-16 12:00:00 +01:00
window.c Various doc comment fixes. 2007-12-16 12:13:07 +01:00
window.h Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
xutil.c Massive, massive interface refactoring. 2007-12-16 12:12:48 +01:00
xutil.h fix some includes and add copyright 2007-12-14 16:15:40 +01:00

awesome
=======
awesome is an extremely fast, small, and dynamic window manager for X.
It's based on dwm.

Requirements
------------
In order to build awesome you need the Xlib header files, libconfuse and cairo.

Installation
------------
Edit config.mk to match your local setup (awesome is installed into
the /usr/local namespace by default).

Afterwards enter the following command to build and install awesome (if
necessary as root):

    make install

Running awesome
-----------
Add the following line to your .xinitrc to start awesome using startx
or to .xsession to start awesome using gdm/kdm/xdm...:

    exec awesome

In order to connect awesome to a specific display, make sure that
the DISPLAY environment variable is set correctly, e.g.:

    DISPLAY=foo.bar:1 exec awesome

(This will start awesome on display :1 of the host foo.bar.)

Configuration
-------------
The configuration of awesome is done by creating a ~/.awesomerc file.
An example is provided in the sources.