Go to file
Pierre Habouzit 1bdf22f631 Add stricter warnings wrt prototypes.
And add the missing static's it found.

Signed-off-by: Pierre Habouzit <madcoder@debian.org>
Signed-off-by: Julien Danjou <julien@danjou.info>
2008-07-01 08:12:22 +02:00
build-utils atoms: autogenerate atom list 2008-06-30 20:05:53 +02:00
common xembed: remove useless comments 2008-06-30 20:15:46 +02:00
icons Added magnifier icons. 2008-06-14 00:03:04 +02:00
layouts client: honor size hints is now by client 2008-06-25 15:42:07 +02:00
lib textbox: use newindex API 2008-06-27 20:24:30 +02:00
widgets Add stricter warnings wrt prototypes. 2008-07-01 08:12:22 +02:00
.gitignore update ignore list 2008-06-30 21:59:21 +02:00
AUTHORS update AUTHORS file 2008-06-26 22:01:09 +02:00
BUGS BUG's page 2008-04-18 19:33:58 +02:00
CMakeLists.txt atoms: autogenerate atom list 2008-06-30 20:05:53 +02:00
LICENSE chance license to GPLv2 2007-09-12 14:29:51 +02:00
README "recent version" has no mean 2008-06-24 22:30:46 +02:00
STYLE Fix STYLE file to reflect current style [CORRECTIVE] 2008-03-24 07:49:33 +01:00
awesome-client.1.txt Revert "Replace tags by workspaces" 2008-06-09 21:56:03 +02:00
awesome-client.c comments fixing 2008-06-20 08:38:00 +02:00
awesome-version-internal.h.in cmake: consolidate version strings 2008-06-22 22:13:06 +02:00
awesome.1.txt [manpage] Update 2008-06-11 09:56:19 +02:00
awesome.c atom: new atom infra 2008-06-30 18:25:01 +02:00
awesome.doxygen.in cmake: configure awesome.doxygen 2008-06-19 22:28:47 +02:00
awesomeConfig.cmake Add stricter warnings wrt prototypes. 2008-07-01 08:12:22 +02:00
awesomerc.5.txt widget: new widget index method 2008-06-26 16:35:07 +02:00
awesomerc.lua.in lua: replace .new() by __call meth 2008-06-30 14:11:54 +02:00
client.c atoms: add all used atoms 2008-06-30 18:55:14 +02:00
client.h If awesome believes we have the focus, well, do not unfocus ourselves. 2008-06-27 09:34:47 +02:00
cnode.c comments fixing 2008-06-20 08:38:00 +02:00
cnode.h [focus] Split client_node functions out 2008-05-25 18:12:27 +02:00
config.h.in cmake: consolidate version strings 2008-06-22 22:13:06 +02:00
dbus.c remove useless #include 2008-06-26 18:10:45 +02:00
dbus.h Plug dbus in the event loop. 2008-06-16 23:51:07 +02:00
event.c Hide keybindings away 1/2 2008-07-01 08:12:22 +02:00
event.h Make event handler setup private to the event module. 2008-06-26 22:47:56 +02:00
ewmh.c atoms: add all used atoms 2008-06-30 18:55:14 +02:00
ewmh.h atom: new atom infra 2008-06-30 18:25:01 +02:00
focus.c Revert "Replace tags by workspaces" 2008-06-09 21:56:03 +02:00
focus.h Revert "Replace tags by workspaces" 2008-06-09 21:56:03 +02:00
keybinding.c Hide keybidings_t away, subsequent simplifications 2/2 2008-07-01 08:12:22 +02:00
keybinding.h Hide keybidings_t away, subsequent simplifications 2/2 2008-07-01 08:12:22 +02:00
keygrabber.c Simplify keygrabber. 2008-06-30 00:47:11 +02:00
keygrabber.h [keygrabber] Fix key mapping 2008-06-10 22:37:45 +02:00
layout.c remove useless #include 2008-06-26 18:10:45 +02:00
layout.h Revert "Replace tags by workspaces" 2008-06-09 21:56:03 +02:00
lua.c draw: xcolor_t store color name 2008-06-28 13:30:17 +02:00
lua.h lua: remove luaA_name_init 2008-06-30 13:50:49 +02:00
mouse.c lua: replace .new() by __call meth 2008-06-30 14:11:54 +02:00
mouse.h [client] Rework raise and mouse stuff 2008-05-26 18:08:29 +02:00
placement.c remove useless #include 2008-06-26 18:10:45 +02:00
placement.h placement: rename FloatingPlacement to floating_placement_t 2008-06-15 10:55:07 +02:00
screen.c screen: merge tag_client_with_current_selected() code 2008-06-27 23:00:20 +02:00
screen.h Revert "Replace tags by workspaces" 2008-06-09 21:56:03 +02:00
stack.c ewmh: add support for _NET_CLIENT_LIST_STACKING 2008-06-17 21:47:57 +02:00
stack.h [client] Add proper stacking support 2008-05-25 19:32:30 +02:00
statusbar.c lua: replace .new() by __call meth 2008-06-30 14:11:54 +02:00
statusbar.h lua: userdata_new is now macro 2008-06-18 18:31:35 +02:00
structs.h Hide keybindings away 1/2 2008-07-01 08:12:22 +02:00
systray.c atoms: add all used atoms 2008-06-30 18:55:14 +02:00
systray.h systray: add KDE work around 2008-06-30 13:06:23 +02:00
tag.c lua: replace .new() by __call meth 2008-06-30 14:11:54 +02:00
tag.h screen: merge tag_client_with_current_selected() code 2008-06-27 23:00:20 +02:00
titlebar.c lua: replace .new() by __call meth 2008-06-30 14:11:54 +02:00
titlebar.h lua: userdata_new is now macro 2008-06-18 18:31:35 +02:00
widget.c atoms: add all used atoms 2008-06-30 18:55:14 +02:00
widget.h widget: new widget index method 2008-06-26 16:35:07 +02:00
window.c Hide keybindings away 1/2 2008-07-01 08:12:22 +02:00
window.h Hide keybindings away 1/2 2008-07-01 08:12:22 +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, xcb and xcb-util.
  - Lua 5.1
  - cairo
  - pango and pangocairo
  - libev
  - glib
  - GdkPixBuf or Imlib2 (use -DWITH_IMLIB2=1 with cmake)
  - dbus (optional, use -DWITH_DBUS=0 with cmake to disable)
  - gperf

In order to build the awesome man pages and documentation,
you need these tools:
  - asciidoc
  - xmlto
  - docbook XSL stylesheets
  - luadoc

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

Building and Installation
-------------------------
After extracting the dist tarball, run:

  cmake .
  make
  make install # might need root permissions

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.lua file.
An example is provided in the sources.