From: Sevan Janiyan <venture37@geeklan.co.uk>
Date: Fri, 12 Mar 2021 23:56:38 +0000 (+0000)
Subject: Note the use of an ampersand in the comment field
X-Git-Tag: v4.9~31^2
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=refs%2Fpull%2F314%2Fhead;p=thirdparty%2Fshadow.git

Note the use of an ampersand in the comment field
---

diff --git a/man/passwd.5.xml b/man/passwd.5.xml
index 7738d09a0..4011e6731 100644
--- a/man/passwd.5.xml
+++ b/man/passwd.5.xml
@@ -136,9 +136,12 @@
       (but the user may log in the system by other means).
     </para>
     <para>
-      The comment field is used by various system utilities, such as
+      The comment field, also known as the gecos field, is used by
+      various system utilities, such as
       <citerefentry><refentrytitle>finger</refentrytitle>
-      <manvolnum>1</manvolnum></citerefentry>.
+      <manvolnum>1</manvolnum></citerefentry>. The use of an ampersand
+      here will be replaced by the capitalised login name when the field
+      is used or displayed by such system utilities.
     </para>
 
     <para>