From 34b062d31122e4498d93c6bd0cf7b96361efccb6 Mon Sep 17 00:00:00 2001
From: Thorsten Kukuk <kukuk@suse.com>
Date: Thu, 9 Mar 2023 10:11:05 +0100
Subject: manual pages: document usage of $DISPLAY and PAM_TTY

man/pam_item_types_std.inc.xml: In the past, PAM_TTY was used for tty
devices and $DISPLAY variables for X-based applications. With the
introduction of PAM_DISPLAY PAM_TTY should only be used for devices.
---
 doc/man/pam_item_types_std.inc.xml | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

(limited to 'doc')

diff --git a/doc/man/pam_item_types_std.inc.xml b/doc/man/pam_item_types_std.inc.xml
index 9b229486..b91c71bd 100644
--- a/doc/man/pam_item_types_std.inc.xml
+++ b/doc/man/pam_item_types_std.inc.xml
@@ -40,10 +40,12 @@
         <term>PAM_TTY</term>
         <listitem>
           <para>
-            The terminal name: prefixed by <filename>/dev/</filename> if
-            it is a device file; for graphical, X-based, applications the
-            value for this item should be the
-            <emphasis>$DISPLAY</emphasis> variable.
+            The terminal name prefixed by <filename>/dev/</filename> for
+            device files.
+            In the past, graphical X-based applications used to store the
+            <emphasis>$DISPLAY</emphasis> variable here, but with the
+            introduction of <emphasis>PAM_XDISPLAY</emphasis> this usage
+            is deprecated.
           </para>
         </listitem>
       </varlistentry>
@@ -134,4 +136,4 @@
         </listitem>
       </varlistentry>
 
-    </variablelist>
\ No newline at end of file
+    </variablelist>
-- 
cgit v1.2.1