Documentation cleanups

Rework the readme, and delete the now woefully out of date man pages.
Also update the TODO file with more interesting information.

1 files changed, 35 insertions, 862 deletions

diff --git a/README b/README
index 22cc517..b1932f0 100644
--- a/README
+++ b/README
@@ -1,878 +1,51 @@
-AMD Geode(TM) LX/GX Processor Xorg Display Driver - Release Notes
-Version 04.00.00-01
-June 18, 2006
+AMD Geode GX and LX Xorg graphics Driver
+May 9, 2007
+========================================
 
---------------------------------------------------------------------------------
-PRODUCT INFORMATION
---------------------------------------------------------------------------------
-- This driver is the Xorg Display Driver for the AMD Geode(TM) Geode LX and 
-  GX processors
+= Introduction =
 
-This product is avaiable as a standalone patch comprising:
-	Graphics_LinuxXorg_Common_03.00.0101.patch
-	README.txt (this file)
+This is the X graphics driver for the AMD Geode GX and LX processors.
+The GX driver features XAA and EXA support for graphics acceleration,
+and the LX driver supports EXA (including compositing).  Both drivers
+suppport dynamic rotation with XRandR, and Xv overlay support.
 
-or as a tarball Graphics_LinuxXorg_Common_03.00.0101.tar.gz containing:
-	Graphics_LinuxXorg_Common_03.00.0101.patch
-	xorg.conf_lx
-	xorg.conf_gx
-	README.txt (this file)
+= Configuration options =
 
-The patch adds the following documenation to the Xorg tree:
-xc/programs/Xserver/hw/xfree86/drivers/amd/amd.man
-xc/programs/Xserver/hw/xfree86/drivers/amd/gfx/release.txt (GX only)
-xc/programs/Xserver/hw/xfree86/drivers/amd/panel/readme.txt (GX only)
+You can specify the AMD driver in the normal fashion:
 
