Go to file
Julien Danjou 5d10ca8d1a [xcb] Remove useless file
Signed-off-by: Julien Danjou <julien@danjou.info>
2008-05-03 12:01:35 +02:00
build-utils [uicb] Rename Uicb type to uicb_t 2008-05-03 12:01:03 +02:00
common [awesome] Remove checking for value before p_delete()'ing memory 2008-05-03 12:01:35 +02:00
icons Add icons in dist tarball and in default statusbar 2008-03-25 16:59:51 +01:00
layouts [tag] Rename Tag type to tag_t 2008-05-03 12:01:03 +02:00
widgets [awesome] Remove checking for value before p_delete()'ing memory 2008-05-03 12:01:35 +02:00
.gitignore [doc] Add rcskeleton to gitignore 2008-04-08 09:18:50 +02:00
AUTHORS [authors] Add Arnaud Fontaine 2008-05-03 12:01:01 +02:00
BUGS BUG's page 2008-04-18 19:33:58 +02:00
LICENSE chance license to GPLv2 2007-09-12 14:29:51 +02:00
Makefile.am [emptybox] Remove 2008-05-03 12:01:04 +02:00
README [build] Add glib dep 2008-05-03 12:01:06 +02:00
STYLE Fix STYLE file to reflect current style [CORRECTIVE] 2008-03-24 07:49:33 +01:00
UPGRADE add UPGRADE to dist 2008-02-02 18:13:55 +01:00
autogen.sh Honor GIT_DIR setting when determining version 2008-01-30 09:22:45 +01:00
awesome-client.1.txt [doc] Fix some typos, modify a few descriptions 2008-04-11 07:34:45 +02:00
awesome-client.c [awesome-client] Add some more code documentation 2008-03-31 14:18:27 +02:00
awesome-menu.1.txt [doc] Fix some typos, modify a few descriptions 2008-04-11 07:34:45 +02:00
awesome-menu.c [awesome] Remove checking for value before p_delete()'ing memory 2008-05-03 12:01:35 +02:00
awesome-message.1.txt [doc] Fix some typos, modify a few descriptions 2008-04-11 07:34:45 +02:00
awesome-message.c [draw] Make draw_text using a const pointer to a style 2008-05-03 12:01:06 +02:00
awesome.1.txt Remove xsync option (no XCB equivalent of XSynchronize) 2008-05-03 12:01:00 +02:00
awesome.c [awesome] Remove checking for value before p_delete()'ing memory 2008-05-03 12:01:35 +02:00
awesome.doxygen.in [doc] Generate doc for widgets/layouts/common 2008-05-02 10:55:46 +02:00
awesome.h [uicb] Rename Uicb type to uicb_t 2008-05-03 12:01:03 +02:00
awesomerc.5.txt [doc] Fix some typos, modify a few descriptions 2008-04-11 07:34:45 +02:00
awesomerc.in [client] Merge focus{prev,next} and swap{prev,next} 2008-05-03 12:01:35 +02:00
client.c [client] Merge focus{prev,next} and swap{prev,next} 2008-05-03 12:01:35 +02:00
client.h [client] Merge focus{prev,next} and swap{prev,next} 2008-05-03 12:01:35 +02:00
config.c [config] Rename Key to keybinding_t 2008-05-03 12:01:05 +02:00
config.h [config] Rename Key to keybinding_t 2008-05-03 12:01:05 +02:00
configure.ac [build] Add glib dep 2008-05-03 12:01:06 +02:00
dbus.c [dbus] Implement widget.set method 2008-05-03 12:01:06 +02:00
dbus.h [dbus] Poll on dbus connection fd 2008-05-03 12:01:06 +02:00
event.c [config] Rename Key to keybinding_t 2008-05-03 12:01:05 +02:00
event.h Port Awesome to XCB 2008-05-03 12:00:59 +02:00
ewmh.c [awesome] Remove checking for value before p_delete()'ing memory 2008-05-03 12:01:35 +02:00
ewmh.h [client] Rename Client type to client_t 2008-05-03 12:01:03 +02:00
focus.c [tag] Rename Tag type to tag_t 2008-05-03 12:01:03 +02:00
focus.h [client] Rename Client type to client_t 2008-05-03 12:01:03 +02:00
layout.c [tag] Rename Tag type to tag_t 2008-05-03 12:01:03 +02:00
layout.h [uicb] Rename Uicb type to uicb_t 2008-05-03 12:01:03 +02:00
mouse.c [draw] Make draw_text using a const pointer to a style 2008-05-03 12:01:06 +02:00
mouse.h [uicb] Rename Uicb type to uicb_t 2008-05-03 12:01:03 +02:00
placement.c [client] Rename Client type to client_t 2008-05-03 12:01:03 +02:00
placement.h add under_mouse placement aglo 2008-02-13 18:14:34 +01:00
rules.c [awesome] Remove checking for value before p_delete()'ing memory 2008-05-03 12:01:35 +02:00
rules.h [tag] Rename Tag type to tag_t 2008-05-03 12:01:03 +02:00
screen.c [tag] Rename Tag type to tag_t 2008-05-03 12:01:03 +02:00
screen.h [client] Rename Client type to client_t 2008-05-03 12:01:03 +02:00
statusbar.c [statusbar] Rename Statusbar type to statusbar_t 2008-05-03 12:01:03 +02:00
statusbar.h [statusbar] Rename Statusbar type to statusbar_t 2008-05-03 12:01:03 +02:00
structs.h [config] Rename Key to keybinding_t 2008-05-03 12:01:05 +02:00
tag.c [tag] Rename Tag type to tag_t 2008-05-03 12:01:03 +02:00
tag.h [tag] Rename Tag type to tag_t 2008-05-03 12:01:03 +02:00
titlebar.c [draw] Make draw_text using a const pointer to a style 2008-05-03 12:01:06 +02:00
titlebar.h [client] Rename Client type to client_t 2008-05-03 12:01:03 +02:00
uicb.c [uicb] Use bool instead of int for returning status 2008-05-03 12:01:06 +02:00
uicb.h [uicb] Use bool instead of int for returning status 2008-05-03 12:01:06 +02:00
widget.c [dbus] Implement widget.set method 2008-05-03 12:01:06 +02:00
widget.h [dbus] Implement widget.set method 2008-05-03 12:01:06 +02:00
window.c [window] Fix possible memleak in window_setshape(), and remove useless ungrab() 2008-05-03 12:01:06 +02:00
window.h Port Awesome to XCB 2008-05-03 12:00:59 +02:00

README

awesome
=======
awesome is an extremely fast, small, and dynamic window manager for X.

Requirements
------------
In order to build awesome itself, you need header files and libs of:
  - Xlib, Xinerama, Xrandr
  - libconfuse >= 2.6
  - cairo
  - pango and pangocairo
  - glib
  - GTK+ or Imlib2 (use --with-imlib2 with ./configure)
  - dbus

In order to build the awesome man pages, you need these tools:
  - asciidoc (recent version)
  - xmlto (recent version)
  - docbook XSL stylesheets

In order to build the source code reference, you need these tools:
  - doxygen
  - graphviz

Building and Installation
-------------------------
If building from git sources, run "./autogen.sh". When autoreconf has
finished, you can follow the following instructions for building a dist
tarball.

After extracting the dist tarball, run "./configure --help" and figure out
what you might want to adapt for your system. Then run ./configure with the
proper parameters, and build and install:

  ./configure [...]
  make
  make install # might need root permissions

If you're using gcc as your compiler and do not want awesome's default set
of warning flags, add AWESOME_CFLAGS="" to your "make" lines.

The source code reference can be built with "make doc".

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.