remove redundencies in the Doxygen documentation.

parameter to do what both functions did before, and even more.

and simplified the handle_resize() API. Still can be polished.

files. Phew. Now they just need a few comments.

properly credited authors and documented a few things.

broken, and event handling is not yet in the driver-specific files, but
    I will of course fix that later.

* Renamed caca_refresh() into caca_display() which makes more sense.
  * Optimised gl_bgpal by directly storing floats instead of doing the
    conversion at runtime.
  * Handle resizing in cucul_set_size() and try to keep as much information
    as possible from the previous canvas.
  * Moved most global variables into cucul_t or caca_t contexts.
  * Moved time.c into libcaca.

of unicode letters) is now separated from the higher level rendering and I/O
(that is, libcaca). This commit totally breaks the API, but once everything
is polished I will think about source-level backward compatibility. Most
drivers are broken, but X11 still sorta works.

  The new design is much more object-oriented and allows having several
active renderers at the same time, changing renderers on the fly, and more
important, having no renderer at all (useful for converters, or when you
want to do your own renderer).

  And in case you are still wondering, the libcucul acronym has "Unicode"
because I want to support at least a subset of Unicode. There are awesome
glyphs in it, including the ones inherited from Codepage 437 such as
"gray 25%" that are used in DOS and Win32 ANSI art.

+ Check for curses.h as well as ncurses.h.
  * src/caca.c src/event.c src/graphics.c:
    + Include curses.h if ncurses.h was not found.

+ Fixed a buffer overflow due to bad signed/unsigned handling.
  * src/event.c:
    + Disallow zero width or height in the X11 driver.
    + Fixed resizing in ncurses and slang.
  * THANKS:
    + Added the Source Mage maintainer.

+ When resizing under X11, copy the old pixmap to the new one.
  * examples/cacaview.c:
    + Resizing support.

+ Refresh the X11 window when an exposure event is received.
    + When resizing the X11 window, start showing extra characters when two
      thirds are visible.

+ Make sure the mouse coordinates stay within the screen boundaries even
      if the window was resized.
  * src/bitmap.c:
    + Fixed a buffer underflow in the rendering routine that caused the bottom
      and rightmost pixels to be missed in certain conditions.
    + Minor speed optimisation.

+ The ncurses and S-Lang drivers properly return CACA_EVENT_RESIZE.
  * test/event.c:
    + Display CACA_EVENT_RESIZE.

+ Added the CACA_EVENT_RESIZE event.
    + Added caca_get_mouse_x() and caca_get_mouse_y().
  * src/graphics.c:
    + Window resize handling in the X11 driver.
  * examples/aafire.c:
    + Fixed a bad assumption in the resize handling code.

+ Fixed a typo preventing Win32 builds.
  * src/event.c:
    + Renamed io.c into event.c.
  * THANKS:
    + Added Gentoo, NetBSD and FreeBSD porters.

+ Native win32 port.

+ Check for gettimeofday().
  * src/time.c:
    + Created _caca_time().
    + Ported _caca_getticks() to the Win32 API.
  * src/caca.c:
    + Properly builds on Win32.
  * test/event.c:
    + Added <stdlib.h> because we use malloc().

+ Initialise the char buffers in the X11 driver.
  * src/io.c:
    + caca_get_event() and caca_wait_event() immediately return zero if
      event_mask is zero.
    + Added support for the Home, End, PgUp and PgDown keys.
    + In the S-Lang driver, added a call to SLang_getkey() before the call to
      SLkp_getkey(), otherwise a single Escape call will not be interpreted.
  * test/event.c:
    + The "quit" sequence now quits the program, instead of "q" alone.
    + Added a status bar below.

+ Do not refresh after each event, but only when there is no event
      pending.
    + If the pressed key is a printable character, display it.
  * src/time.c:
    + Moved _caca_getticks() to this file.
  * src/caca.c:
    + Set the escape delay to a very low value in the ncurses driver,
      because I don't want escape sequences to be entered manually.
  * src/io.c:
    + Autorepeat emulation in the ncurses and slang drivers: do not
      immediately send the key release event.
  * configure.ac:
    + Check for usleep.
    + Improvements in the win32 platform detection.

+ Use SLkp_getkey instead of SLang_getkey so that escape sequences are
      directly interpreted.
    + Major rehandling of the event code. All output drivers are now
      correctly separated.
  * src/graphics.c:
    + Fixed a compilation warning.
  * test/event.c:
    + More human-readable event printing.

+ Do not report mouse motions if the coordinates did not change.
  * src/bitmap.c:
    + More documentation.

+ Small event lister, similar to X11's xev.
  * src/graphics.c:
    + If possible, disable autorepeat in the X11 driver.
  * src/io.c:
    + Implemented CACA_EVENT_MOUSE_RELEASE in all drivers.
    + Button number support in CACA_EVENT_MOUSE_{PRESS,RELEASE}.

+ Updated the package descriptions to include cacaball.
  * doc/cacademo.1 doc/Makefile.am:
    + Use the cacademo manpage as the cacaball manpage.
  * src/:
    + Added #ifdef _DOXYGEN_SKIP_ME here and there to prvent Doxygen from
      documenting bizarre stuff.

+ caca_get_event() and caca_wait_event() now accept a mask as an argument
      in order to select events.

+ Fixed a bug that caused ButtonRelease events to be forgotten under X11.
  * examples/cacaview.c:
    + Use <stdlib.h> instead of <malloc.h>.

+ Search for <slang/slang.h> in addition of <slang.h>.

+ Removed caca_internal.h from the list of documented files.
  * src/:
    + Minor documentation updates.

+ Fixed mouse support under ncurses and slang.

+ Mouse support under X11.
    + Split the mouse motion and mouse click events.
  * examples/demo.c:
    + Mouse motion support.

+ Mouse support in the X11 driver.

+ Fixed a warning by including <unistd.h>.
    + Support for arrow and function keys under X11.

+ Added caca_wait_event(), a blocking caca_get_event().
  * src/ examples/:
    + More documentation.
  * doc/doxygen.cfg.in:
    + doc/doxygen.cfg is now generated by configure, so that we can use
      @top_srcdir@ and we no longer need to hardcode PROJECT_NUMBER.
    + Create manpages.

+ Support for simultaneously compiled-in drivers.
    + Honour the CACA_DRIVER environment variable.
  * configure.ac:
    + Drivers are no longer mutually exclusive.

+ Support for CACA_WIDTH, CACA_HEIGHT and CACA_FONT in the x11 driver.
    + Use an intermediary X pixmap for rendering.
    + Slightly changed the variable naming scheme.