-The following example files are provided in the tarball release only
-	xorg.conf_lx
-	xorg.conf_gx
-
-For bugs, patches, and info requests, please subscribe to:
-info-linux@geode.amd.com
-
-To subscribe, send a blank message to:  info-linux-subscribe@geode.amd.com
-	
-Features
---------
-The AMD Geode Linux Xorg driver implements Xorg XAA driver interface.
-Through a hardware abstraction layer called Durango (GX) and Cimarron (LX),
-the full accelerated functionality of the graphics processor is exposed to
-the driver.
-
-The AMD Geode Xorg driver implements:
-
- - Xv video overlay extension support 
- - Geode hardware color-space conversion 
- - V4L2 overlay functionality (Geode LX processor only)
- - Rotated graphical output
- - DDC support
- - DPMS support
- - Common X.org patch support both Geode LX and GX processors
-
-Dependencies
-------------
-This release depends on and includes the following subcomponents:
-
-Linux Build Tool - Base GeodeLinux Build System - Version 00.00.0021
-Linux Build Tool - AMD Embedded - Version 00.00.0022
-Linux Build Tool - Bitbake engine - Version 00.00.0011
-Linux Build Tool - Openembedded - Version 00.00.0008
-
-
-Functional Changes
-------------------
-_____________________________________________________________________________
-Change: 78946
-_____________________________________________________________________________
-Add multiple BUILDCONFIG functionality to Tinderbox glue.
-
-_____________________________________________________________________________
-Change: 79682
-_____________________________________________________________________________
-Initial add of LinuxBIOSv2 source tree to Perforce. This code base matches
-upstream SVN version 2296. Add P4MOD BOMs and Tinderbox configuration/linuxbios-
-devel GeodeLinux targets.
-
-_____________________________________________________________________________
-Change: 81342
-_____________________________________________________________________________
-mplayer: enable qtx, opengl, libdvd, and alsa. xorg: enable Xft and Xinerama
-icewm: configure and .bb patches for identifying correct X includes/libs
-
-_____________________________________________________________________________
-Change: 80914
-_____________________________________________________________________________
-Add a klocwork DISTRO and some task-*-klocwork meta files to define the
-projects to build for klocwork. Move KWBUILD to the configuration file. Add
-some klocwork report generation to klocwork.bbclass.
-
-_____________________________________________________________________________
-Change: 80794
-_____________________________________________________________________________
-klocwork.bbclass updates to support client/host and build renaming. Add a
-draft nightly build script for klocwork builds. Only those .bb files with
-KWBUILD=1 will be built here. Add COMPATIBLE_HOST for geode .bb files.
-virtual/geode-aes must point to linux-geodelx with 2.6.16 now that this
-is integrated. recent gcc-sdk-native changes were resulting in empty
-packages. Revert and disable task-compilers from validation-image for
-swval until this can be repaired.
-
-_____________________________________________________________________________
-Change: 79683
-_____________________________________________________________________________
-Release and devel .bb files for linuxbios pass build on morlock.
-
-_____________________________________________________________________________
-Change: 81340
-_____________________________________________________________________________
-Add libxinerama to xorg 6.8.1 config for icewm. xscreensaver depends upon intltool-
-native. Use '/usr/bin/env perl' as intltool-* interpreter.
-
-_____________________________________________________________________________
-Change: 81186
-_____________________________________________________________________________
-Add geodelx-6.8.1 machine for norwich validation on 2.6.16+xorg6.8.1. Leave
-geodelx machine at X11R7.0 because upgrade to X11R7.1 is imminent. Move x11
-clients from validation-image to task-xorg because the packages differ
-between 6.8.1 and 7.0. Add p4 binaries to validation-image. Add icewm to
-validation-image.
-
-_____________________________________________________________________________
-Change: 80319
-_____________________________________________________________________________
-* Cleanup X11R6.8.1 PROVIDERS for 'gentoo' builds.
-        * Created a new .bb file to correctly handle the 'gentoo'->other
-          branch of validationtests.
-        * ztv for 2.4.24 depends upon libxv as well
-        * Add 'Kernel Build Directory' to /etc/openembedded/version for gcov
-          builds so that GCOV_PREFIX environment variables may be used
-          effectively.
-        * disable ica-bin download error in amd/packages/ica because we have
-          this downloaded to the internal mirror morlock.
-
-_____________________________________________________________________________
-Change: 80637
-_____________________________________________________________________________
-add project/geodelx/unittest/ and configuration files
-
-_____________________________________________________________________________
-Change: 80373
-_____________________________________________________________________________
-libxft and libxrandr PROVIDERS for geodelx and dimsum are X11R7.0. configure
-proxy variables in environment rather than command line for LSF builds.
-
-_____________________________________________________________________________
-Change: 79322
-_____________________________________________________________________________
-dimsum cleanup.
-
-_____________________________________________________________________________
-Change: 80630
-_____________________________________________________________________________
-Disable CCACHE for gcov builds so gcda files go to the correct location.
-
-_____________________________________________________________________________
-Change: 80370
-_____________________________________________________________________________
-Merge with OE snapshot from 2006/06/02:
-http://eloi.amd.com/openembedded/oe/oe_20060602030001.tgz
-
-and Bitbake version 1.4.2: http://eloi.amd.com/openembedded/bitbake/bitbake-
-1.4.2.tar.gz
-
-_____________________________________________________________________________
-Change: 80969
-_____________________________________________________________________________
-Propegate 80912 to local.rules for other images. Add x11perf, xclock, xvinfo,
-rdesktop, and xpandmodes to validation-image. Add xvtest to amdtools RDEPENDS
-so that it makes it to the image.
-
-_____________________________________________________________________________
-Change: 78809
-_____________________________________________________________________________
-Update task-compilers. This appears to build the 2.6.16 kernel OK (save
-storage requirements for object files). Im adding this to the validation-
-image for a quick build on LSF. Next, I will make this an optional package.
-
-_____________________________________________________________________________
-Change: 79843
-_____________________________________________________________________________
-Merge //drivers/buildroot/geodelinux/...@79818 and
-//depot/tools/buildroot/geodelinux/...@51650.
-
-_____________________________________________________________________________
-Change: 79588
-_____________________________________________________________________________
-Merge //drivers/buildroot/geodelinux/...@79560 and
-//depot/tools/buildroot/geodelinux/...@51580
-
-_____________________________________________________________________________
-Change: 81291
-_____________________________________________________________________________
-Add serf for 2.6.11 to OE and Gentoo.
-
-_____________________________________________________________________________
-Change: 81312
-_____________________________________________________________________________
-intltool-native perl script use #/usr/bin/env perl interpreter. more validation-
-tests postinst updates. Update PREFERRED_PROVIDERS for devel targets to
-geode-v4l2lx-devel. Leave release at linux-geodelx until we have a release
-to replace it with.
-
-_____________________________________________________________________________
-Change: 79362
-_____________________________________________________________________________
-PBz#8158: Add /etc/modules.autoload.d/kernel-2.6 file including lxv4l2 to
-2.6.11, 2.6.15, and 2.6.16 Gentoo kernel builds. Add lxv4l2 to autoload list
-for processing by kernel.bbclass for GeodeLinux kernel builds. Add /etc/udev/rules.d/10-
-local.rules file for symlinking videox -> video0 at hotplug event for Gentoo.
-Update /etc/udev/local.rules file for symlinking videox -> video0 at hotplug
-event for GeodeLinux.
-
-_____________________________________________________________________________
-Change: 78909
-_____________________________________________________________________________
-Patches for $ 'cross' compile. Gentoo and Debian store 32bit libraries in
-/lib32 and 64bit in /lib64. There are apparently two standards for this, but
-I'm patching gcc to follow Gentoo/Debian multilib convention. This is still
-giving a build failure in libstdc++-v3, however, pulling in multilib
-libraries.
-
-_____________________________________________________________________________
-Change: 81109
-_____________________________________________________________________________
-Remove xterm from validation-image. Symlink rxvt -> xterm instead. Replace
-eog with gqview in validation-image. Remove AMD_DRIVER_VERSION mangling from
-klocwork.bbclass. Add defconfig for klocwork kernel build.
-
-_____________________________________________________________________________
-Change: 81004
-_____________________________________________________________________________
-Move to libtool 1.5.22. Appears to resolve some obscure cross-linking issues.
-klocwork.bbclass - mipsel analysis was failing due to $ definition from
-project name to build name. If AMD_DRIVER_VERSION is defined, prefix project
-name with amd_, otherwise oe_ Add task kwinstall for installing report files.
-Add .bb files for X11R7.0 75DPI fonts. Add font-bh-75dpi to task-xorg Add xf86-video-
-vga to task-org as a fallback. Add xauth to validation-image Update default
-xorg.conf. z4l has been renamed to ztv. Add Eye of Gnome image viewer to validation-
-image. This depends upon *alot* of gnome, so it should be replaced or gnome
-should take over matchbox as session manager.
-
-_____________________________________________________________________________
-Change: 80378
-_____________________________________________________________________________
-Mesa compiles using the correct compiler. Remove redundant files from glib-
-2.0 packaging. More DEPENDS and site-packages.conf cleanup. Disable exclusive
-bsub for now. gcov-tools listed twice in validation-image.
-
-_____________________________________________________________________________
-Change: 80372
-_____________________________________________________________________________
-syslinux was moved upstream. Add to site-packages.conf.
-
-_____________________________________________________________________________
-Change: 80359
-_____________________________________________________________________________
-Add matchbox and xterm to validation-image. Replaces xfce. Add ica-bin-9.0,
-but this is broken until openmotif builds.
-
-_____________________________________________________________________________
-Change: 79975
-_____________________________________________________________________________
-Add perl and python to validation-image. record-play and pio_check use perl.
-pixel-depth and i2cval use python.
-
-_____________________________________________________________________________
-Change: 79680
-_____________________________________________________________________________
-Move GeodeLinux to ldcperforce1.
-
-_____________________________________________________________________________
-Change: 78811
-_____________________________________________________________________________
-Disable task-compilers in validation-image by default.
-
-Unit Test 
----------
-_____________________________________________________________________________
-Change: 81004 : Move to libtool 1.5.22. Appears to resolve some obscure cross
-_____________________________________________________________________________
-HOST_ARCH definition. Move $PN
-
---------------------------------------------------------------------------------
-VALIDATION ENVIRONMENT
---------------------------------------------------------------------------------
-Validated on AMD Geode(TM) Norwich Development Board - Rev 2 Rework H and
-Rev 3 Rework E with:
-	
-Processor:		AMD Geode LX processor, silicon rev. C1 @ 433 MHz
-Chipset:		AMD Geode CS5536 companion device, silicon rev. B1
-PCI Bus Speed:		66 MHz
-Memory:			256 MB PC3200 RAM
-CRT:			NEC MultiSync FP2141SB
-Flat Panel:		Samsung LTM213U3-L07 1600x1200 2-channel LVDS,
-Keyboard/Mouse:		PS/2 on Moray 1.1
-	
-BIOS:			GeodeROM 1.06.06
-Operating System:	Gentoo 2005.0
-Kernel:			v2.6.11
-Kernel Patch:		LX Kernel Patch v02.02.0100
-Graphics Driver:	LX Xorg Graphics driver v03.00.0100
-Audio Driver:		5536 ALSA Audio driver v01.00.0500
-AES Driver: 		LX AES driver v02.01.0100
-AccessBus Driver: 	LX ACB Driver v01.00.0401
-Video4Linux2 Driver: 	LX Video4Linux2 driver v03.02.0100
-Other Software:		N/A
-
---------------------------------------------------------------------------------
-INSTALLATION INSTRUCTIONS  
---------------------------------------------------------------------------------
-Acquire Xorg Tarball from the Xorg web site:
-http://www.x.org/X11R6.8.1/
-
-For more information on X.org:
-http://xorg.freedesktop.org/wiki/
-
-Acquire Graphics_LinuxXorg_Common_03.00.0100.patch
-
-Unpack Xorg Tarball
-Patch the Source
-Make Xorg
-Construct Install
-Apply Install image
-
-for example:
-  # tar -xzf X11R6.8.1-src.tar.gz
-  # cd xc
-  # patch -p1 < Graphics_LinuxXorg_Common_03.00.0100.patch 
-  # cp config/cf/xorgsite.def config/cf/host.def
-
-Edit config/cf/host.def
-uncomment the line:
-
-#define BuildSpecsDocs		No
-
-Add the line (directly following the above line)
-
-#define InstallHardcopyDocs	No
-
-  # make World
-  # mkdir <install_path>
-  # make DESTDIR=<install_path> install install.man
-  # tar -C <install_path> -czf <path>/xorg-x11-geode.tgz .
-      move xorg-x11-geode.tgz to the target system
-      login as root on the target system and make path to tarball available
-  # tar -C / -xzpf <path>/xorg-x11-geode.tgz
-  # mv /etc/X11/xorg.conf /etc/X11/xorg.conf.orig
-  # cp <path>/xorg-<gx/lx>.conf /etc/X11/xorg.conf
-
-
-++++++++++++++++++++++++++++++++++++++++++++++++++
-AMD Geode(TM) LX processor Xorg.conf Specification
-++++++++++++++++++++++++++++++++++++++++++++++++++
-
-Linux Xorg AMD GeodeLX Processor Configuration Specification
-
-
-The AMD Geode driver supports an accelerated interface to the
-hardware access layer for the graphical devices (cimarron library).
-To operate this API with a widely, a set of operational customizations
-were added to the xorg.conf configuration file.  These specifications
-for the most part are passed unmodified to cimarron.  This document
-only provides an overview of the customizations to the standard
-configuration file definitions.
-
-The xorg configuration (xorg.conf) file usually exists in the system
-configuration directory /etc/X11.  The standard contents are documented
-in the manual pages, and can typically be accessed using:
-man XF86Config
-The file is divided into "sections".  The following information
-illustrates the custom features added section by section.
-
-
-1. Device section:
-
-The devices section specifies the graphics driver selection.  Currently,
-for the drivers that may be specified include:
 Section "Device"
