LICENSE INFORMATION
-------------------

This whole package is distributed under the GNU General Public License (GPLv2)
The license text itself is no longer included in the videogen package.
If you want to get a copy, look around at http://www.gnu.org



INTRODUCTION
------------

Former blah-blah went a bye-bye. If you have it you probably know
what videogen can be used for: to generate XFree96 Modelines and
Linux fbset timings which provide the highest refresh rate possible
at a given resolution.



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

 1.) check and edit "config.h" only if you know what you are doing

 2.) check and edit "Makefile" if needed

 3.) do a "make"

 4.) do a "make install" to install the binary and the manpage

 5.) you can do a "make clean" to remove the binary from the source dir
 
 6.) you can do a "make distclean" to remove backup (*~) files too
 
 7.) you can uninstall the installed binary and manpage with "make uninstall"



USAGE
-----

There are two main ways to use videogen. The one is interactive mode turned
on by the -i switch. This way you'll get a prompt for each required parameter.
You can safely enter 0 for the desired vertical resolution because videogen
will correct it using the aspect ratio (this applies to the command line
mode too if you omit the -vpx parameter).

As you can see, the another way is using command line mode. This is done by
simply omitting the -i switch. You must use other command line switches to give
all hardware parameters then. For using the switches and interpreting error
messages/values please look at the manual page videogen(1).



FIXED DOT CLOCKS
----------------

If your display adapter does not have a programmable clockchip then you will
need to get a list of available clocks somehow and enter these as the maximum
dot clock frequency. This way videogen will have to adjust (decrease) the
horizontal retrace frequency to get exactly the given dot clock rate. Currently
this is the only way I can imagine but if many people will ask for a feature
to handle such cards natively then I will maybe implement this later.



Videogen homepage (latest version tarballs, packages, contact info):
http://paranoia.rulez.org/videogen




