From a22e17e45044cf1e3c116cc721b91ce1c9f4635d Mon Sep 17 00:00:00 2001
From: "Richard W.M. Jones" <rjones@redhat.com>
Date: Tue, 5 May 2026 12:12:12 +0100
Subject: [PATCH] sysprep: Rework documentation

Minor reworking:

 - expand description

 - combine multiple notes into one section

(cherry picked from commit b20cbdc6d003026403bedbe23e6c7841e22e324e)
---
 sysprep/virt-sysprep.pod | 21 ++++++++++++---------
 1 file changed, 12 insertions(+), 9 deletions(-)

diff --git a/sysprep/virt-sysprep.pod b/sysprep/virt-sysprep.pod
index 799764c8e..4f552b385 100644
--- a/sysprep/virt-sysprep.pod
+++ b/sysprep/virt-sysprep.pod
@@ -19,12 +19,13 @@ virt-sysprep - Reset, unconfigure or customize a virtual machine so clones can b
 
 =head1 DESCRIPTION
 
-Virt-sysprep can reset or unconfigure a virtual machine so that
-clones can be made from it.  Steps in this process include removing
-SSH host keys, removing persistent network MAC configuration, and
-removing user accounts.  Virt-sysprep can also customize a virtual
-machine, for instance by adding SSH keys, users or logos.  Each step
-can be enabled or disabled as required.
+Virt-sysprep can reset or unconfigure a virtual machine so that clones
+can be made from it, or to prepare a template from which clones can be
+made later on.  Steps in this process include removing SSH host keys,
+removing persistent network MAC configuration, and removing user
+accounts.  Virt-sysprep can also customize a virtual machine, for
+instance by adding SSH keys, users or logos.  Each step can be enabled
+or disabled as required.
 
 Virt-sysprep modifies the guest or disk image I<in place>.  The guest
 must be shut down.  If you want to preserve the existing contents of
@@ -355,7 +356,7 @@ just deleting them.  L<virt-sparsify(1)> is another way to remove this
 content.  See also the L<scrub(1)> command to get rid of deleted
 content in directory entries and inodes.
 
-=head2 RANDOM SEED
+=head2 Random seed
 
 I<(This section applies to Linux guests only)>
 
@@ -373,7 +374,9 @@ module:
  cp template.img newguest.img
  virt-sysprep --enable customize -a newguest.img
 
-=head1 SELINUX
+=head1 NOTES
+
+=head2 SELinux
 
 For guests which make use of SELinux, special handling for them might
 be needed when using operations which create new files or alter
@@ -381,7 +384,7 @@ existing ones.
 
 For further details, see L<virt-builder(1)/SELINUX>.
 
-=head1 WINDOWS 8
+=head2 Windows E<ge> 8
 
 Windows 8 "fast startup" can prevent virt-sysprep from working.
 See L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP>.