From 9f1a43996cf9524cbca7f3c98ae7c0f1230f6dc6 Mon Sep 17 00:00:00 2001
From: Sevan Janiyan <venture37@geeklan.co.uk>
Date: Fri, 12 Mar 2021 23:56:38 +0000
Subject: [PATCH] Note the use of an ampersand in the comment field

---
 man/passwd.5.xml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/man/passwd.5.xml b/man/passwd.5.xml
index 7738d09a..4011e673 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>