NAME

       Gatos - ATI-TV for GNU/Linux

DESCRIPTION

       The  GATOS (General ATI TV and Overlay Software) is an effort to create
       standard drivers for all currently unsupported features  of  ATI  video
       cards, specifically TV features.

HOMEPAGE

       The GATOS homepage is located at:
       http://www.core.binghamton.edu/~insomnia/gatos/

       Updates, news, additional documentation and the FAQ can be found there.

MAINTAINER

       Insomnia  (Stea Greene) <insomnia@core.binghamton.edu> send bug reports
       and code patches to this address.

REQUIREMENTS

       -GNU/Linux, FreeBSD and NetBSD
              (only tested on x86).

       -ATI   All-In-Wonder, All-In-Wonder Pro  or  Rage  II/Pro  with  ATI-TV
              tuner  card.  Limited  support  for  the  All-In-Wonder  128 and
              Rage128 with ATI-TV tuner card.

       -XFree86
              recommended, but not required.

PROGRAMS

       There are many programs packaged with GATOS:

              - xatitv     : GUI "TV in a window" application.
              - atitv      : Simple text-mode program.
              - gatos-conf : GUI GATOS configuration application.
              - atitoppm,
              - atitogif,
              - atitojpg,
              - yuvsum,
              - atisplit   : YUV conversion program.
              - scanpci    : PCI bus utility.

BUG REPORTS

       To submit a bug report, send an e-mail to:
       Insomnia (Stea Greene) <insomnia@core.binghamton.edu>

       with a subject line of:
       GATOS BUG: <brief description...>

       Then in the main body of the message:

       - Describe the bug in detail, including how to repeat the
              misbehavior,

       - Specify what version of GATOS and what version of
              IBTK you are using,

       - Then include a dump of "xatitv -v" (either as a MIME
              attachment or right in the message),

       - Include a patch of any changes you made to the code that may
              fix the problem. See PATCHES below,

       When a bug is fixed or if the bug report is not understood, you
       will get a reply, so make sure your message is properly reply-able.

PATCHES

       To create a patch, first make sure you have a full tree of both the
       original and the modified trees (herin called "gatos-orig" and
       "gatos-new" respectively).

       Make sure each tree is clean by using:

       ->     make distclean

       in EACH directory.  Then change to the directory immediately above
       these two directories and use the following command:

       ->     diff -ur gatos-orig gatos-new > gatos-new-patch

       Look at gatos-new-patch (with a text editor or viewer) and make sure
       nothing is changed that you didn't intend to be.  You can submit this
       patch to me either included in an e-mail, or as a MIME attachment, or
       you can compress it and send it as a MIME attachment, as follows:

       Compress it with:

       ->     gzip -9 gatos-new-patch

       Then send gatos-new-patch.gz to me as a MIME attachment.

       If there is a problem with the patch, or I have a question or the
       patch/description is not understood, you will get a reply, so make sure
       your message is properly reply-able.

LICENSE

       Files not covered by the main GATOS license (GNU Public
       License):

       delay.S, delay.h and linkage.h are from the Linux 2.0.36 kernel
              sources (slightly modified) and are Copyright (C) 1993 by Linus
              Torvalds.

       scanpci.c is from XFree86 3.3.3 and is Copyright (C) 1995 by Robin
              Cutshaw.

       pci.c is modified from scanpci.c and is Copyright (C) 1995+1999 by
              Robin Cutshaw and Øyvind Aabling.

AUTHORS

       Primary Authors:

            Øyvind Aabling                <Oyvind.Aabling@uni-c.dk>
            Daniel Caujolle-Bert          <lobadia@club-internet.fr>
            Vladimir Dergachev            <vdergach@sas.upenn.edu>
            Insomnia (Stea Greene)        <insomnia@core.binghamton.edu>
            Christian Lupien              <lupien@physics.utoronto.ca>
            Octavian PURDILA              <purdila@sundy.cs.pub.ro>

       Other Contributors:

            Bob Bell                      <bbell@macroped.com>
            Bruce Forsberg                <forsberg@adnc.com>
            Chris Hardy                   <chris@hardys.org>
            Victor Bogado da Silva Lins   <bogado@openlink.com.br>
            Ken Dresser                   <Ken@dresser.net>
            Jan ONDREJ                    <ondrejj@salstar.shadow.sk>
            techt                         <techt@pikeonline.net>
            hook                          <hook@netrio.com.br>
            Rodrigo Ventura               <yoda@isr.ist.utl.pt>

       Based on:

              -aiwtv-0.22
                     by Øyvind Aabling.

              -aiwtv-0.20uX
                     by Øyvind Aabling, Christian Lupien,  Vladimir  Dergachev
                     and Bruce Forsberg.

              -atitv-0.21#X
                     by  Øyvind  Aabling,  Insomnia  (Stea  Greene)  and Bruce
                     Forsberg.

              -Limited documentation and some support
                     from ATI Technologies Inc.

                                 20 Dec 1999                          GATOS(1)