.\"             -*-Nroff-*-
.\" gatos man page
.\"   Written by Gatos Devel. Team, and so grinded and scribbled by DCB.
.\"
.\" History:
.\"    0.1: (first generation)
.\"    0.2: some clean-ups and cosmetic changes 
.\"    0.3: update for 0.0.5.
.\"
.\" Last update: Mon Dec 20 03:02:41 CET 1999
.\" "
.TH GATOS 1 "20 Dec 1999 " " " "GATOS Manual"
.SH NAME
Gatos - ATI-TV for GNU/Linux
.SH DESCRIPTION
The \fBGATOS\fP (\fIG\fPeneral \fIA\fPTI \fIT\fPV and \fIO\fPverlay
\fIS\fPoftware) is an effort to create standard drivers for all
currently unsupported features of ATI video cards, specifically TV
features.
.SH HOMEPAGE
The \fBGATOS\fP homepage is located at:
.nf
\fIhttp://gatos.sourceforge.net/\fP
.fi
.sp
Updates, news, additional documentation and the FAQ can be found there.
.SH MAINTAINER
\fBInsomnia\fP (Stea Greene) <\fIinsomnia@core.binghamton.edu\fP> send
bug reports and code patches to this address.
.SH REQUIREMENTS
.TP
\fB\-GNU/Linux, FreeBSD and NetBSD\fP
(\fIonly tested on x86\fP).
.TP
\fB\-ATI\fP 
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.
.TP
\fB\-XFree86\fP
recommended, but not required.
.SH PROGRAMS
There are many programs packaged with \fIGATOS\fP:
.PP
.RS
.nf
\fB-\fP \fIxatitv\fP     : GUI "TV in a window" application.
\fB-\fP \fIatitv\fP      : Simple text-mode program.
\fB-\fP \fIgatos-conf\fP : GUI GATOS configuration application.
\fB-\fP \fIatitoppm\fP,
\fB-\fP \fIatitogif\fP,
\fB-\fP \fIatitojpg\fP,
\fB-\fP \fIyuvsum\fP,
\fB-\fP \fIatisplit\fP   : YUV conversion program.
\fB-\fP \fIscanpci\fP    : PCI bus utility.
.fi
.RE
.SH BUG REPORTS
To submit a bug report, send an e-mail to:
.nf
\fBInsomnia\fP (Stea Greene) <\fIinsomnia@core.binghamton.edu\fP> 
.sp
with a \fIsubject line\fP of:
\fBGATOS BUG\fP: <\fIbrief description\fP...>
.sp
Then in the main body of the message:
.TP
\fB\- \fPDescribe the bug in detail, including how to repeat the
misbehavior,
.TP
\fB\- \fPSpecify what version of \fIGATOS\fP and what version of
\fIIBTK\fP you are using,
.TP
\fB\- \fPThen include a dump of "\fIxatitv -v\fP" (either as a MIME
attachment or right in the message),
.TP
\fB\- \fPInclude a patch of any changes you made to the code that may
fix the problem. See \fBPATCHES\fP below,
.PP
When a bug is fixed or if the bug report is not understood, you
will get a reply, \fBso make sure your message is properly reply-able\fP.
.fi
.SH PATCHES
.nf
To create a patch, first make sure you have a full tree of both the
original and the modified trees (herin called "\fIgatos\-orig\fP" and
"\fIgatos\-new\fP" respectively).
.PP
Make sure each tree is clean by using:
.TP
.B "\->"
\fImake distclean\fP
.PP
in \fBEACH\fP directory.  Then change to the directory immediately above
these two directories and use the following command:
.TP
.B "\->"
\fIdiff \-ur gatos\-orig gatos\-new > gatos\-new\-patch\fP 
.PP
Look at \fIgatos\-new\-patch\fP (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:
.PP
Compress it with:
.TP
.B "\->"
\fIgzip -9 gatos\-new\-patch\fP
.PP
Then send \fIgatos\-new\-patch.gz\fP to me as a MIME attachment.
.PP
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, \fBso make sure
your message is properly reply-able\fP.
.fi
.SH LICENSE
.nf
Files \fBnot\fP covered by the main \fPGATOS\fP license (GNU Public
License):
.TP
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.
.TP
scanpci.c is from XFree86 3.3.3 and is Copyright (C) 1995 by Robin
Cutshaw.
.TP
pci.c is modified from scanpci.c and is Copyright (C) 1995+1999 by
Robin Cutshaw and \(/Oyvind Aabling.
.fi
.SH AUTHORS
Primary Authors:
.nf

     \(/Oyvind Aabling                <\fIOyvind.Aabling@uni-c.dk\fP>
     Daniel Caujolle-Bert          <\fIlobadia@club-internet.fr\fP>
     Vladimir Dergachev            <\fIvdergach@sas.upenn.edu\fP>
     Insomnia (Stea Greene)        <\fIinsomnia@core.binghamton.edu\fP>
     Christian Lupien              <\fIlupien@physics.utoronto.ca\fP>
     Octavian PURDILA              <\fIpurdila@sundy.cs.pub.ro\fP>
.fi
.PP
.PP
Other Contributors:
.nf

     Bob Bell                      <\fIbbell@macroped.com\fP>
     Bruce Forsberg                <\fIforsberg@adnc.com\fP>
     Chris Hardy                   <\fIchris@hardys.org\fP>
     Victor Bogado da Silva Lins   <\fIbogado@openlink.com.br\fP>
     Ken Dresser                   <\fIKen@dresser.net\fP>
     Jan ONDREJ                    <\fIondrejj@salstar.shadow.sk\fP>
     techt                         <\fItecht@pikeonline.net\fP>
     hook                          <\fIhook@netrio.com.br\fP>
     Rodrigo Ventura               <\fIyoda@isr.ist.utl.pt\fP>
.PP
.PP
.fi
Based on:
.RS
.TP
.B "\-aiwtv-0.22"
by \(/Oyvind Aabling.
.TP
.B "\-aiwtv-0.20uX"
by \(/Oyvind Aabling, Christian Lupien, Vladimir Dergachev and Bruce Forsberg.
.TP
.B "\-atitv-0.21#X"
by \(/Oyvind Aabling, Insomnia (Stea Greene) and Bruce Forsberg.
.TP
.B "\-Limited documentation and some support"
from ATI Technologies Inc.
.RE