From 698897acda67823e6f384f8dd81673d696446e02 Mon Sep 17 00:00:00 2001 From: Egbert Eich Date: Fri, 2 Apr 2004 21:47:19 +0000 Subject: 70. Merging in the TM branch (Egbert Eich). --- README.ati.sgml | 57 ++++++++++++++++++++++++++++---------------------------- README.r128.sgml | 10 ++++++---- man/ati.man | 6 +++--- man/r128.man | 6 +++--- man/radeon.man | 6 +++--- 5 files changed, 44 insertions(+), 41 deletions(-) diff --git a/README.ati.sgml b/README.ati.sgml index 85d52a35..ed18393d 100644 --- a/README.ati.sgml +++ b/README.ati.sgml @@ -1,4 +1,4 @@ - %defs; ]> @@ -15,11 +15,12 @@ -$XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/ati.sgml,v 3.42 2003/01/20 03:43:07 dawes Exp $ +$Id$ +Based on XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/ati.sgml,v 3.42 2003/01/20 03:43:07 dawes Exp -This is the README for the XFree86 ATI driver included in this release. +This is the README for the XAA ATI driver included in this release. @@ -46,8 +47,8 @@ otherwise and the user has requested such support. Thus, the level of support provided not only depends on what the driver detects -in the system, but also, on what the user specifies in the XF86Config file. -See the ``XF86Config specifications'' section below for details.

+in the system, but also, on what the user specifies in the xorg.conf file. +See the ``xorg.conf specifications'' section below for details.

If none of the above conditions are met, the ATI driver will essentially disable itself to allow other drivers to examine the system.

Note that I am currently considering removing the driver's support for generic @@ -138,18 +139,18 @@ functionality, but the driver currently only uses the VGA.

