Add some guidelines for configure X11 for flatpanel widescreens.

PR:		103530
Submitted by:	Shaun Jurrens <shaun _at_ shamz dot net>
Approved by:	delphij (mentor)

en_US.ISO8859-1/books/handbook/x11/chapter.sgml

@@ -679,6 +679,83 @@ EndSection</programlisting>
           X11 configuration file:</para>
         <programlisting>Option "NoDDC"</programlisting>
       </sect3>
+
+      <sect3>
+	<title>Adding a Widescreen Flatpanel to the Mix</title>
+
+	<indexterm><primary>widescreen flatpanel configuration</primary></indexterm>
+
+	<para>This section assumes a bit of advanced configuration knowledge. 
+	  If attempts to use the standard configuration tools above have not
+	  resulted in a working configuration, there is information enough
+	  in the log files to be of use in getting the setup working. 
+	  Use of a text editor will be necessary.</para> 
+
+	<para>Current Widescreen (WSXGA, WSXGA+, WUXGA, WXGA, WXGA+, et.al.)
+	  formats support 16:10 and 10:9 formats or aspect ratios that can 
+	  be problematic. Examples of some common screen resolutions for 
+	  16:10 aspect ratios are:</para>
+
+	<itemizedlist>
+	  <listitem><para>2560x1600</para></listitem>
+	  <listitem><para>1920x1200</para></listitem>
+	  <listitem><para>1680x1050</para></listitem>
+	  <listitem><para>1440x900</para></listitem>
+	  <listitem><para>1280x800</para></listitem>
+	</itemizedlist>
+
+	<para>At some point, it will be as easy as adding one of these 
+	  resolutions as a possible Mode in the Section "Screen" as such:</para>
+
+	<programlisting>Section "Screen"
+Identifier "Screen0"
+Device     "Card0"
+Monitor    "Monitor0"
+DefaultDepth 24
+SubSection "Display"
+	Viewport  0 0
+	Depth     24
+	Modes     "1680x1050"
+EndSubSection
+EndSection</programlisting>
+
+	<para><application>&xorg;</application> is smart enough to pull the 
+	  resolution information from  the widescreen via I2C/DDC information
+	  so it knows what the monitor can handle as far as frequencies
+	  and resolutions.</para>
+
+	<para>If those ModeLines do not exist in the drivers,
+	  one might need to give <application>&xorg;</application> a little hint.
+	  Using <filename>/var/log/Xorg.0.log</filename> one can extract 
+	  enough information to manually create a ModeLine that will work.
+	  Simply look for information resembling this:</para>
+
+	<programlisting>(II) MGA(0): Supported additional Video Mode:
+(II) MGA(0): clock: 146.2 MHz   Image Size:  433 x 271 mm
+(II) MGA(0): h_active: 1680  h_sync: 1784  h_sync_end 1960 h_blank_end 2240 h_border: 0
+(II) MGA(0): v_active: 1050  v_sync: 1053  v_sync_end 1059 v_blanking: 1089 v_border: 0
+(II) MGA(0): Ranges: V min: 48  V max: 85 Hz, H min: 30  H max: 94 kHz, PixClock max 170 MHz</programlisting>
+
+	<para>This information is called EDID information. Creating a 
+	  ModeLine from this is just a matter of putting the numbers in the 
+	  correct order:</para>
+
+	<programlisting> ModeLine &lt;name&gt; &lt;clock&gt; &lt;4 horiz. timings&gt; &lt;4 vert. timings&gt;</programlisting>
+
+	<para>So that the ModeLine in Section "Monitor" for this example 
+	  would look like this:</para>
+
+	<programlisting>Section "Monitor"
+Identifier      "Monitor1"
+VendorName      "Bigname"
+ModelName       "BestModel" 
+ModeLine        "1680x1050" 146.2 1680 1784 1960 2240 1050 1053 1059 1089 
+Option          "DPMS"
+EndSection</programlisting>
+
+	<para>Now having completed these simple editing steps, X should start
+	  on your new widescreen monitor. 
+      </sect3>
     </sect2>
   </sect1>