From 52c04fea33392a35ea291b2e1ff82c3992492e22 Mon Sep 17 00:00:00 2001
From: Luca Boccassi <bluca@debian.org>
Date: Thu, 20 Apr 2023 13:11:28 +0100
Subject: man: clarify PAM_DATA_SILENT in pam_set_data.3

pam_end.3 has additional and important information about PAM_DATA_SILENT,
copy it to pam_set_data.3 since that describes the cleanup callback where
it will be set.
---
 doc/man/pam_set_data.3.xml | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

(limited to 'doc')

diff --git a/doc/man/pam_set_data.3.xml b/doc/man/pam_set_data.3.xml
index 2bcfeb0b..f8c89883 100644
--- a/doc/man/pam_set_data.3.xml
+++ b/doc/man/pam_set_data.3.xml
@@ -113,7 +113,13 @@
           <para>
             Which indicates that the process would prefer to perform the
             <function>cleanup()</function> quietly. That is, discourages
-            logging/messages to the user.
+            logging/messages to the user. It is generally used to indicate that
+            the current closing of the library is in a
+            <citerefentry>
+              <refentrytitle>fork</refentrytitle><manvolnum>2</manvolnum>
+            </citerefentry>ed
+            process, and that the parent will take care of cleaning up things
+            that exist outside of the current process space (files etc.).
           </para>
         </listitem>
       </varlistentry>
-- 
cgit v1.2.3