The driver does however support the accelerator CRTC present in all ATI Mach64 adapters. For 256-colour, and higher depth modes, this support will be used by default, -although an XF86Config option can be specified to use the SuperVGA CRTC +although an xorg.conf option can be specified to use the SuperVGA CRTC instead. A linear video memory aperture is also available in 256-colour and higher depth modes and enabled by default if a 264xT or 3D Rage controller is detected or, on 88800 controllers, if the accelerator CRTC is used. -XF86Config options are available to disable this aperture, or (for non-PCI +xorg.conf options are available to disable this aperture, or (for non-PCI adapters) enable it or move it to some other address.

By default, the driver provides some acceleration for Mach64 if the accelerator CRTC is used, and modes whose colour depth greater than or equal to 8 are to be used. This support is as yet incomplete and can be disabled entirely with an -XF86Config option.

+xorg.conf option.

On non-Intel platforms, the driver can, currently, only support PCI Mach64 adapters.

Current implementation of generic VGA support for non-ATI adapters

@@ -157,7 +158,7 @@ Support for generic VGA with non-ATI adapters is also implemented, but has undergone only limited testing. The driver will intentionally disallow the use of this support with ATI adapters. -This support must be explicitly requested through an XF86Config ChipSet +This support must be explicitly requested through an xorg.conf ChipSet specification. This prevents the current VGA generic driver from being disabled.

This driver's generic VGA support is intended as an extension of that provided @@ -174,8 +175,8 @@ VGA implementation: Interlaced modes are not available. Colour depths higher than 8 are not available. -XF86Config specifications

-The driver recognises a number of XF86Config options. +xorg.conf specifications

+The driver recognises a number of xorg.conf options. In general, all such options should be specified in a ``Device'' section, and affect only that ``Device'' section.

Those options that affect how the driver associates adapters with ``Device'' @@ -248,7 +249,7 @@ This option limits the adapters that can be associated with the ``Device'' section to the one with the specified PCI Bus ID. This specification excludes non-PCI adapters.

Clocks

-For the purpose of specifying a clock line in your XF86Config, one of four +For the purpose of specifying a clock line in your xorg.conf, one of four different situations can occur, as follows.

Those configuring the driver's generic VGA support for a non-ATI adapter, can skip ahead to the ``Clocks for non-ATI adapters'' section below. @@ -274,14 +275,14 @@ The clock numbers reserved in this way are dependent on the particular clock generator used by the adapter.

The driver currently supports all programmable clock generators known to exist on Mach64 adapters. -In this case, the driver will completely ignore any XF86Config clock +In this case, the driver will completely ignore any xorg.conf clock specification, and programme the clock generator as needed by the modes used during the X session.

Clocks for unsupported programmable clock generators

This case is unlikely to occur, but is documented for the sake of completeness.

In this situation, the driver will probe the adapter for clock frequencies -unless XF86Config clocks are already specified. +unless xorg.conf clocks are already specified. In either case, the driver will then attempt to normalise the clocks to one of the following specifications: @@ -372,12 +373,12 @@ those that are zero above, or vice-versa.

The order of the clocks is very important, although the driver will reorder the specified clocks if it deems it appropriate to do so. Mach32 and Mach64 owners should note that this order is different than what -they would use for previous XFree86 accelerated servers.

+they would use for previous accelerated servers.

Clocks for non-ATI adapters

-If no clocks are specified in the XF86Config, the driver will probe for four +If no clocks are specified in the xorg.conf, the driver will probe for four clocks, the second of which will be assumed to be 28.322 MHz. The first clock will typically be 25.175 MHz, but there are exceptions. -You can include up to four clock frequencies in your XF86Config to specify the +You can include up to four clock frequencies in your xorg.conf to specify the actual values used by the adapter. Any more will be ignored.

Option ``nopanel_display''

@@ -479,8 +480,8 @@ generator, which means it will treat it as a fixed-frequency clock generator, as described under the heading ``Clocks for unsupported programmable clock generators'' above.

Video modes

-Mode timings can be derived from the information in XFree86's doc subdirectory. -However, it is no longer required to specify such timings in an XF86Config's +Mode timings can be derived from the information in X's doc subdirectory. +However, it is no longer required to specify such timings in an xorg.conf's ``Monitor'' section(s), if only standard mode timings are to be used. The server automatically inserts VESA standard mode timings in every ``Monitor'' section, and these modes will be checked first for mode constraints @@ -498,7 +499,7 @@ server entry. The driver also inserts timings for a mode called "Native panel mode" that represents the panel's native resolution.

Known problems and limitations

-There are several known problems or limitations related to the XFree86 ATI +There are several known problems or limitations related to the ATI driver. They include:

@@ -544,7 +545,7 @@ should be on 264xT and 3D Rage adapters. For now, clocks will, by default, be limited to 80MHz, 135MHz, 170MHz, 200MHz or 230MHz, depending on the specific controller. This limit can only be increased (up to a driver-calculated absolute maximum) -through the DACSpeed specification in XF86Config. +through the DACSpeed specification in xorg.conf. Be aware however that doing so is untested and might damage the adapter. Except as in the previous items, clocks are limited to 80MHz on most adapters, although many are capable of higher frequencies. @@ -580,18 +581,18 @@ DVD, etc.) in a window or full-screen. Reporting problems

If you are experiencing problems that are not already recorded in this document, first ensure that you have the latest current release of this driver -and XFree86. -Check the server's log (usually found in /var/log/XFree86.0.log) and if you are uncertain.

-Secondly, please check XFree86's doc directory for additional information.

+and the Xorg X server.. +Check the server's log (usually found in /var/log/Xorg.0.log) and if you are uncertain.

+Secondly, please check Xorg's doc directory for additional information.

Thirdly, a scan through the comp.windows.x.i386unix and comp.os.linux.x -newsgroups and the xfree86 mailing list using your favourite archiving +newsgroups and the xorg mailing list using your favourite archiving service can also prove useful in resolving problems.

If you are still experiencing problems, you can send me non-HTMLised e-mail at tsi@xfree86.org. Please be as specific as possible when describing the problem(s), and include -an unedited copy of the server's log and the XF86Config file used.

+an unedited copy of the server's log and the xorg.conf file used.

Driver history

The complete history of the driver is rather cloudy. The following is more than likely to be incomplete and inaccurate.

