Overview
~~~~~~~~

Installation procedure described here just reflects what I did. Probably
there are better ways to obtain the same results.

Reference System
~~~~~~~~~~~~~~~~

My reference system is debian 5.0. Patches are applied against

- linux-image-2.6.24-1
- xserver-xorg-video-ati 1:6.9.0-1 or newer
- xine-lib (1.1.16) or newer (HG)
- xineliboutput (1.0.2) or newer (CVS)

How to patch the kernel
~~~~~~~~~~~~~~~~~~~~~~~

- from top of kernel tree type

patch -p0 < vga-sync-fields/patches/drm-radeon-intel.patch

- then rebuild drm and radeon module

make drivers/char/drm/drm.ko drivers/char/drm/radeon.ko

- and copy drivers to /lib/modules directory

cp drivers/char/drm/drm.ko drivers/char/drm/radeon.ko /lib/modules/2.6.24-1-686/kernel/drivers/char/drm

- don't forget to copy the patched header file before building the tools

cp drivers/char/drm/radeon_drm.h /usr/include/drm/radeon_drm.h

- then reload the new modules

rmmod radeon
rmmod drm
modprobe radeon

How to patch the Xserver
~~~~~~~~~~~~~~~~~~~~~~~~

Before building the Xserver patched 'radeon_drm.h' must be copied (see above).

- get the newest ATI Xserver source, patch and build

apt-get -t experimental source xserver-xorg-video-ati
cd xserver-xorg-video-ati-6.9.0
patch -p1 < vga-sync-fields/patches/video-ati.patch
dpkg-buildpackage
dpkg -i xserver-xorg-video-radeon_6.9.0-1+lenny1_i386.deb

- alternatively if the Xserver has already been installed it's
  sufficient to copy Radeon DDX to it's destination

cp xserver-xorg-video-ati-6.9.0/obj-i486-linux-gnu/src/.libs/radeon_drv.so /usr/lib/xorg/modules/drivers/radeon_drv.so

How to get, patch, build and install the xine-lib
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

- first get a more recent xine-lib. Mine as of 2008-08-20 shows good results.

hg clone http://hg.debian.org/hg/xine-lib/xine-lib

- get it patched. The patch causes frame update intervals sent to the 
  Xserver much more evenly spaced. Which allows the soft-PLL to lock earlier.

cd xine-lib
patch -p1 < vga-sync-fields/patches/xine-lib.patch

- get it configured, built and installed

./autogen.sh
make
make install

How to build the tools
~~~~~~~~~~~~~~~~~~~~~~

Before building the tools patched 'radeon_drm.h' must be copied (see above).

The tools being found in tools directory are easily compiled as denoted
at the top of each single program. There is no Makefile yet.

Optional patch of radeonfb kernel module
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The standard radeonfb driver does not yet support interlaced mode nor does
it support low dot clocks as needed for RGB PAL. With this patch you
can use your TV-set as a computer monitor.

Before you apply the patch you should check what it does. It's quite easy. 
One part of the patch tries to patch kernels '.config'. This should be done 
rather manually via 'make menuconfig'.

- from top of kernel tree type

patch -p0 < vga-sync-fields/patches/radeonfb.patch

