+ COMPRESSION RATIO
+
+wimlib can create XPRESS or LZX compressed WIM archives. Currently, the XPRESS
+compression ratio is slightly better than that provided by Microsoft's software,
+while the LZX compression ratio is approaching that of Microsoft's software but
+is not quite there yet. Running time is as good as or better than Microsoft's
+software, especially with multithreaded compression, available in wimlib v1.1.0
+and later.
+
+The following tables compare the compression ratio and performance for creating
+a compressed Windows PE image (disk usage of about 524 MB, uncompressed WIM size
+361 MB):
+
+ Table 1. WIM size
+
+ XPRESS Compression LZX Compression
+ wimlib imagex (v1.2.1): 138,971,353 bytes 131,379,943 bytes
+ Microsoft imagex.exe: 140,406,981 bytes 127,249,176 bytes
+
+ Table 2. Time to create WIM
+
+ XPRESS Compression LZX Compression
+ wimlib imagex (v1.2.1, 2 threads): 11 sec 17 sec
+ Microsoft imagex.exe: 25 sec 89 sec
+
+ NTFS SUPPORT
+
+As of version 1.0.0, wimlib supports capturing and applying images directly to
+NTFS volumes. This was made possible with the help of libntfs-3g from the
+NTFS-3g project. This feature supports capturing and restoring NTFS-specific
+data such as security descriptors, alternate data streams, and reparse point
+data.
+
+The code for NTFS image capture and image application is complete enough that it
+is possible to apply an image from the "install.wim" contained in recent Windows
+installation media (Vista, Windows 7, or Windows 8) directly to a NTFS volume,
+and then boot Windows from it after preparing the Boot Configuration Data. In
+addition, a Windows installation can be captured (or backed up) into a WIM file,
+and then re-applied later.
+
+ WINDOWS PE
+
+A major use for this library is to create customized images of Windows PE, the
+Windows Preinstallation Environment, without having to rely on Windows. Windows
+PE is a lightweight version of Windows that can run entirely from memory and can
+be used to install Windows from local media or a network drive or perform
+maintenance. Windows PE is the operating system that runs when you boot from
+the Windows installation media.
+
+You can find Windows PE on the installation DVD for Windows Vista, Windows 7, or
+Windows 8, in the file `sources/boot.wim'. Windows PE can also be found in the
+Windows Automated Installation Kit (WAIK), which is free to download from
+Microsoft, inside the `WinPE.cab' file, which you can extract if you install
+either the `cabextract' or `p7zip' programs.
+
+In addition, Windows installations and recovery partitions frequently contain a
+WIM containing an image of the Windows Recovery Environment, which is similar to
+Windows PE.
+
+ DEPENDENCIES
+
+* libxml2 (required)
+ This is a commonly used free library to read and write XML files. You
+ likely already have it installed as a dependency for some other program.
+ For more information see http://xmlsoft.org/.
+
+* libfuse (optional but highly recommended)
+ Unless configured with --without-fuse, wimlib requires a non-ancient
+ version of libfuse to be installed. Most GNU/Linux distributions
+ already include this, but make sure you have the libfuse package
+ installed, and also libfuse-dev if your distribution distributes header
+ files separately. FUSE also requires a kernel module. If the kernel
+ module is available it will automatically be loaded if you try to mount
+ a WIM file. For more information see http://fuse.sourceforge.net/.
+ FUSE is also available for FreeBSD.
+
+* libntfs-3g (optional but highly recommended)
+ Unless configured with --without-ntfs-3g, wimlib requires the library
+ and headers for libntfs-3g version 2011-4-12 or later to be installed.
+ Versions dated 2010-3-6 and earlier do not work because they are missing
+ the header xattrs.h (and the file xattrs.c, which contains functions we
+ need). libntfs-3g version 2013-1-13 is compatible only with wimlib
+ 1.2.4 and later.
+
+* OpenSSL / libcrypto (optional)
+ wimlib can use the SHA1 message digest code from OpenSSL instead of
+ compiling in yet another SHA1 implementation. (See LICENSE section.)
+
+* cdrkit (optional)
+* mtools (optional)
+* syslinux (optional)
+* cabextract (optional)
+ The `mkwinpeimg' shell script will look for several other programs
+ depending on what options are given to it. Depending on your GNU/Linux
+ distribution, you may already have these programs installed, or they may
+ be in the software repository. Making an ISO filesystem requires
+ `mkisofs' from `cdrkit' (http://www.cdrkit.org). Making a disk image
+ requires `mtools' (http://www.gnu.org/software/mtools) and `syslinux'
+ (http://www.syslinux.org). Retrieving files from the Windows Automated
+ Installation Kit requires `cabextract' (http://www.cabextract.org.uk).