-        Identifier  "DevId"
-        Driver      "vesa"   - or
-        Driver      "fbdev"  - or
-        Driver      "amd"
-...
-EndSection
-
-The "vesa" and "fbdev" selections are documented by the manual pages
-man fbdev   - or
-man vesa
-The "amd" driver has many selections that can be used to operate
-the interface configuration.  These selections follow:
-
-
-2. Hardware Accelerations:
-
-This set of options are standard to the xorg "xaa" accelerations.
-The presents of the option disables the named functionality.
-Note that many accelerations depend on combinations with others,
-and so disabling one may have a more pervasive effect.
-
-        Option "XaaNoCPUToScreenColorExpandFill"
-        Option "XaaNoColor8x8PatternFillRect"
-        Option "XaaNoColor8x8PatternFillTrap"
-        Option "XaaNoDashedBresenhamLine"
-        Option "XaaNoDashedTwoPointLine"
-        Option "XaaNoImageWriteRect"
-        Option "XaaNoMono8x8PatternFillRect"
-        Option "XaaNoMono8x8PatternFillTrap"
-        Option "XaaNoOffscreenPixmaps"
-        Option "XaaNoPixmapCache"
-        Option "XaaNoScanlineCPUToScreenColorExpandFill"
-        Option "XaaNoScanlineImageWriteRect"
-        Option "XaaNoScreenToScreenColorExpandFill"
-        Option "XaaNoScreenToScreenCopy"
-        Option "XaaNoSolidBresenhamLine"
-        Option "XaaNoSolidFillRect"
-        Option "XaaNoSolidFillTrap"
-        Option "XaaNoSolidHorVertLine"
-        Option "XaaNoSolidTwoPointLine"
-
-Certain hardware accelerations may be armed or disarmed by using:
-
-        Option "HWcursor"    (default)  -or
-        Option "SWcursor" 
-
-        Option "Compression" (default)  -or
-        Option "No Compression"
-
-
-Additionally, all accelerations may be armed or disarmed using:
-
-        Option "Accel"       (default) -or
-        Option "No Accel"
-
-This option enables/disables all rendering accelerations, HW/SW cursor,
-and display compression.  Certain accelerations may not be armed, even
-though they are inferred by the configuration, if video memory is in
-short supply.
-
-
-3. Modes section:
-
-The configuration file included with the driver delivery contains an
-optional "modes" section.  This section asserts all of the standard
-graphics/video mode configuration data.  This set of modes is a subset
-of the mode data in the cimarron library.  Because these modes are
-included, they are passed to the cimarron driver for validation.  Be
-aware that cimarron will select modes using a filtering function that
-uses a constrained distance search.  The mode in cimarron's definitions
-that is "closest" to a mode defined - either builtin or user supplied -
-will normally be used by cimarron.  
-
-This filtering effect can be factored out by specifying:
-
-       Option "CustomMode"
-
-This has the effect of causing the mode validation to pass any mode
-in the mode pool, and allowing the selection of the specified mode
-during mode switch.  Unfortunately, because the interface specification
-is not complete enough to support video modes.  Only video modes that
-exist in cimarron are possible when selecting a TVOUT mode.
-
-
-4. More "Device" section Options:
-
-Since flat panels have fixed timing - that is, only one "real" mode -
-the mode switch operation that normally might select a wide variety
-of operational states must "adjust" the mode selection to fit the
-fixed panel timing.  To communicate that the mode selection is for
-a flat panel, use:
-       Option "FlatPanel"
-Note that the code expects that the flat panel will have been already
-selected by the BIOS setup.  Conflicts produce configuration errors.
-The size adjustment usually involves scaling the source buffer
-dimensions to the raster image size supported by the flat-panel.  The
-hardware supports this scaling operation transparently, and normally
-no special considerations are needed.  The hardware scaling is limited
-to modes with horizontal aspects of less than 1024 pixels (buffer size
-limitation for scaling/filtering).
-
-The display may be "rotated" in three ways, ClockWise, Upside-Down and
-CounterClocwise using:
-       Option "Rotate" "CW"
-       Option "Rotate" "Invert"
-       Option "Rotate" "CCW"  
-This is accomplished using a "shadow" frame buffer, and using either
-a hardware or software operation to transform the image to the
-operational display buffer.
-
-Even though there is not strategic advantage, if you wish to use a
-shadow frame buffer and display the unrotated image - this is specified
-by using:
-
-       Option "ShadowFB" 
-
-
-5. TVOUT video modes.
-
-In order to enable TVOUT mode selection, a TV known encoder
-must be selected in the following way:
-       Option "TV_Encoder" "ADV7171"   -or
-       Option "TV_Encoder" "SAA7127"   -or
-       Option "TV_Encoder" "FS454"     -or
-       Option "TV_Encoder" "ADV7300"
-There is no default for the encoder.  This selection is mandatory
-to enable TVOUT modes.
-
-Most encoders support a variety of bus formats.  Similarly, the
-amd driver can select the bus data format from the following list:
-       Option "TV_Bus_Fmt" "disabled"       - VOP output is disabled
-       Option "TV_Bus_Fmt" "vip1_1"         - VIP 1.1
-       Option "TV_Bus_Fmt" "ccir656"        - CCIR 656 output
-       Option "TV_Bus_Fmt" "vip20_8bit"     - 8-bit VIP 2.0 output
-       Option "TV_Bus_Fmt" "vip20_16bit"    - 16-bit VIP 2.0 output
-       Option "TV_Bus_Fmt" "601_yuv_8bit"   - 601 output, 8-bit YUV 4:2:2
-       Option "TV_Bus_Fmt" "601_yuv_16bit"  - 601 output, 16-bit YUV 4:2:2
-       Option "TV_Bus_Fmt" "601_rgb_8_8_8"  - 601 output, 24-bit RGB
-       Option "TV_Bus_Fmt" "601_yuv_4_4_4"  - 601 output, YUV 4:4:4
-Note that the "601" modes may need sync signals for correct operation.
-See the 601 flags below to operate these selections.
-
-Colorspace conversion requires a projective transformation to
-perform downsampling for the implied transformation.  The sampling
-method may be specified by selecting from:
-       Option "TV_Conversion" "cosited"
-       Option "TV_Conversion" "interspersed"
-       Option "TV_Conversion" "alternating"
-
-The TV standard selected normally specifies a known frame buffer/
-TV mode geometry.  However, it is quite common that TV output
-devices may expect a blanked  "overscan" area.  The dx,dy marginal
-widths for the overscan area can be specified using:
-        Option          "TV_Overscan" "40:30"
-Note that the TV standard geometry will be scaled (and filtered) to
-downscale the source buffer to destination raster image.
-
-TVOUT operation may be conditioned with the following set of flags.
-Some of these flags are not especially usable except to the kernel,
-but are included for completeness.
-
-These "TV_Flags" identifiers are specified in a quoted comma
-separated list from the following identifier set: 
- singlechipcompat - Enables SCx2xx compatibility mode..
- extendedsav      - Enables extended SAV/EAV codes.
- vbi              - Use the task bit to indicate VBI data.
- task             - Set Task Bit to 1in VIP 2.0 mode. Default is 0.
- swap_uv          - Swap the U and V data prior to output.
- swap_vbi         - Swap the VBI bytes prior to output.
-for example:
-       Option "TV_Flags" "swap_uv"  -or
-       Option "TV_Flags" "extendedsav:swap_uv"
-
-These "TV_601_Flags" identifiers are specified in a quoted comma
-separated list from the following identifier set: 
- inv_de_pol       - Invert the polarity of display enable
- inv_hs_pol       - Invert the polarity of hsync
- inv_vs_pol       - Invert the polarity of vsync
- vsync-4          - The VSync occurs 4 clocks earlier
- vsync-2          - The VSync occurs 2 clocks earlier
- vsync+0          - The VSync is not shifted at all
- vsync+2          - The Vsync occurs 2 clocks later
-for example:
-       Option "TV_601_Flags" "inv_vs_pol"
-
-These "TV_Vsync_Select" identifiers are specified in a quoted comma
-separated list from the following identifier set: 
- disabled         - VSync out disabled
- vg               - The VSync signal from the VG (video generator)
- vg_inv           - The VSync signal from the VG (inverted)
- statreg17        - 1 written to VIP status bit 17 toggles vsync (0-1-0)
- statreg17_inv    - 1 written to VIP status bit 17 toggles vsync (1-0-1)
-for example:
-       Option "TV_Vsync_Select" "disabled"
-
-
-6. Screen section:
-
-The screen section selects among the other various sections for
-sets of operational parameters and constraints.  A typical
-"Screen" section has the form:
-
-Section "Screen"
-    Identifier  "ScreenId"
-    Device      "Geode"
-    Monitor     "MonitorId"
-    DefaultDepth 24
-
-    SubSection "Display"
-        Depth           24
-        FbBpp           32
-        Modes          "1280x1024" "1024x768" "800x600" "640x480" "tv-ntsc" "tv-pal"
-    EndSubsection
-...
-
+	Identifier "AMD Geode"
+	Driver "amd"
+	Option "blah" "blah"
+	...
 EndSection
 
