#! /usr/bin/less
################################################################################

Program		: links+SDL patch
Version		: 0.1.3 for links-2.1pre15
Purpose		: SDL graphics driver for links web browser
License		: GNU GPL v2 (see file COPYING)
Author		: Samuel Behan <sam(at)frida.fri.utc.sk> (c) 2000-2004
Requirements	: links >= 2.1pre15, libSDL >= 1.2.x

################################################################################

---------
- ABOUT -
---------
	This patch add SDL graphics driver to links, so you can now use graphic links on 
  wide range of devices supported by libSDL.
  Well, i wrote this patch because i wanted to know how will graphic links look rendered 
  via aalib (http://aa-project.sourceforge.net/aalib) or caca (http://sam.zoy.org/projects/libcaca/).
  Unfortunately, it doesn't looks like i've imagined it, you can see it your self, run this:

		SDL_VIDEODRIVER=caca ./links -g -driver sdl

  to see links rendered via caca (if your libSDL has compiled-in support for it), or this:

		SDL_VIDEODRIVER=aalib ./links -g -driver sdl

  to see it rendered via aalib.

----------
- STATUS -
----------
	- most video function works fine & fast
	- there is problem about keyboard input, because SDL suplies only raw keyboard codes
		bypassing any actual key mappings in the system. I've created simple mapping
		that works for the most of keys but not for all, so be patient - i'm trying
		to find some good solution how to fix it
	- mouse wheel is not supported for now (easy to fix)
	- can not open more video windows at once
		possible solution:	- use in driver fork()/clone()
					- use virtual video devices, with only one visible at a time
						and switching beetwen them by some special hotkeys
	- video params can be currently set only via SDL enviroment vars (see file
		http://frida.fri.utc.sk/~sam/devel/links-sdl/sdl-env-vars)


-----------------
- BUG REPORTING -
-----------------
	If you find a bug report it to my email adress, i'll take a look.

---------------
- INSTALATION -
---------------
	* install libSDL if you already don't have it
	* download links		(http://freshmeat.net/projects/links/)
	* download links-sdl patch	(http://frida.fri.utc.sk/devel/links-sdl)
	* untar links
	* cd to links sources directory
	* apply patch

		$ patch -p1 <.......path_to_links-sdl_patch.patch

	* reconfigure links project
		
		$ echo yes | ./rebuild reconf

	* configure links for yours needs

		$ ./configure --my-special-options....

	* make the project

		$ make

	* try links with sdl

		$ ./links -g -driver sdl

			or with specific sdl driver

		$ SDL_VIDEODRIVER="directfb" ./links -g -driver sdl

	* and that's all folks.