Put documentation for each function in the header files, doxygen-compatible

Thanks to psychoschlumpf for the hint. Having comments in the headers
makes it easier to get the big picture when not being interested in the
source.

The doxygen file extracts as much as it can into HTML files. Please note
that this is not official/supported documentation, but rather being nice
to people who have to/want to use doxygen (I don’t).

Let me paste the header of the doxygen file:

  You can use this file with doxygen to create a pseudo-documentation
  automatically from source. doxygen-comments are not used very extensively
  in i3, mostly for the reason that it clutters the source code and has no
  real use (doxygen’s output looks really ugly).

  So, if you want to use it, here you go. This is however not a supported
  document, and I recommend you have a look at the docs/ folder or at
  http://i3.zekjur.net/ for more, real documentation.

Bugfix: Set focus to the client which was previously focused instead of the next client when moving windows

This fixes ticket #21

Bugfix: Don’t set focus if it is not necessary.

This fixes ticket #13

Implement scrolling on stack windows and on the bar. This implements ticket #18

Bugfix: Correctly remove client from container when moving to another workspace

This fixes ticket #16

Remove comment as popup menus in dzen2 get triggered by enter notify and focus is not needed

Bugfix: Apply workspaces to screens when Xinerama is turned off (Thanks Igor, Urs)

Bugfix: Don’t free xinerama-reply if it is NULL, implement FREE()-macro (Thanks Igor)

Debian package fixes (use ${misc:Depends}, close ITP, call dh_strip, correct spelling of metapackage)

Bugfix: Correctly filter out the numlock state bit (doesn’t get cleared for some reason)

This fixes ticket #14

Bugfix: When entering a stack window with the mouse, set the focus to the active client

Fixes ticket #17

Website: Sitemap should contain URLs without redirects

Fix robots.txt

Bugfix: Fix memory leak

Add sitemap.xml

Add meta tags to header

website: Add robots.txt, Link bugtracker

Add description to screenshot

Add screenshots to website

Update manpage

website: Link GPG-signature

Fix makefile to replace git-versions so tarball works without git

Update debian changelog

Update download page for release of 3.α

Cleanup makefiles, add version to i3 -v and i3 startup

Disable horizontal resizing for the release version, it still has bugs

Bugfix: re-decorate old client when switching screens

Bugfix: Only actively change focus if this is the current container

Implement clicking on the bar to switch workspaces

Bugfix: Fix rounding problems when positioning proportional windows

Bugfix: Query WM_NORMAL_HINTS when managing a window to handle proportional hints which were set before mapping

Implement kill-command to kill the current window, document it

Implement exit command, document it in manpage, add it to defaultconfig (Mod1+Shift+e)

Add docbook-xml as build dependency, revert last commit

Add -L to not invoke xmllint which fails on some systems because it can’t download the DTD

Send configure notify after putting a client into fullscreen mode, log at a central place

Update „Building i3 on Ubuntu 9.04” howto

Add imprint to the website for compliance with german law.

Add file PACKAGE-MAINTAINERS with hints for package maintainers

Update the overview of default bindings

Fix errors in i3.config, update manpage

Update website (menu, links to the documentation, manpage online)

Remove unused variable (fixes warning)

Update build-dependencies for debian

Fix fullscreen for xpdf (at least on debian, with proper _NET_WM_STATE hints)

xpdf sets the _NET_WM_STATE before actually mapping the window. i3 only checked
for changes of this hint, but not if it is already set when intially managing
the window.

Note that you need to patch your xpdf to support _NET_WM_STATE, because, while
only being reported at 2004, upstream still did not merge the patch *grrr*
See this debian bug report:
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=247602
Or directly download the patch from:
http://bugs.debian.org/cgi-bin/bugreport.cgi?msg=61;filename=31_fullscreen.dpatch;att=1;bug=247602

Fix compilation

Fake more configure notifies (makes xpdf work better)

More example code

Add some code to the presentation

Bugfix: Completely ignore legacy hints as soon as the client uses _NET_WM_NAME

Add slides for presentation at NoName e.V.

Add website for i3lock

Update debian/ to build a meta-package for i3

Move i3lock in its own repository

Handle legacy window titles by rendering them not unicode-compatible.