-In this example, the "Modes" selection of the display subsection specifies a
-list of available modes.  These modes are selectable using "Ctl-Alt-KpPlus" or
-"Ctl-Alt-KpMinus" on most PC keyboards.  It is also possible to select a mode
-using the xrandr utility, as well as using the X library API.
-
-The DefaultDepth may be 24, 16 or 8.  If the depth is 24, then the "FbBpp" line
-is needed to specify the frame buffer format as 32 bits (hardware limitation).
-If a custom mode is specified, care should be taken to be sure it does not
-collide with a "builtin" mode, since the builtin mode will supersede.
-
-For a more complete functional description, review that the cimarron
-reference and Geode LX processor functional specifications.
-
------------------------------------------------------------------------------
-RELEASE HISTORY
------------------------------------------------------------------------------
-Version 04.00.0000
-April 30, 2006
-
-Dependencies 
-------------
-This release depends on and includes the following subcomponents:
-
-Linux Build Tool - Base GeodeLinux Build System - Version 00.00.0015
-Linux Build Tool - AMD Embedded - Version 00.00.0016
-Linux Build Tool - Bitbake engine - Version 00.00.0010
-Linux Build Tool - Openembedded - Version 00.00.0006
-
-Functional Changes
-------------------
-_____________________________________________________________________________
-Change: 77478
-_____________________________________________________________________________
-Archive 2.6.11 kernel and kernel modules.
-
-_____________________________________________________________________________
-Change: 78502
-_____________________________________________________________________________
-Tinderbox script name and version must match .bb
-
-_____________________________________________________________________________
-Change: 78443
-_____________________________________________________________________________
-Changes to xorg_7.0 BOM did not take the first time.
-
-_____________________________________________________________________________
-Change: 78552
-_____________________________________________________________________________
-Rename norwich and norwich-2.6.11 machines to geodelx and geodelx-2.6.11.
-
-_____________________________________________________________________________
-Change: 78556
-_____________________________________________________________________________
-Move geodelx machine to X11R7.0. Prepend BBPATH with devel directory for
-overriding local.conf without p4 edit.
-
-_____________________________________________________________________________
-Change: 78423
-_____________________________________________________________________________
-
-_____________________________________________________________________________
-Change: 77505
-_____________________________________________________________________________
-More path and version updates after projects/norwich to
-projects/geodelx rename.
-
-_____________________________________________________________________________
-Change: 78527
-_____________________________________________________________________________
-Don't let xorg try to identify the LinuxDistribution.
-
-_____________________________________________________________________________
-Change: 78561
-_____________________________________________________________________________
-Misc changes after geodelx and geodelx-2.6.11 X build testing.
-
-_____________________________________________________________________________
-Change: 78535
-_____________________________________________________________________________
-Move to tcltk 8.4.11 from upstream in attempts to squash this Tindebox
-failure.
-
-_____________________________________________________________________________
-Change: 78108
-_____________________________________________________________________________
-First stab at dvb-image. Everything compiles, but I am worried about DRI
-support in X, missing geode support in X, openGL support in qt-x11-free.
-Also, directFB may be a better direction; it is currently disabled in this
-mythtv build.
-
-_____________________________________________________________________________
-Change: 77965
-_____________________________________________________________________________
-Syncronize travis, sands, gcov, and simnow busybox configurations. Remove
-grep and tar from travis-db1200-2.6 and validation-image images. These are
-provided by busybox. Move IMAGE_ROOTFS_SIZE to the meta .bb files as this is
-psp specific and not necessarily distro specific.
-
-_____________________________________________________________________________
-Change: 77612
-_____________________________________________________________________________
-Monotone OE Sync
-
-_____________________________________________________________________________
-Change: 77802
-_____________________________________________________________________________
-CVSDATE renamed to SRCDATE.
-
-_____________________________________________________________________________
-Change: 77847
-_____________________________________________________________________________
-Decrease the size on the etx2 partition. norwich/sands/conf/local.conf points
-to norwich machine and not norwich-2.6.11.
-
-_____________________________________________________________________________
-Change: 77978
-_____________________________________________________________________________
-1. Update Norwich.conf and Samba.conf to 2.6.16
-2. Change version file: BBFile to BBFile2 and LinuxKernel to LinuxKernel2
-
-_____________________________________________________________________________
-Change: 77947
-_____________________________________________________________________________
-Adding samba machine configuration file. The difference right now, from
-existing norwich.conf is that this samba configures an X11R7 build. xserver-xorg-X11R7.0-
-1.0.1 builds with this changelist but has not been tested. Additionally, the
-AMD driver checked into Perforce has not yet been built here.
-
-================================================================================
-Version 03.00.0102
-April 10, 2006
-
-Dependencies 
-------------
-This release depends on and includes the following subcomponents:
-
-Linux Build Tool - Base GeodeLinux Build System - Version 00.00.0013
-Linux Build Tool - AMD Embedded - Version 00.00.0014
-Linux Build Tool - Bitbake engine - Version 00.00.0009
-Linux Build Tool - Openembedded - Version 00.00.0006
-
-Functional Changes
-------------------
-_____________________________________________________________________________
-Change: 77441
-_____________________________________________________________________________
-Rename //drivers/projects/norwich to //drivers/projects/geodelx. This
-change includes:
- * Updates to P4MOD BOMs for 2.6.11 and 2.6.15 releases.
- * Updates to GeodeLinux .bb files for 2.6.11 and 2.6.15 builds.
- * P4MOD search path update.
-
-================================================================================
-Version: 03.00.0101, Release Notes
-Release Date: December 19, 2005
-
-Dependencies 
-------------
-- Built with xorg-x11-6.7.0 from Fedora Core 2 Source Updates
-- Built with X11R6.8.1 from freedesktop.org
-                                                                                
-- This driver has been tested with Linux Kernel 2.6.11
-    using the Fedora Core 2 image environment
-    using the Gentoo 2005.0 image environment
-
-- To use the Xv adaptor interface
-   1) create a "videox" link to the geodev4l2 video device in /dev
-      ln -s video0 /dev/videox
-   2) uncomment the '  Load "z4l"' line in xorg.conf
-
-Functional Changes
-------------------
-Issue #4027
-
-Defects Corrected 
------------------
-PBZ#6538 - X.org patch is incompletely licensed
-PBZ#4027 - HWCursor/Rotation, cursor does not traverse entire resolution area
-Description:
-When using HWCursor, cursor can not traverse the entire visable area of *MOST* 
-(there are exceptions) rotated modes.  The failures exist as edges which the 
-cursor can not travel to.  Failing edges differ according to rotation.
-Resolution:
-Cursor "hotspot" error corrected.
-
-PBZ#4463 - 8 bpp, x11perf SWCRC --> HWCRC comparison fails paint8_03 ...
-PBZ#4665 - LX Xorg Driver will not patch successfully if GX Xorg Pat...
-PBZ#5025 - mode changes with xrandr, graphics distorted
-
-Known Errata 
-------------
-PBZ#4025 X - Rotations{90,270}, only lowest refresh rate pass mode validation
-Description: 
-At 90 and 270 degree rotations, only the lowest supported refresh
-rate can be entered.  The rest of the refresh rates appear to fail mode 
-validation (xrandr does not see them as options, and I can not CTL->ALT->+/- 
-through the modes).  This issue does not occur at 0 or 180 degree rotations.  
-Resolution: 
-This is an inherent weakness of the X mode switch -- where even a 
-full X R&R implementation would not fix this.
-Steps to address will need to be:
-(1) convert AMD rotation support to X R&R
-(2) patch X to better handle X R&R
-This may be addressed in a future version.
-
-PBZ#5993 - HWScaling mode hsync out of range error
-
-================================================================================
-Previous Version: 1.02.0900
-Release Date: 26 May 2005
-
-Dependencies
-------------
-- Built with xorg-x11-6.7.0 from Fedora Core 2 Source Updates
-- Built with X11R6.8.1 from freedesktop.org
-                                                                                
-- This driver has been tested with Linux Kernel 2.6.11
-    using the Fedora Core 2 image environment
-    using the Gentoo 2004.3 image environment
-
-- To use the Xv adaptor interface
-   1) create a "videox" link to the geodev4l2 video device in /dev
-      ln -s video0 /dev/videox
-   2) uncomment the '  Load "z4l"' line in xorg.conf
-
+The following options may be added to the section:
 
