From: Dominika Borges Date: Wed, 19 Mar 2025 14:58:54 +0000 (+0100) Subject: man: Update doc style in shadow man page X-Git-Tag: 4.18.0-rc2~7 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=8d19543da13548b8434ed5bf3af5c1308eb45431;p=thirdparty%2Fshadow.git man: Update doc style in shadow man page --- diff --git a/man/shadow.5.xml b/man/shadow.5.xml index e06598687..dc7fdfde5 100644 --- a/man/shadow.5.xml +++ b/man/shadow.5.xml @@ -72,15 +72,16 @@ encrypted password - This field may be empty, in which case no passwords are - required to authenticate as the specified login name. - However, some applications which read the - /etc/shadow file may decide not to permit - any access at all if the password field is empty. + If the password field is empty, the user can log in without a password. + However, some applications that read + the /etc/shadow file + might block access + if the password field is empty. - A password field which starts with an exclamation mark means - that the password is locked. The remaining characters on the + If the password field begins with an exclamation mark !, + the password is locked. + The remaining characters on the line represent the password field before the password was locked. @@ -90,11 +91,11 @@ this string is interpreted. - If the password field contains some string that is not a valid + If the password field contains a string that is not a valid result of crypt 3, for instance ! or *, - the user will not be able to use a unix password to log in - (but the user may log in the system by other means). + the user cannot use a UNIX password to log in. + However, the user may log in the system by other means. @@ -108,9 +109,8 @@ of days since 1970-01-01 00:00:00 UTC. - The value 0 has a special meaning, which is that the user - should change her password the next time she will log in the - system. + The value 0 indicates that the user must change their password + the next time they log in to the system. An empty field means that password aging features are @@ -122,9 +122,8 @@ minimum password age - The minimum password age is the number of days the user will - have to wait before she will be allowed to change her password - again. + The minimum password age is the number of days the user must wait + before they can change their password again. An empty field and value 0 mean that there is no minimum @@ -137,12 +136,11 @@ The maximum password age is the number of days after which the - user will have to change her password. + user must change their password. - After this number of days is elapsed, the password may still - be valid. The user should be asked to change her password the - next time she will log in. + After this number of days has elapsed, the password may still be valid. + The user is prompted to change their password at the next login. An empty field means that there are no maximum password age, @@ -161,12 +159,12 @@ - The number of days before a password is going to expire (see - the maximum password age above) during which the user should - be warned. + The number of days before a password expires + (see the maximum password age above) + during which the user is warned. - An empty field and value 0 mean that there are no password + An empty field and value 0 mean that there is no password warning period. @@ -177,19 +175,17 @@ - The number of days after a password has expired (see the - maximum password age above) during which the password should - still be accepted (and the user should update her password - during the next login). + The number of days after a password expires + (see the maximum password age above) + during which the password is still accepted, + and the user must update their password at the next login. - After expiration of the password and this expiration period is - elapsed, no login is possible for the user. The user should contact - her administrator. + After the password expires and the password inactivity period elapses, + the user cannot log in and must contact their administrator. - An empty field means that there are no enforcement of an - inactivity period. + An empty string means that no inactivity period is enforced. @@ -199,22 +195,22 @@ - The date of expiration of the account, expressed as the number - of days since 1970-01-01 00:00:00 UTC. + The date when the account expires, + expressed as the number of days since 1970-01-01. - Note that an account expiration differs from a password - expiration. In case of an account expiration, the user shall - not be allowed to login. In case of a password expiration, - the user is not allowed to login using her password. + Note that account expiration differs from password expiration. + Account expiration prevents the user from logging in, + whereas password expiration only prevents users from logging in + with their password. - An empty field means that the account will never expire. + An empty field means that the account never expires. - The value 0 should not be used as it is interpreted as either - an account with no expiration, or as an expiration on Jan 1, - 1970. + The value 0 should not be used, + as it is interpreted either as an account with no expiration + or as an expiration date of 1970-01-01.