diff --git a/README.r128.sgml b/README.r128.sgml index 7c7ac88e..d8532f25 100644 --- a/README.r128.sgml +++ b/README.r128.sgml @@ -1,4 +1,4 @@ - %defs; ]> @@ -8,7 +8,7 @@ 13 June 2000 -$XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/r128.sgml,v 1.7 2000/03/08 15:14:48 dawes Exp $ +$Id$ @@ -54,14 +54,14 @@ $XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/r128.sgml,v 1.7 2000/03/08 15:

The driver auto-detects all device information necessary to initialize the card. The only lines you need in the "Device" -section of your XF86Config file are: +section of your xorg.conf file are: Section "Device" Identifier "Rage 128" Driver "r128" EndSection -or let xf86config do this for you. +or let xorgconfig do this for you. However, if you have problems with auto-detection, you can specify: @@ -92,6 +92,8 @@ However, if you have problems with auto-detection, you can specify: Authors

+The X11R&relvers; driver was originally part of XFree86 4.4 rc2. + The XFree86 4 driver was ported from XFree86 3.3.x and enhanced by: Rickard E. (Rik) Faith faith@precisioninsight.com diff --git a/man/ati.man b/man/ati.man index 57086292..fa46bfcd 100644 --- a/man/ati.man +++ b/man/ati.man @@ -14,17 +14,17 @@ ati \- ATI video driver .fi .SH DESCRIPTION .B ati -is an XFree86 driver for ATI video cards. +is an __xservername__ driver for ATI video cards. THIS MAN PAGE NEEDS TO BE FILLED IN. .SH SUPPORTED HARDWARE The .B ati driver supports... .SH CONFIGURATION DETAILS -Please refer to XF86Config(__filemansuffix__) for general configuration +Please refer to __xconfigfile__(__filemansuffix__) for general configuration details. This section only covers configuration details specific to this 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: ... diff --git a/man/r128.man b/man/r128.man index 606b9d64..2c2c872a 100644 --- a/man/r128.man +++ b/man/r128.man @@ -14,7 +14,7 @@ r128 \- ATI Rage 128 video driver .fi .SH DESCRIPTION .B r128 -is an XFree86 driver for ATI Rage 128 based video cards. It contains +is an __xservername__ driver for ATI Rage 128 based video cards. It contains full support for 8, 15, 16 and 24 bit pixel depths, hardware acceleration of drawing primitives, hardware cursor, video modes up to 1800x1440 @ 70Hz, doublescan modes (e.g., 320x200 and 320x240), gamma @@ -26,7 +26,7 @@ The driver supports all ATI Rage 128 based video cards including the Rage Fury AGP 32MB, the XPERT 128 AGP 16MB and the XPERT 99 AGP 8MB. .SH CONFIGURATION DETAILS -Please refer to XF86Config(__filemansuffix__) for general configuration +Please refer to __xconfigfile__(__filemansuffix__) for general configuration details. This section only covers configuration details specific to this driver. .PP @@ -125,7 +125,7 @@ Enable or disable viewing offscreen cache memory. A development debug option. Default: off. .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 .nf Rickard E. (Rik) Faith \fIfaith@precisioninsight.com\fP diff --git a/man/radeon.man b/man/radeon.man index 7a7c2a9a..c09ac46f 100644 --- a/man/radeon.man +++ b/man/radeon.man @@ -13,7 +13,7 @@ radeon \- ATI RADEON video driver .fi .SH DESCRIPTION .B radeon -is a XFree86 driver for ATI RADEON based video cards. It contains +is a __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 IGP series cards), hardware cursor, XV extension, Xinerama extension. @@ -68,7 +68,7 @@ Radeon 9600PRO/9600SE/9600, M10/M11, FireGL T2 (2D only) Radeon 9600XT (2d only) .SH CONFIGURATION DETAILS -Please refer to XF86Config(__filemansuffix__) for general configuration +Please refer to __xconfigfile__(__filemansuffix__) for general configuration details. This section only covers configuration details specific to this driver. .PP @@ -311,7 +311,7 @@ parameter may be specified as a float value with standard suffixes like "k", "kHz", "M", "MHz". .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 .nf Authors include: ... -- cgit v1.2.3