Bug #5632: Fix up ati.4 to explain that it is a wrapper driver for the

    other three. While here, touch up radeon.4, and add an authors list
    gleaned from checking copyright headers.

2 files changed, 26 insertions, 14 deletions

diff --git a/man/ati.man b/man/ati.man
index abd7da31..bc33610d 100644
--- a/man/ati.man
+++ b/man/ati.man
@@ -1,4 +1,4 @@
-.\" $XFree86: xc/programs/Xserver/hw/xfree86/drivers/ati/ati.man,v 1.2 2001/01/27 18:20:46 dawes Exp $ 
+.\" $XFree86: xc/programs/Xserver/hw/xfree86/drivers/ati/ati.man,v 1.2 2001/01/27 18:20:46 dawes Exp $
 .\" shorthand for double quote that works everywhere.
 .ds q \N'34'
 .TH ATI __drivermansuffix__ __vendorversion__
@@ -14,17 +14,21 @@ ati \- ATI video driver
 .fi
 .SH DESCRIPTION
 .B ati
-is an XFree86 driver for ATI video cards.
-THIS MAN PAGE NEEDS TO BE FILLED IN.
+is an __xservername__ wrapper driver for ATI video cards.  It autodetects
+whether your hardware has a Radeon, Rage 128, or Mach64 or earlier class of
+chipset, and loads the radeon(__drivermansuffix__),
+r128(__drivermansuffix__), or atimisc(__drivermansuffix__) driver as
+appropriate.
 .SH SUPPORTED HARDWARE
 The
 .B ati
-driver supports...
+driver supports Radeon, Rage 128, and Mach64 and earlier chipsets by loading
+those drivers.  See those manpages for specific cards supported.
 .SH CONFIGURATION DETAILS
-Please refer to XF86Config(__filemansuffix__) for general configuration
-details.  This section only covers configuration details specific to this
+Please refer to __xconfigfile__(__filemansuffix__) for general configuration
+details, and the specific card driver for driver configuration details.
 driver.
 .SH "SEE ALSO"
-XFree86(1), XF86Config(__filemansuffix__), xf86config(1), Xserver(1), X(__miscmansuffix__)
+__xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), xorgconfig(__appmansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__)
 .SH AUTHORS
-Authors include: ...
+See the individual driver pages for authors.
diff --git a/man/radeon.man b/man/radeon.man
index 27908e91..6c52f472 100644
--- a/man/radeon.man
+++ b/man/radeon.man
@@ -13,10 +13,11 @@ radeon \- ATI RADEON video driver
 .fi
 .SH DESCRIPTION
 .B radeon
-is a __xservername__ driver for ATI RADEON based video cards.  It contains
+is an __xservername__ driver for ATI RADEON based video cards.  It contains
 full support for 8, 15, 16 and 24 bit pixel depths, dual-head setup,
 flat panel, hardware 2D acceleration, hardware 3D acceleration
-(except R300 and R400 series cards), hardware cursor, XV extension, Xinerama extension.
+(experimental on R300 and R400 series cards), hardware cursor, XV extension,
+and the Xinerama extension.
 .SH SUPPORTED HARDWARE
 The
 .B radeon
@@ -162,9 +163,8 @@ Set AGP data transfer rate.
 others \-\- invalid
 .TP
 .BI "Option \*qAGPFastWrite\*q \*q" boolean \*q
-Enable AGP fast write.
-.br
-(used only when DRI is enabled)
+Enable AGP fast write.  Enabling this option is frequently the cause of
+instability. Used only when the DRI is enabled.
 .br
 The default is
 .B off.
@@ -605,4 +605,12 @@ The default is
 __xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), xorgconfig(__appmansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__)
 .SH AUTHORS
 .nf
-Authors include: ...
+Authors include:
+Rickard E. (Rik) Faith   \fIfaith@precisioninsight.com\fP
+Kevin E. Martin          \fIkem@freedesktop.org\fP
+Alan Hourihane           \fIalanh@fairlite.demon.co.uk\fP
+Marc Aurele La France    \fItsi@xfree86.org\fP
+Benjamin Herrenschmidt   \fIbenh@kernel.crashing.org\fP
+Alex Deucher             \fIalexdeucher@gmail.com\fP
+Bogdan D.                \fIbogdand@users.sourceforge.net\fP
+Eric Anholt              \fIeric@anholt.net\fP