diff --git a/fish/guestfish.pod b/fish/guestfish.pod
index 01d8044bf..80a3b3794 100644
--- a/fish/guestfish.pod
+++ b/fish/guestfish.pod
@@ -1168,6 +1168,12 @@ Note these these require a terminal that supports ANSI escape codes.
 
 A bold black version of the ordinary prompt.
 
+=head1 WINDOWS 8
+
+Windows 8 "fast startup" can prevent guestfish from mounting NTFS
+partitions.  See
+L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP>.
+
 =head1 GUESTFISH COMMANDS
 
 The commands in this section are guestfish convenience commands, in
diff --git a/sparsify/virt-sparsify.pod b/sparsify/virt-sparsify.pod
index 5c95419bb..ba19d1d82 100644
--- a/sparsify/virt-sparsify.pod
+++ b/sparsify/virt-sparsify.pod
@@ -264,6 +264,11 @@ code if there was a fatal error.
 All versions of virt-sparsify have supported the I<--machine-readable>
 option.
 
+=head1 WINDOWS 8
+
+Windows 8 "fast startup" can prevent virt-sparsify from working.
+See L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP>.
+
 =head1 EXIT STATUS
 
 This program returns 0 if successful, or non-zero if there was an
diff --git a/src/guestfs.pod b/src/guestfs.pod
index cc6b27b85..380a68472 100644
--- a/src/guestfs.pod
+++ b/src/guestfs.pod
@@ -803,6 +803,45 @@ ntfs-3g filesystems (using L</guestfs_getxattr>).  See:
 
 L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>
 
+=head3 WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP
+
+Windows guests which have been hibernated (instead of fully shut down)
+cannot be mounted.  This is a limitation of ntfs-3g.  You will see an
+error like this:
+
+ The disk contains an unclean file system (0, 0).
+ Metadata kept in Windows cache, refused to mount.
+ Failed to mount '/dev/sda2': Operation not permitted
+ The NTFS partition is in an unsafe state. Please resume
+ and shutdown Windows fully (no hibernation or fast
+ restarting), or mount the volume read-only with the
+ 'ro' mount option.
+
+In Windows 8, the shutdown button does not shut down the guest at all.
+Instead it usually hibernates the guest.  This is known as "fast
+startup".
+
+Some suggested workarounds are:
+
+=over 4
+
+=item *
+
+Mount read-only (eg. L</guestfs_mount_ro>).
+
+=item *
+
+On Windows 8, turn off fast startup.  It is in the Control Panel →
+Power Options → Choose what the power buttons do → Change settings
+that are currently unavailable → Turn on fast startup.
+
+=item *
+
+On Windows 7 and earlier, shut the guest off properly instead of
+hibernating it.
+
+=back
+
 =head2 RESIZE2FS ERRORS
 
 The L</guestfs_resize2fs>, L</guestfs_resize2fs_size> and
diff --git a/sysprep/virt-sysprep.pod b/sysprep/virt-sysprep.pod
index 836be4af4..163677068 100755
--- a/sysprep/virt-sysprep.pod
+++ b/sysprep/virt-sysprep.pod
@@ -466,6 +466,11 @@ I<--selinux-relabel> option.
 You can disable relabelling entirely by supplying the
 I<--no-selinux-relabel> option.
 
+=head1 WINDOWS 8
+
+Windows 8 "fast startup" can prevent virt-sysprep from working.
+See L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP>.
+
 =head1 SHELL QUOTING
 
 Libvirt guest names can contain arbitrary characters, some of which
diff --git a/tools/virt-win-reg b/tools/virt-win-reg
index 0a1b75405..85203710f 100755
--- a/tools/virt-win-reg
+++ b/tools/virt-win-reg
@@ -546,7 +546,7 @@ sub upload_hive
 =head1 SUPPORTED SYSTEMS
 
 The program currently supports Windows NT-derived guests starting with
-Windows XP through to at least Windows 7.
+Windows XP through to at least Windows 8.
 
 The following Registry keys are supported:
 
@@ -578,6 +578,12 @@ C<HKU> for C<HKEY_USERS>.
 The literal keys C<HKEY_USERS\$SID> and C<HKEY_CURRENT_USER> are not
 supported (there is no "current user").
 
+=head2 WINDOWS 8
+
+Windows 8 "fast startup" can prevent virt-win-reg from being
+able to edit the Registry.  See
+L<guestfs(3)/WINDOWS HIBERNATION AND WINDOWS 8 FAST STARTUP>.
+
 =head1 ENCODING
 
 C<virt-win-reg> expects that regedit files have already been reencoded