-Functional Changes
-------------------
-- First release
+== GX ==
 
-Defects Corrected
------------------
-- First release
+SWCursor: Enable software cursors (essentially disabling HW cursor support)
+NoCompression: Disable video bandwidth compression
+NoAccel: Disable hardware assisted acceleration
+AccelMethod: "EXA" (default) or "XAA"
+Rotate: Select a orientation to start with - LEFT, INVERT, CCW
+NoPanel: Disable panel support
+OSMImageBuffers: Set the number of image buffers (XAA only)
+OSMColorExpBuffers: Set the number of color expansion buffers (XAA only)
+FBSize: Specify the size of the video space (in bytes)
+PanelGeometry: Specify the geometry of the attached panel ("<width>x<height>")
 
-Known Errata
-------------
-Issue: 
+== LX ==
 
-PBZ#4025 X - Rotations{90,270}, only lowest refresh rate pass mode validation
-Description: 
-At 90 and 270 degree rotations, only the lowest supported refresh
-rate can be entered.  The rest of the refresh rates appear to fail mode 
-validation (xrandr does not see them as options, and I can not 
-CTL->ALT->+/- through the modes).  This issue does not occur at 0 or 
-180 degree rotations.  
-Resolution: 
-This is an inherent weakness of the X mode switch -- where even a full X R&R 
-implementation would not fix this.
-Steps to address will need to be:
-(1) convert AMD rotation support to X R&R
-(2) patch X to better handle X R&R
-This may be addressed in a future version.
+SWCursor: Enable software cursors (essentially disabling HW cursor support)
+NoCompression: Disable video bandwidth compression
+NoAccel: Disable hardware assisted acceleration
+Rotate: Select a orientation to start with - LEFT, INVERT, CCW
+NoPanel: Disable panel support
+ExaScratch: Specify the amount of extra EXA scratch buffer (in bytes)
+FBSize: Specify the size of the video space (in bytes)
+PanelGeometry: Specify the geometry of the attached panel ("<width>x<height>")
 