Implement cleaning up the list of ignored events

Fix misnomer (window_type_handler → handle_window_type), resolve TODO

Update config to use i3menu on Mod1+p, update Makefile to compile/install i3lock and i3menu

Move i3lock to src/i3lock, import dmenu-3.9 as i3menu

Implement moving containers, implement moving windows to the top if top-most, change config to use Mod3

Implement moving clients to the left if they are leftmost

Bugfix: Redecorate the last focused window of the container we are switching into

Bugfix: Don’t handle mouse click events inside the titlebar

Bugfix: Change the event mask to ignore enter notifies when rendering the layout and changing workspaces

Bugfix: Eliminate race condition, fix dock windows

There was a race condition when mapping a window and not setting the event mask
before. Therefore, the ReparentNotify and (more important) the UnmapNotify generated
by reparenting were not received, thus leaving the awaiting_useless_unmap variable
of the client "true". To just make it work, in previous commits the DestroyNotify
handler was introduced. Fortunately, with fixing this race condition by first
setting the event mask and mapping the window afterwards, we can remove this handler.

As for the dock windows, there were quite some occurences were client->container
was used without checking if the client is inside a container at all.

Furthermore, the client’s strut containing the space to reserve at the screen edge
is now checked and the desired height is set to the window’s height if the strut
contains 0 or if no strut was specified at all.

Ignore notify events which are not in mode XCB_NOTIFY_MODE_NORMAL

Fix warning (typecast)

Remove that stupid XBell() which gets triggered falsely when resuming suspend to RAM

Major change: Redirect events instead of handle the notifies.

By specifying XCB_EVENT_MASK_SUBSTRUCTURE_REDIRECT, the window manager
will get map request events instead of map notify events, and therefore
can act sooner (the window won’t be positioned on the screen and moved
afterwards).

Furthermore, this fixes some problems with GIMP/VLC (and probably others)
which caused endless loops.

Also, events which should be ignored are now saved in a queue rather than
saving just the last event. This should eliminate race conditions.

Note that there is a new FIXME in src/handlers.c. Some windows generate
unmap notify events when reparenting while others don’t. We need to
understand, document and implement a more correct way to handle this.

Make i3lock fork(), use white color and disable DPMS

The idea of fork()ing is to allow for aliases which first lock the screen,
then suspend.

White color and no DPMS is better than black color because you can tell the
difference between your notebook failed to suspend and it being locked.

Import slock-0.9 as i3lock

Fix warning

Bugfix: Handle all events when dragging to resize, correctly set OVERRIDE_REDIRECT

Bugfix: Draw bar at the correct position, handle expose events for bars

Bugfix: Correctly free containers, the bug was not freeing when not moving

Implement wrapping left/right/up/down across screens

Update comment

Bugfix: Use memcmp() instead of strcmp(), use new_len * 2 to check all bytes

Bugfix: Correctly free containers when shrinking the table

Bugfix: Don’t strcmp() if client->name == NULL

Convert window title to UCS-2 when updating it, don’t update it if it didn’t change

s/atomar/atomic

Bugfix: Use a new variable called new_position and initialize it correctly when resizing

Use -idirafter which is the same as -I but first looks at the standard system headers

As iconv(3) is in NetBSD’s libc but the GNU version can be installed to /usr/pkg, searching
/usr/pkg/include before /usr/include (standard behaviour with -I) is not a good idea.

Fix race condition when updating client->name

Bugfix: Use _NET_WM_NAME (UTF-8) rather than WM_NAME (COMPOUND_TEXT). Only render client titles, if they are set

Fix the warning on SUS-compatible systems (char**) and on NetBSD (const char**)

Fix warnings, update DEPENDS, update Makefile for NetBSD

Update default config/manpage

Implement UTF-8-clean window titles

More work on hacking-howto

Some more work on docs/hacking-howto

Don’t start a terminal on startup

Bugfix: Correctly place new windows while other windows are in fullscreen mode

Fix some bugs found by using raster’s wm_torture

Add how to hack guide, first version

Bugfix: Correctly check for empty containers and unmap the stack_win

Don’t set focus outside of the current container

Bugfix: Should be workspace 10 not 0 in moving aswell

Bugfix: Should be workspace 10 not 0