[Pkg-shadow-devel] shadowconfig(8) manual page

[Alejandro Colomar]

Hi Chris,

I was looking at the patches that Debian carries for shadow, and found a
horrible-looking manual page.  Here's a new year present for you.  :)

I see that you generate it from the XML, but I hate those generated
pages, and since you're already downstream, you probably don't need
that.  I guess you can handle the man(7) page directly.

I'm not good at using quilt, so I didn't try editing the quilt patch.
Instead, I provide you with the source code below.  In case you want a
git commit to transform it into a quilt patch, you can get this page
from my server:
<https://www.alejandro-colomar.es/src/alx/shadow/alx/shadow.git/commit/?h=shadowconfig_man>


Have a lovely new year!
Alex


Here goes the page:


.TH shadowconfig 8 2025-01-01 "Debian shadow-utils"
.SH Name
shadowconfig \- toggle shadow passwords on and off
.
.
.SH Synopsis
.SY shadowconfig
.BR on | off
.YS
.
.
.SH Description
.I shadowconfig\ on
will turn shadow passwords on.
.P
.I shadowconfig\ off
will turn shadow passwords off.
.
.
.SH Errors
.B shadowconfig
will print an error message and exit with a nonzero code
if it finds anything awry.
If that happens,
you should correct the error and run it again.
Turning shadow passwords on when they are already on,
or off when they are already off,
is harmless.
.
.
.SH Caveats
Turning shadow passwords off and on again
will lose all password aging information.
.
.
.SH See also
Read
.I /usr/share/doc/passwd/README.Debian
for a brief introduction to shadow passwords and related features.


-- 
<https://www.alejandro-colomar.es/>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/pkg-shadow-devel/attachments/20250101/adb27a73/attachment.sig>