Update to randrproto 1.3.1

4 files changed, 254 insertions, 168 deletions

diff --git a/proto/randrproto/ChangeLog b/proto/randrproto/ChangeLog
index efa616f56..7dd36045b 100644
--- a/proto/randrproto/ChangeLog
+++ b/proto/randrproto/ChangeLog
@@ -1,3 +1,72 @@
+commit 240bb6051dccd072c95c8569a62b1222213ef396
+Author: Keith Packard <keithp@keithp.com>
+Date:   Mon Oct 5 20:04:11 2009 -0700
+
+    Bump version to 1.3.1
+    
+    Signed-off-by: Keith Packard <keithp@keithp.com>
+
+commit e5ea87cd2a1c7b636d95f42daf3f36ba3104d59d
+Author: Keith Packard <keithp@keithp.com>
+Date:   Mon Oct 5 20:20:14 2009 -0700
+
+    Add XORG_DEFAULT_OPTIONS invocation in configure.ac
+    
+    This should be included in all xorg configure.ac files to provide a
+    hook for setting various default values.
+    
+    Signed-off-by: Keith Packard <keithp@keithp.com>
+
+commit d9ee6abdef13d04f6e7015c0cc39e3855aa01bbf
+Author: Keith Packard <keithp@keithp.com>
+Date:   Fri Jun 5 20:37:24 2009 -0700
+
+    Remove trailing white space from randrproto.txt
+
+commit 92789c6c3a78bb64e391f1deec1d613900604985
+Author: Keith Packard <keithp@keithp.com>
+Date:   Fri Jun 5 20:35:46 2009 -0700
+
+    Allow inactive outputs to be set as primary
+
+commit 993dbda7b42caed7480dcff0eca4f9af9c1163ba
+Author: Matthias Hopf <mhopf@suse.de>
+Date:   Tue Aug 18 12:08:25 2009 +0200
+
+    Add Backlight property description.
+
+commit 77c7ab02bf62f057c32f666168fd0ceb03a85a2d
+Author: Matthias Hopf <mhopf@suse.de>
+Date:   Tue Aug 18 12:00:10 2009 +0200
+
+    Should read "EDID", not "EdidData" (2).
+    
+    Also include reference to former name.
+
+commit 5c95df133062570fe134be002dcb167ac059203d
+Author: Matthias Hopf <mhopf@suse.de>
+Date:   Tue Aug 18 11:56:38 2009 +0200
+
+    Sort properties alphabetically.
+
+commit 27529caf7912094bc83b47b8251205029c35d52c
+Author: Adam Jackson <ajax@redhat.com>
+Date:   Wed Apr 1 11:48:26 2009 -0400
+
+    Update reference to renderproto.txt
+
+commit 8ae7f1d202279959fdad84d30054b52ef021a9cc
+Author: Adam Jackson <ajax@redhat.com>
+Date:   Wed Apr 1 11:47:52 2009 -0400
+
+    Clarify that GetOutputPrimary is per-screen.
+
+commit 4036cdcc064db952286a74d679147d280b1a5f1f
+Author: Adam Jackson <ajax@redhat.com>
+Date:   Wed Apr 1 11:47:03 2009 -0400
+
+    Punctuation fix.
+
 commit 94e22fecc66590f81ca280517505c721a5f54497
 Author: Matthias Hopf <mhopf@suse.de>
 Date:   Fri Mar 6 15:03:09 2009 +0100
@@ -67,7 +136,7 @@ Date:   Wed Dec 10 11:15:48 2008 -0500
     Add [GS]etOutputPrimary
 
 commit 1334866b4aa025bce745140aa0f71f6493408ffa
-Merge: ad65017... e719120...
+Merge: ad65017 e719120
 Author: Keith Packard <keithp@keithp.com>
 Date:   Tue Dec 9 20:59:47 2008 -0800
 
@@ -142,7 +211,7 @@ Date:   Wed Nov 26 09:24:36 2008 -0800
     Update to version 1.2.99.1
 
 commit 6c17940a7960885695aa6033de58c3cd2bb6fb79
-Merge: c998b46... 8793429...
+Merge: c998b46 8793429
 Author: Keith Packard <keithp@keithp.com>
 Date:   Mon Nov 24 16:22:11 2008 -0800
 
@@ -282,7 +351,7 @@ Date:   Thu Nov 30 13:25:35 2006 -0800
     sz_xRROUtputChangeNotifyEvent -> sz_xRROutputChangeNotifyEvent
 
 commit 504556a9f886c84798ae8e0e46896a7c74b95c61
