
Config::Model::Xorg - Xorg configuration tool based on Config::Model

This module provides a Xorg configuration model. 

With this module and Config::Model, you have a tool to tune the
configuration of your favourite X server.

Installing Config::Model::TkUI is recommended as you'll have a
more user friendly curses based user interface.

(You may also want to install Config::Model::CursesUI to get a curses
interface in case Xorg server is down)

Once this module is installed, you can run (as root, but please backup
/etc/X11/xorg.conf before):

  # config-edit -model Xorg

You may want to try it safely first by writing the resulting xorg.conf
elsewhere (in this case you can run this command with your user
account):

  $ config-edit -model Xorg -write_directory test 

If config-edit fails with your xorg.conf (See BUGS section below), you
can try config-edit with -force option.

Note that you must run this command where you unpacked
this perl module:

  $ config-edit -model Xorg -read data -write wr_test

If you do not have the curses user interface, be sure to read doc
which explain the basic command of the terminal based interface:
http://search.cpan.org/dist/Config-Model/TermUI.pm#USER_COMMAND_SYNTAX

--------------------------------------------------------------------
MODULE CONTENT

This Perl modules contains several files (listed in MANIFEST). Here
are the purpose of the main files:
- Build.PL : script to build the Perl module. See Module::Build(3pm)
- data/xorg.conf: sample xorg.conf used with non-reg test
- lib/Config/Model/models : directory containing Xorg model files. The
  main model is Xorg.pl. The complete xorg model is made from all
  files contained in this directory.
- lib/Config/Model/Xorg/Read.pm: Read xorg.conf files
- lib/Config/Model/Xorg/Write.pm: Write xorg.conf files
- t/xorg.t: non-regression test

--------------------------------------------------------------------

KEYBOARD MODEL

If Xorg is installed on your system, the keyboard model will be
generated by Build.PL from the content of the lst files in your
xkb/rules directory.

If Xorg is not installed, this module will fallback on a keyboard
model created on a Debian GNU/Linux system. (This is done so that CPAN
testers can be run even on servers without Xorg).

--------------------------------------------------------------------
BUGS

This model is quite young and is incomplete.

So far, the following video cards have a model (see
lib/Config/Model/models/Xorg/Device/ directory) :
- ATI card (rather complete Radeon.pl model for radeon driver)
- Nvidia card (very preliminary Nvidia.pl model for Nvidia proprietary
  driver)

--------------------------------------------------------------------

AUTHOR
    Copyright (c) 2007-2008 Dominique Dumont.

    This file is part of Config-Model-Xorg.

---------------------------------------------------------------------
INSTALLATION

   	tar zxvf <dist_file>.tar.gz 
   	cd <dist_directory>
   	perl Build.PL
	./Build test

If you want to install this software without packaging, type also:

        ./Build install