-================================================================================
-Copyright
----------
-Copyright 2005 Advanced Micro Devices, Inc. All rights reserved.
-The contents of this document are provided in connection with Advanced Micro
-Devices, Inc. ("AMD") products. AMD makes no representations or warranties
-with respect to the accuracy or completeness of the contents of this
-publication and reserves the right to make changes to specifications and
-product descriptions at any time without notice. No license, whether express,
-implied, arising by estoppel or otherwise, to any intellectual property rights
-is granted by this publication. Except as set forth in AMD's Standard Terms
-and Conditions of Sale, AMD assumes no liability whatsoever, and disclaims any
-express or implied warranty, relating to its products including, but not
-limited to, the implied warranty of merchantability, fitness for a particular
-purpose, or infringement of any intellectual property right. AMD's products
-are not designed, intended, authorized or warranted for use as components in
-systems intended for surgical implant into the body, or in other applications
-intended to support or sustain life, or in any other application in which the
-failure of AMD's product could create a situation where personal injury,
-death, or severe property or environmental damage may occur. AMD reserves the 
-right to discontinue or make changes to its products at any time without notice.
 
 
-Trademarks
-----------
-AMD, the AMD Arrow logo, and combinations thereof, and Geode are trademarks 
-of Advanced Micro Devices, Inc.
 
-Other product names used in this publication are for identification purposes
-only and may be trademarks of their respective companies.
-================================================================================