From: Markus Hiereth <post@hiereth.de>
Date: Wed, 8 Jan 2025 21:45:54 +0000 (+0100)
Subject: chfn.1 man page improvements
X-Git-Tag: 4.18.0-rc1~113
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=9df7d8c92fb7f06db6bad05b9f407834f9f1139f;p=thirdparty%2Fshadow.git

chfn.1 man page improvements

Bug-Debian: https://bugs.debian.org/1004688
---

diff --git a/man/chfn.1.xml b/man/chfn.1.xml
index a5b9040e8..2fa49feb0 100644
--- a/man/chfn.1.xml
+++ b/man/chfn.1.xml
@@ -41,7 +41,7 @@
   </refmeta>
   <refnamediv id='name'>
     <refname>chfn</refname>
-    <refpurpose>change real user name and information</refpurpose>
+    <refpurpose>change full user name and information</refpurpose>
   </refnamediv>
 
   <refsynopsisdiv id='synopsis'>
@@ -59,9 +59,10 @@
   <refsect1 id='description'>
     <title>DESCRIPTION</title>
     <para>
-      The <command>chfn</command> command changes user fullname,
+      The <command>chfn</command> command changes the user's full name,
       office room number, office phone number, and home phone number information
-      for a user's account. This information is typically printed by
+      for an account in the respective fields of <filename>/etc/passwd</filename>.
+      This information is typically printed by
       <citerefentry><refentrytitle>finger</refentrytitle><manvolnum>1</manvolnum>
       </citerefentry> and similar programs. A normal user may only change
       the fields for her own account, subject to the restrictions in
@@ -80,7 +81,10 @@
       numbers. The <emphasis remap='I'>other</emphasis> field is used to
       store accounting information used by other applications.
     </para>
-
+    <para>
+      If <replaceable>LOGIN</replaceable> is not specified, <command>chfn</command>
+      acts on the current user, and prompts for the current user's password.
+    </para>
   </refsect1>
 
   <refsect1 id='options'>
@@ -134,7 +138,6 @@
 	    Apply changes in the <replaceable>CHROOT_DIR</replaceable>
 	    directory and use the configuration files from the
 	    <replaceable>CHROOT_DIR</replaceable> directory.
-	    Only absolute paths are supported.
 	  </para>
 	</listitem>
       </varlistentry>
@@ -156,13 +159,12 @@
       </varlistentry>
     </variablelist>
     <para>
-      If none of the options are selected, <command>chfn</command>
-      operates in an interactive fashion, prompting the user with the
+      If none of the options is selected, <command>chfn</command> operates
+      in an interactive fashion, prompting the user with the
       current values for all of the fields. Enter the new value to change
       the field, or leave the line blank to use the current value. The
-      current value is displayed between a pair of <emphasis remap='B'>[
-      ]</emphasis> marks. Without options, <command>chfn</command>
-      prompts for the current user account.
+      current value is displayed between a pair of <emphasis remap='B'>
+      []</emphasis> marks.
     </para>
   </refsect1>