Changeset 4ada352

Timestamp:

07/26/2023 08:04:06 AM (10 months ago)

Author:

Xi Ruoyao <xry111@…>

Branches:

12.0, 12.1, ken/TL2024, ken/tuningfonts, lazarus, plabs/newcss, python3.11, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18

Children:

9871a7a6

Parents:

2ac9944

git-author:

Xi Ruoyao <xry111@…> (07/26/2023 07:56:42 AM)

git-committer:

Xi Ruoyao <xry111@…> (07/26/2023 08:04:06 AM)

Message:

xorg-config: Some reword about the TearFree control

1. Move the configuration file into /etc, to be consistent with other configuration files created in BLFS.
2. We no longer need a separate "configure the graphic card" example because the TearFree configuration file is already a good example.
3. Tearing issue is really not new after xf86-video-* removal. In some xf86-video-* drivers a TearFree option is available but rarely enabled by default (only the amdgpu driver when the output is rotated or transformed). So this is actually the first time we document it in BLFS.
4. It's really not difficult to observer the tearing by dragging a window in twm, despite twm only renders the window border during dragging.

File:

• x/installing/xorg-config.xml (modified) (2 diffs)

x/installing/xorg-config.xml

@@ -481 +481 @@
 
       <para>
-        With modern Xorg, little or no additional graphic card configuration
-        is necessary. If you should need extra options passed to your video
-        driver, for instance, you could use something like the following
-        (again, executed as the &root; user):
-      </para>
-
-<screen role="root"><userinput>cat &gt; /etc/X11/xorg.conf.d/videocard-0.conf &lt;&lt; "EOF"
-<literal>Section "Device"
-    Identifier  "Videocard0"
-    Driver      "modesetting"
-    VendorName  "Videocard vendor"
-    BoardName   "ATI Radeon 7500"
-    Option      "AccelMethod" "none"
-EndSection</literal>
-EOF</userinput></screen>
-
-      <para>
-        Some graphics cards may have problems with screen tearing now that Xorg
-        has moved to using the modesetting driver in BLFS. To resolve the screen
-        tearing problems, create a configuration file that enables the TearFree
-        option. Note that you must have the Tearfree patch applied from
-        <xref role="nodep" linkend="xorg-server"/> for this to function
-        properly.
-      </para>
-
-<screen role="root"><userinput>cat &gt; /usr/share/X11/xorg.conf.d/20-tearfree.conf &lt;&lt; "EOF"
+        When you drag a window in twm (or any non-compositing window
+        manager) horizontally, you may observe that the vertical borders
+        of the window are broken into multiple segments.  This is an example
+        of the visual artifacts called <emphasis>screen tearing</emphasis>.
+        To resolve the screen tearing problems, create a configuration file
+        that enables the TearFree option. Note that you must have the
+        Tearfree patch applied from <xref role="nodep"
+        linkend="xorg-server"/> for this to function properly, and it may
+        increase memory allocation and reduce performance.
+      </para>
+
+<screen role="root"><userinput>cat &gt; /etc/X11/xorg.conf.d/20-tearfree.conf &lt;&lt; "EOF"
 <literal>Section "Device"
    Identifier "Graphics Adapter"
@@ -514 +500 @@
 EOF</userinput></screen>
 
+      <para>
+        With modern Xorg, little or no additional graphic card configuration
+        is necessary. If you should need extra options passed to your video
+        driver, add them into the <literal>Device</literal> section as well.
+        The options supported by the modesetting driver are documented in
+        the man page <filename>modesetting(4)</filename>.
+      </para>
+
     </sect3>
   </sect2>