From 6be13b2f84a2c1a0d0f4129b5258b4b443e7f86c Mon Sep 17 00:00:00 2001
From: Alejandro Colomar <alx@kernel.org>
Date: Fri, 16 Jan 2026 01:52:32 +0100
Subject: [PATCH] man/shadow.5.xml: Document "*"

Signed-off-by: Alejandro Colomar <alx@kernel.org>
---
 man/shadow.5.xml | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/man/shadow.5.xml b/man/shadow.5.xml
index dc7fdfde..d3cc0398 100644
--- a/man/shadow.5.xml
+++ b/man/shadow.5.xml
@@ -82,8 +82,12 @@
 	    If the password field begins with an exclamation mark <emphasis>!</emphasis>,
 	    the password is locked.
 	    The remaining characters on the
-	    line represent the password field before the password was
-	    locked.
+	    line represent the password hash.
+	  </para>
+	  <para>
+	    If the password hash consists of a star <emphasis>*</emphasis>,
+	    password access is effectively disallowed;
+	    this is because no password can produce a hash like this.
 	  </para>
 	  <para>
 	    Refer to <citerefentry><refentrytitle>crypt</refentrytitle>