-Merge: c27ece2... 3d521b3...
+Merge: c27ece2 3d521b3
 Author: Keith Packard <keithp@neko.keithp.com>
 Date:   Thu Nov 30 09:44:20 2006 -0800
 
@@ -295,7 +364,7 @@ Date:   Thu Nov 30 09:43:10 2006 -0800
     Fix padding bugs discovered in XCB work
 
 commit c27ece25924115448bf9e1dc461d5e7f4112f112
-Merge: 3305f63... 7363d44...
+Merge: 3305f63 7363d44
 Author: Eric Anholt <eric@anholt.net>
 Date:   Mon Nov 27 15:31:33 2006 -0800
 
diff --git a/proto/randrproto/configure.ac b/proto/randrproto/configure.ac
index 320e56088..5cfa3ec31 100644
--- a/proto/randrproto/configure.ac
+++ b/proto/randrproto/configure.ac
@@ -22,13 +22,17 @@ dnl
 dnl Process this file with autoconf to create configure.
 
 AC_PREREQ([2.57])
-AC_INIT([RandrProto], [1.3.0], [https://bugs.freedesktop.org/enter_bug.cgi?product=xorg])
+AC_INIT([RandrProto], [1.3.1], [https://bugs.freedesktop.org/enter_bug.cgi?product=xorg])
 AM_INIT_AUTOMAKE([foreign dist-bzip2])
 
 # Require xorg-macros: XORG_CHANGELOG
-m4_ifndef([XORG_MACROS_VERSION], [AC_FATAL([must install xorg-macros 1.2 or later before running autoconf/autogen])])
-XORG_MACROS_VERSION(1.2)
-XORG_RELEASE_VERSION
+
+# Require xorg-macros: XORG_DEFAULT_OPTIONS
+m4_ifndef([XORG_MACROS_VERSION], [AC_FATAL([must install xorg-macros 1.3 or later before running autoconf/autogen])])
+XORG_MACROS_VERSION(1.3)
+
+XORG_DEFAULT_OPTIONS
+
 XORG_CHANGELOG
 
 AC_OUTPUT([Makefile
diff --git a/proto/randrproto/randr.h b/proto/randrproto/randr.h
index c624d96b2..1ee95f936 100644
--- a/proto/randrproto/randr.h
+++ b/proto/randrproto/randr.h
@@ -151,6 +151,7 @@ typedef unsigned long	XRandrModeFlags;
 
 /* Conventional RandR output properties */
 
+#define RR_PROPERTY_BACKLIGHT		"Backlight"
 #define RR_PROPERTY_RANDR_EDID		"EDID"
 #define RR_PROPERTY_SIGNAL_FORMAT	"SignalFormat"
 #define RR_PROPERTY_SIGNAL_PROPERTIES	"SignalProperties"
diff --git a/proto/randrproto/randrproto.txt b/proto/randrproto/randrproto.txt
index 1af20905a..c56bd5f29 100644
--- a/proto/randrproto/randrproto.txt
+++ b/proto/randrproto/randrproto.txt
@@ -1,13 +1,13 @@
 	       The X Resize, Rotate and Reflect Extension
-			      Version 1.3
-			       2006-20-7
-      
+			     Version 1.3.1
+			       2009-10-5
+
 			      Jim Gettys
 			   Jim.Gettys@hp.com
 		     Cambridge Research Laboratory
 				HP Labs
 			Hewlett Packard Company
-      
+
 			     Keith Packard
 			keith.packard@intel.com
 		     Open Source Technology Center
@@ -35,13 +35,13 @@ These events include:
 	on laptops or desktop systems
       ► The continued decline of legacy toolkits whose design would have
         required depth switching to support migration
-      ► The lack of depth switching implementation experience in the 
+      ► The lack of depth switching implementation experience in the
         intervening time, due to events beyond our control
 
 Additionally, the requirement to support depth switching might
 complicate other re-engineering of the device independent part of the
 X server that is currently being contemplated.
-	
+
 Rather than further delaying RandR's widespread deployment for a feature
 long wanted by the community (resizing of screens, particularly on laptops),
 or the deployment of a protocol design that might be flawed due to lack of
@@ -61,7 +61,7 @@ monitors display portions of a common underlying screen. In this environment,
 zero or more video outputs are associated with each CRT controller which
 defines both a set of video timings and a 'viewport' within the larger
 screen. This viewport is independent of the overall size of the screen, and
-may be located anywhere within the screen. 
+may be located anywhere within the screen.
 
 The effect is to decouple the reported size of the screen from the size
 presented by each video output, and to permit multiple outputs to present
@@ -85,7 +85,7 @@ Additional requests and events are provided for this new functionality.
     ┃   ┏━━━╋━━━━━━━━━━━━━━━┫       ║        ║ ║        ║
     ┣━━━╋━━━┛               ┃       ╚════════╝ ╚════════╝
     │   ┃         2         ┃─────────────────┐
-    │   ┃                   ┃        ╔═══════════════════╗ 
+    │   ┃                   ┃        ╔═══════════════════╗
     │   ┃                   ┃        ║                   ║
     │   ┗━━━━━━━━━━━━━━━━━━━┫        ║        C          ║
     └───────────────────────┘        ║                   ║
@@ -215,7 +215,7 @@ RRCONFIGSTATUS { Success
 	A value of type RRCONFIGSTATUS returned when manipulating the output
 	configuration or querying information from the server that has some
 	time-dependency.
-	
+
 	InvalidConfigTime indicates that the supplied configuration
 	timestamp does not match the current X server configuration
 	timestamp. Usually this means that the output configuration has
@@ -249,7 +249,7 @@ ROTATION { Rotate_0
 
 RRSELECTMASK { RRScreenChangeNotifyMask
 	       RRCrtcChangeNotifyMask (New in version 1.2)
-	       RROutputChangeNotifyMask (New in version 1.2) 
+	       RROutputChangeNotifyMask (New in version 1.2)
 	       RROutputPropertyNotifyMask (New in version 1.2) }
 
 SIZEID { CARD16 }
@@ -342,25 +342,25 @@ The name of this extension is "RANDR".
 	the client connected, to avoid race conditions.
 
 	New for version 1.2:
-	
+
 	If 'enable' contains RRCrtcChangeMask, RRCrtcChangeNotify events
 	will be sent when a the configuration for a CRTC associated with the
 	screen changes, either through this protocol extension or due to
 	detected external changes. RRCrtcChangeNotify may also be sent when
 	this request executes if the CRTC configuration has changed since
-	the client connected, to avoid race conditions. 
-	
+	the client connected, to avoid race conditions.
+
 	If 'enable' contains RROutputChangeMask, RROutputChangeNotify events
 	will be sent when a the configuration for an output associated with
 	the screen changes, either through this protocol extension or due to
 	detected external changes. RROutputChangeNotify may also be sent
 	when this request executes if the output configuration has changed
-	since the client connected, to avoid race conditions. 
+	since the client connected, to avoid race conditions.
 
 	If 'enable' contains RROutputPropertyNotifyMask,
 	RROutputPropertyNotify events will be sent when properties change on
 	this output.
-	
+
 ┌───
     RRSetScreenConfig
 	window: WINDOW
@@ -381,7 +381,7 @@ The name of this extension is "RANDR".
 	If 'timestamp' is less than the time when the configuration was last
 	successfully set, the request is ignored and InvalidTime returned in
 	status.
-	
+
 	If 'config-timestamp' is not equal to when the server's screen
 	configurations last changed, the request is ignored and
 	InvalidConfigTime returned in status. This could occur if the
@@ -396,19 +396,19 @@ The name of this extension is "RANDR".
 	This request may fail for other indeterminate reasons, in which case
 	'status' will be set to Failed and no configuration change will be
 	made.
-	
+
 	This request sets the screen to the specified size, rate, rotation
 	and reflection.
 
 	When this request succeeds, 'status' contains Success and the
 	requested changes to configuration will have been made.
-	
+
 	'new-time-stamp' contains the time at which this request was
 	executed.
-	
+
 	'config-timestamp' contains the time when the possible screen
 	configurations were last changed.
-	
+
 	'root' contains the root window for the screen indicated by the
 	window.
 
@@ -421,7 +421,7 @@ The name of this extension is "RANDR".
 ┌───
     RRGetScreenInfo
 	window: WINDOW
-      ▶	
+      ▶
 	rotations: SETofROTATION
 	root: WINDOW
 	timestamp: TIMESTAMP
@@ -442,15 +442,15 @@ The name of this extension is "RANDR".
 	by the screen.
 
 	'root' is the root window of the screen.
-	
+
 	'config-timestamp' indicates when the screen configuration
 	information last changed: requests to set the screen will fail
 	unless the timestamp indicates that the information the client
 	is using is up to date, to ensure clients can be well behaved
-	in the face of race conditions. 
-	
+	in the face of race conditions.
+
 	'timestamp' indicates when the configuration was last set.
-	
+
 	'size-id' indicates which size is active.
 
 	'rate' is the current refresh rate. This is zero when the refresh
@@ -533,7 +533,7 @@ dynamic changes in the display environment.
 	to the screen associated with 'window'.
 
 	'timestamp' indicates when the configuration was last set.
-	
+
 	'config-timestamp' indicates when the configuration information last
 	changed. Requests to configure the output will fail unless the
 	timestamp indicates that the information the client is using is up
@@ -545,7 +545,7 @@ dynamic changes in the display environment.
 	'outputs' contains the list of outputs associated with the screen.
 
 	'modes' contains the list of modes associated with the screen
-	
+
 	This request explicitly asks the server to ensure that the
 	configuration data is up-to-date wrt the hardware. If that requires
 	polling, this is when such polling would take place.  If the
@@ -560,7 +560,7 @@ dynamic changes in the display environment.
 	status: RRCONFIGSTATUS
 	timestamp: TIMESTAMP
 	crtc: CRTC
-	
+
 	name: STRING
 	connection: CONNECTION
 	subpixel-order: SUBPIXELORDER
@@ -573,15 +573,15 @@ dynamic changes in the display environment.
 	Errors: Output
 
 	RRGetOutputInfo returns information about the current and available
-	configurations 'output'. 
-	
+	configurations 'output'.
+
 	If 'config-timestamp' does not match the current configuration
 	timestamp (as returned by RRGetScreenResources), 'status' is set to
 	InvalidConfigTime and the remaining reply data is empty. Otherwise,
 	'status' is set to Success.
 
 	'timestamp' indicates when the configuration was last set.
-	
+
 	'crtc' is the current source CRTC for video data, or Disabled if the
 	output is not connected to any CRTC.
 
@@ -592,7 +592,7 @@ dynamic changes in the display environment.
 	device connected to this output. If the hardware cannot determine
 	whether something is connected, it will set this to
 	UnknownConnection.
-	
+
 	'subpixel-order' contains the resulting subpixel order of the
 	connected device to allow correct subpixel rendering.
 
@@ -648,7 +648,7 @@ dynamic changes in the display environment.
 	and be automatically copied to the current value on the next
 	RRSetCrtcConfig request involving the named output. If 'pending' is
 	FALSE, changes are copied immediately.
-	
+
 	If 'range' is TRUE, then the valid-values list will contain
 	precisely two values indicating the minimum and maximum allowed
 	values. If 'range' is FALSE, then the valid-values list will contain
@@ -658,7 +658,7 @@ dynamic changes in the display environment.
 	If 'immutable' is TRUE, then the property configuration cannot be
 	changed by clients. Immutable properties are interpreted by the X
 	server.
-	
+
 ┌───
     RRConfigureOutputProperty
 	output: OUTPUT
@@ -687,7 +687,7 @@ dynamic changes in the display environment.
 	data: LISTofINT8 or LISTofINT16 or LISTofINT32
 └───
 	Errors: Alloc, Atom, Match, Value, Output
-	
+
 	This request alters the value of the property for the specified
 	output. If the property is marked as a 'pending' property, only the
 	pending value of the property is changed. Otherwise, changes are
@@ -702,7 +702,7 @@ dynamic changes in the display environment.
 	match the existing property value (or a Match error results).  If
 	the property is undefined, it is treated as defined with the correct
 	type and format with zero-length data.
-	
+
 	For Prepend, the data is tacked on to the beginning of the existing
 	data, and for Append, it is tacked on to the end of the existing data.
 
@@ -713,7 +713,7 @@ dynamic changes in the display environment.
 	destroyed, or until server reset (see section 10).
 
 	The maximum size of a property is server-dependent and may vary
-	dynamically.  
+	dynamically.
 
 ┌───
     RRDeleteOutputProperty
@@ -721,7 +721,7 @@ dynamic changes in the display environment.
 	property: ATOM
 └───
 	Errors: Atom, Output
-	
+
 	This request deletes the property from the specified window if the
 	property exists and generates a OutputPropertyNotify event unless
 	the property does not exist.
@@ -745,28 +745,28 @@ dynamic changes in the display environment.
 	If the specified property does not exist for the specified output,
 	then the return type is None, the format and bytes-after are zero,
 	and the value is empty.  The delete argument is ignored in this
-	case.  
-	
+	case.
+
 	If the specified property exists but its type does not match the
 	specified type, then the return type is the actual type of the
 	property, the format is the actual format of the property (never
 	zero), the bytes-after is the length of the property in bytes (even
 	if the format is 16 or 32), and the value is empty.  The delete
-	argument is ignored in this case.  
-	
+	argument is ignored in this case.
+
 	If the specified property exists and either AnyPropertyType is
 	specified or the specified type matches the actual type of the
 	property, then the return type is the actual type of the property,
 	the format is the actual format of the property (never zero), and
 	the bytes-after and value are as follows, given:
 
-		N = actual length of the stored property in bytes 
+		N = actual length of the stored property in bytes
 				  (even if the format is 16 or 32)
 		I = 4 × offset
 		T = N - I
 		L = MINIMUM(T, 4 × long-length)
 		A = N - (I + L)
-	
+
 	If 'pending' is true, and if the property holds a pending value,
 	then the value returned will be the pending value of the property
 	rather than the current value.  The returned value starts at byte
@@ -785,14 +785,14 @@ dynamic changes in the display environment.
       	mode: MODE
 └───
 	Errors: Window, Name, Value
-	
+
 	'modeinfo' provides a new mode for outputs on the screen
 	associated with 'window'. If the name of 'modeinfo' names an
 	existing mode, a Name error is returned.  If some parameter of the
 	mode is not valid in some other way, a Value error is returned.
 
 	The returned 'mode' provides the id for the mode.
-	
+
 ┌───
     RRDestroyMode
       	mode: MODE
@@ -803,7 +803,7 @@ dynamic changes in the display environment.
 	defined with RRCreateMode, else an Match error is returned.  If
 	'mode' is in use by some CRTC or Output, then an Access error is
 	returned.
-	
+
 ┌───
     RRAddOutputMode
 	output: OUTPUT
@@ -814,10 +814,10 @@ dynamic changes in the display environment.
 	'output' indicates which output is to be configured.
 
 	'mode' specifies which mode to add. If 'mode' is not valid for
-	'output', then a Match error is generated. 
+	'output', then a Match error is generated.
 
 	This request generates OutputChangeNotify events.
-	
+
 ┌───
     RRDeleteOutputMode
 	output: OUTPUT
@@ -845,7 +845,7 @@ dynamic changes in the display environment.
 	mode: MODE
 	rotation: ROTATION
 	outputs: LISTofOUTPUT
-	
+
 	rotations: SETofROTATION
 	possible-outputs: LISTofOUTPUT
 └───
@@ -860,23 +860,23 @@ dynamic changes in the display environment.
 	timestamp (as returned by RRGetScreenResources), 'status' is set to
 	InvalidConfigTime and the remaining reply data is empty. Otherwise,
 	'status' is set to Success.
-	
+
 	'timestamp' indicates when the configuration was last set.
-	
+
 	'x' and 'y' indicate the position of this CRTC within the screen
 	region. They will be set to 0 when the CRTC is disabled.
 
 	'width' and 'height' indicate the size of the area within the screen
 	presented by this CRTC. This may be different than the size of the
-	mode due to rotation. They will be set to 0 when the CRTC is
-	disabled.
-	
+	mode due to rotation. They will be set to 0 when the CRTC
+	is disabled.
+
 	'mode' indicates which mode is active, or None indicating that the
 	CRTC has been disabled and is not displaying the screen contents.
 
 	'rotation' indicates the active rotation. It is set to Rotate_0
 	when the CRTC is disabled.
-	
+
 	'outputs' is the list of outputs currently connected to this CRTC
 	and is empty when the CRTC is disabled.
 
@@ -904,7 +904,7 @@ dynamic changes in the display environment.
 	If 'timestamp' is less than the time when the configuration was last
 	successfully set, the request is ignored and InvalidTime returned in
 	status.
-	
+
 	If 'config-timestamp' is not equal to when the monitor's
 	configuration last changed, the request is ignored and
 	InvalidConfigTime returned in status. This could occur if the
@@ -929,16 +929,16 @@ dynamic changes in the display environment.
 
 	'outputs' contains the set of outputs that this CRTC should be
 	connected to. The set must be among the list of acceptable output
-	sets for this CRTC or a Match error results. 
-	
+	sets for this CRTC or a Match error results.
+
 	If 'mode' is None, then 'outputs' must be empty, else a Match error
 	results. Conversely, if 'mode' is not None, then 'outputs' must not be
 	empty, else a Match error results.
-	
+
 	This request may fail for other indeterminate reasons, in which case
 	'status' will be set to Failed and no configuration change will be
 	made.
-	
+
 	This request sets the CRTC to the specified position, mode, rotation
 	and reflection. The entire area of the CRTC must fit within the
 	screen size, else a Match error results. As an example, rotating the
@@ -955,10 +955,10 @@ dynamic changes in the display environment.
 
 	When this request succeeds, 'status' contains Success and the
 	requested changes to configuration will have been made.
-	
+
 	'new-time-stamp' contains the time at which this request was
 	executed.
-	
+
 ┌───
     RRGetCrtcGammaSize
 	crtc: CRTC
@@ -976,13 +976,13 @@ dynamic changes in the display environment.
       	red: LISTofCARD16
 	green: LISTofCARD16
 	blue: LISTofCARD16
-└─── 
+└───
 	Errors: Crtc
-	
+
 	This request returns the currently set gamma ramps for 'crtc'.  All
 	three lists will be the size returned by the RRGetCrtcGammaSize
 	request.
-	
+
 ┌───
     RRSetCrtcGamma
 	crtc: CRTC
@@ -991,7 +991,7 @@ dynamic changes in the display environment.
 	blue: LISTofCARD16
 └───
 	Errors: Crtc, Match
-	
+
 	This request sets the gamma ramps for 'crtc'. All three lists
 	must be the size returned by RRGetCrtcGammaSize else a Value error
 	results.
@@ -1014,7 +1014,7 @@ dynamic changes in the display environment.
 	connected to the screen associated with 'window'.
 
 	'timestamp' indicates when the configuration was last set.
-	
+
 	'config-timestamp' indicates when the configuration information last
 	changed. Requests to configure the output will fail unless the
 	timestamp indicates that the information the client is using is up
@@ -1025,8 +1025,8 @@ dynamic changes in the display environment.
 
 	'outputs' contains the list of outputs associated with the screen.
 
-	'modes' contains the list of modes associated with the screen
-	
+	'modes' contains the list of modes associated with the screen.
+
 	Unlike RRGetScreenResources, this merely returns the current
 	configuration, and does not poll for hardware changes.
 
@@ -1211,10 +1211,6 @@ dynamic changes in the display environment.
 	desktop environments to mark the screen that should hold the primary
 	menu bar or panel.
 
-	If the named output is not connected to any CRTC, or if the Window
-	and Output are not attached to the same screen, BadMatch is generated.
-	In the latter case, errorValue will be the Window, not the Output.
-
 	As this changes the logical layout of the screen, ConfigureNotify
 	and RRScreenChangeNotify will be generated on the appropriate root
 	window when the primary output is changed by this call. This request
@@ -1238,7 +1234,7 @@ dynamic changes in the display environment.
 └───
 	Errors: Window
 
-	RRGetOutputPrimary returns the primary output for the system.
+	RRGetOutputPrimary returns the primary output for the screen.
 
                               ❧❧❧❧❧❧❧❧❧❧❧
 
@@ -1401,6 +1397,83 @@ doesn't handle a mandatory property correctly.
 
 9.1 Known properties
 
+    "Backlight"			aka RR_PROPERTY_BACKLIGHT
+	Type:			int32
+	Flags:			-
+	Range/List:		0-x (driver specific)
+
+	This property controls the brightness on laptop panels and equivalent
+	displays with a backlight controller. The driver specific maximum
+	value MUST turn the backlight to full brightness, 1 SHOULD turn the
+	backlight to minimum brightness, 0 SHOULD turn the backlight off.
+
+    "CloneList"			aka RR_PROPERTY_CLONE_LIST
+	Type:			int32 [2*n] / Atom pairs
+	Flags:			Immutable
+	Range/List:		0-
+
+	Some combinations of outputs on some cards cannot be served
+	independently from each other, because they are wired up to the same
+	encoder outputs.
+	This property lists all output + signal format pairs that are
+	driven together with this output, and thus can only be programmed in
+	clone mode with the same CRTC.
+	This property MUST be symmetric, but may change with changing signal
+	format. I.e. if the property for DVI-1/VGA specifies VGA-1/VGA to be
+	cloned, VGA-1/VGA has to list DVI-1/VGA as well.
+	Outputs / format pairs listed in this property MUST be included in the
+	CompatibilityList.
+
+    "CompatibilityList"		aka RR_PROPERTY_COMPATIBILITY_LIST
+	Type:			int32 [2*n] / Atom pairs
+	Flags:			Immutable
+	Range/List:		0-
+
+	Some combinations of outputs on some cards cannot be served at all,
+	because the according encoder is only capable of driving one output at
+	a time.
+	This property lists all output + signal format pairs that can be
+	driven together with this output. NULL atoms specify any output / any
+	signal format, respectively.
+	This property MUST be symmetric, but may change with changing signal
+	format. I.e. if the property for DVI-1/TMDS specifies VGA-1/VGA to be
+	available, VGA-1/VGA has to list DVI-1/TMDS as well.
+
+    "ConnectorNumber"		aka RR_PROPERTY_CONNECTOR_NUMBER
+	Type:			int32
+	Flags:			Immutable, Static
+	Range/List:		0-
+
+	Outputs that route their signal to the same connector MUST
+	have the same connector number. Outputs with the same
+	connector number MUST route their signal to the same
+	connector, except if it is 0, which indicates unknown
+	connectivity. 1 is called the primary connector, 2 the
+	secondary. 3 is typically a TV connector, but that is completely
+	driver / hardware dependent.
+	Outputs with the same connector number SHOULD have the same
+	connector type. Meaning and client behavior for mismatching
+	connector types is undefined at the moment.
+
+    "ConnectorType"		aka RR_PROPERTY_CONNECTOR_TYPE
+	Type:			int32 / Atom
+	Flags:			Immutable, Static
+	Range/List:		unknown VGA DVI DVI‐I DVI‐A DVI‐D HDMI Panel
+				TV TV-Composite TV-SVideo TV-Component
+				TV-SCART TV-C4 DisplayPort
+
+	Connector type, as far as known to the driver.
+	Values with dashes (TV‐Composite) describe more specific versions of
+	the base values (TV). The former SHOULD be used if the connector is
+	not capable of producing other signal formats. The later SHOULD be
+	used if the exact connector is unknown, or the connector is a
+	multi‐format connector that is not described otherwise. DVI, for
+	instance, SHOULD be handled like a DVI‐I connector, unless additional
+	information is available to the user agent. PANEL describes
+	laptop‐internal (normally LVDS) displays. TV, TV‐SCART, TV‐Component,
+	and TV‐C4 with signal format VGA are valid combinations and describe
+	RGB TV signals.
+
     "EDID"			aka RR_PROPERTY_RANDR_EDID
 	Type:			int8 [n]
 	Flags:			Immutable
@@ -1408,7 +1481,7 @@ doesn't handle a mandatory property correctly.
 
 	Raw EDID data from the device attached to the according
 	output. Should include main EDID data and all extension
-	blocks.
+	blocks. Previously known as EdidData.
 
     "SignalFormat"		aka RR_PROPERTY_SIGNAL_FORMAT
 	Type:			int32 / Atom
@@ -1454,93 +1527,32 @@ doesn't handle a mandatory property correctly.
 	a signal change (e.g. TV formats).  Clients are allowed to change the
 	properties in order to select a different signal subformat.
 
-    "ConnectorType"		aka RR_PROPERTY_CONNECTOR_TYPE
-	Type:			int32 / Atom
-	Flags:			Immutable, Static
-	Range/List:		unknown VGA DVI DVI‐I DVI‐A DVI‐D HDMI Panel
-				TV TV-Composite TV-SVideo TV-Component
-				TV-SCART TV-C4 DisplayPort
-
-	Connector type, as far as known to the driver.
-	Values with dashes (TV‐Composite) describe more specific versions of
-	the base values (TV). The former SHOULD be used if the connector is
-	not capable of producing other signal formats. The later SHOULD be
-	used if the exact connector is unknown, or the connector is a
-	multi‐format connector that is not described otherwise. DVI, for
-	instance, SHOULD be handled like a DVI‐I connector, unless additional
-	information is available to the user agent. PANEL describes
-	laptop‐internal (normally LVDS) displays. TV, TV‐SCART, TV‐Component,
-	and TV‐C4 with signal format VGA are valid combinations and describe
-	RGB TV signals.
-
-    "ConnectorNumber"		aka RR_PROPERTY_CONNECTOR_NUMBER
-	Type:			int32
-	Flags:			Immutable, Static
-	Range/List:		0-
-
-	Outputs that route their signal to the same connector MUST
-	have the same connector number. Outputs with the same
-	connector number MUST route their signal to the same
-	connector, except if it is 0, which indicates unknown
-	connectivity. 1 is called the primary connector, 2 the
-	secondary. 3 is typically a TV connector, but that is completely
-	driver / hardware dependent.
-	Outputs with the same connector number SHOULD have the same
-	connector type. Meaning and client behavior for mismatching
-	connector types is undefined at the moment.
-
-    "CompatibilityList"		aka RR_PROPERTY_COMPATIBILITY_LIST
-	Type:			int32 [2*n] / Atom pairs
-	Flags:			Immutable
-	Range/List:		0-
-
-	Some combinations of outputs on some cards cannot be served at all,
-	because the according encoder is only capable of driving one output at
-	a time.
-	This property lists all output + signal format pairs that can be
-	driven together with this output. NULL atoms specify any output / any
-	signal format, respectively.
-	This property MUST be symmetric, but may change with changing signal
-	format. I.e. if the property for DVI-1/TMDS specifies VGA-1/VGA to be
-	available, VGA-1/VGA has to list DVI-1/TMDS as well.
-
-    "CloneList"			aka RR_PROPERTY_CLONE_LIST
-	Type:			int32 [2*n] / Atom pairs
-	Flags:			Immutable
-	Range/List:		0-
-
-	Some combinations of outputs on some cards cannot be served
-	independently from each other, because they are wired up to the same
-	encoder outputs.
-	This property lists all output + signal format pairs that are
-	driven together with this output, and thus can only be programmed in
-	clone mode with the same CRTC.
-	This property MUST be symmetric, but may change with changing signal
-	format. I.e. if the property for DVI-1/VGA specifies VGA-1/VGA to be
-	cloned, VGA-1/VGA has to list DVI-1/VGA as well.
-	Outputs / format pairs listed in this property MUST be included in the
-	CompatibilityList.
-
 
 9.2 Properties introduced with version 1.2 of the RandR extension
 
 Property			Immutable	Mandatory since
 ────────			─────────	───────────────
-EdidData			yes		n/a
+EDID				yes		n/a
 
-EdidData is provided by the RandR frontend, thus not driver specific.
+EDID is provided by the RandR frontend, thus not driver specific.
 
 
 9.3 Properties introduced with version 1.3 of the RandR extension
 
 Property			Immutable	Mandatory since
 ────────			─────────	───────────────
+CloneList			yes		not mandatory
+CompatibilityList		yes		not mandatory
+ConnectorNumber			yes: static	not mandatory
+ConnectorType			yes: static	RandR 1.3
 SignalFormat			no		RandR 1.3
 SignalProperties		no		not mandatory
-ConnectorType			yes: static	RandR 1.3
-ConnectorNumber			yes: static	not mandatory
-CompatibilityList		yes		not mandatory
-CloneList			yes		not mandatory
+
+9.4 Properties introduced with version 1.4 of the RandR extension
+
+Property			Immutable	Mandatory since
+────────			─────────	───────────────
+Backlight			no		not mandatory
 
                               ❧❧❧❧❧❧❧❧❧❧❧
 
@@ -1655,7 +1667,7 @@ A.1 Common Types
 	0x0008	OutputPropertyNotifyMask	Added in version 1.2
 └───
       Event select mask for RRSelectInput
-      
+
 ┌───
     RRCONFIGSTATUS
 	0x0 Success
@@ -1664,7 +1676,7 @@ A.1 Common Types
 	0x3 Failed
 └───
 	Return status for requests which depend on time.
-	
+
 ┌───
     MODEINFO (32)				Added in version 1.2
 	4	CARD32		id
@@ -1681,7 +1693,7 @@ A.1 Common Types
 	2	CARD16		name length
 	4	SETofMODEFLAG	mode flags
 └───
-	
+
 	An output mode specifies the complete CRTC timings for
 	a specific mode. The vertical and horizontal synchronization rates
 	can be computed given the dot clock and the h total/v total
@@ -1689,7 +1701,7 @@ A.1 Common Types
 	parameters and flags are not used, and must be zero as this
 	indicates that the timings are unknown or otherwise unused.
 	The name itself will be encoded separately in each usage.
-	
+
 ┌───
     MODEFLAG
 	0x00000001	HSyncPositive
@@ -1738,7 +1750,7 @@ errors if used in version 1.0.
 └───
 ┌───
     RRSetScreenConfig
-	
+
 	1	CARD8			major opcode
 	1	2			RandR opcode
 	2	6			length
@@ -2171,7 +2183,7 @@ A.2.2 Protocol Requests added with version 1.3
 	p				unused, p=pad(n)
 	4v	FIXED			filter params
 └───
-    
+
 ┌───
     RRGetCrtcTransform
 	1	CARD8			major opcode
@@ -2199,7 +2211,7 @@ A.2.2 Protocol Requests added with version 1.3
 	cnp				unused, cnp=pad(cn)
 	4*cf	FIXED			current filter params
 └───
-    
+
 ┌───
     RRGetPanning
 	1	CARD8			major opcode
@@ -2261,7 +2273,7 @@ A.2.2 Protocol Requests added with version 1.3
 	4	WINDOW			window
 	4	OUTPUT			output
 └───
-    
+
 ┌───
     RRGetOutputPrimary
 	1	CARD8			major opcode
@@ -2355,13 +2367,13 @@ A.4 Protocol Errors
 	Base + 1		Crtc
 	Base + 2		Mode
 └───
-	
+
 Bibliography
 
 [RANDR] Gettys, Jim and Keith Packard, "The X Resize and Rotate
 	Extension - RandR", Proceedings of the 2001 USENIX Annual
 	Technical Conference, Boston, MA
 
-[RENDER] 
+[RENDER]
 	Packard, Keith, "The X Rendering Extension", work in progress,
-	documents found in xc/specs/Render.
+	http://cgit.freedesktop.org/xorg/proto/renderproto/tree/renderproto.txt