Add new WINE handbook chapter written as part of Google Season of Docs 2020.

Thanks to Aaron Peters for researching and writing this chapter from
scratch. He also provided most of the images, together with Alexander
Leidinger (netchild@). Alexander was also kind enough to be the official
mentor for the WINE side of the content, while I focused on the
documentation side. His insights into WINE from a users perspective
helped make this chapter better by adding information about Homura.
A big thank you to Google Season of Docs 2020 for enabling us to have
Aaron as technical writer working on this project.

I've re-ordered the finalized submission so that the FAQ is the last
part of this chapter. I also moved the "WINE Overview & concepts"
section after the Synopsis for a more logical flow of information.
Additionally, a lot of DocBook editing was done to bring it to the
current form. The remaining checks by textproc/igor revolve around
indentation errors. But one can't fix all of them without violating
others.

Please enjoy running WINE and games on FreeBSD with the help of this
chapter.

Todo:
- Some references to other parts of the chapter or to others in the
  handbook need to be replaced by actual links.
- Some of the images could be resized a bit more. I only did it on
  those that would create a horizontal scroll bar. Reizing them to 50%
  made them small enough to fit the other images while retaining
  legible text.
  A note on the images: I realize they are mixed JPEG and PNGs in the
  same chapter. However, many of the images in the handbook do not
  have a uniform image type either (compare IMAGES_EN+= entries in
  Makefile). This may be a future project to unify these without
  compromising image quality.

Contributed by:		Aaron Peters (acpkendo gmail.com)
Reviewed by:		netchild, bcr
Sponsored by:		Google Season of Docs 2020
Differential Revision:  https://reviews.freebsd.org/D27484
Differential Revision:  https://reviews.freebsd.org/D27455
Differential Revision:  https://reviews.freebsd.org/D27444
Differential Revision:  https://reviews.freebsd.org/D27232
Differential Revision:  https://reviews.freebsd.org/D27146
Differential Revision:  https://reviews.freebsd.org/D26983
Differential Revision:  https://reviews.freebsd.org/D26914
Differential Revision:  https://reviews.freebsd.org/D26788

en_US.ISO8859-1/books/handbook/Makefile

@@ -151,6 +151,42 @@ IMAGES_EN+= virtualization/vmware-freebsd09.png
 IMAGES_EN+= virtualization/vmware-freebsd10.png
 IMAGES_EN+= virtualization/vmware-freebsd11.png
 IMAGES_EN+= virtualization/vmware-freebsd12.png
+IMAGES_EN+= wine/wine-run-np++-1.png
+IMAGES_EN+= wine/wine-config-1.png
+IMAGES_EN+= wine/wine-config-2.png
+IMAGES_EN+= wine/wine-config-3.png
+IMAGES_EN+= wine/wine-config-4.png
+IMAGES_EN+= wine/wine-config-5.png
+IMAGES_EN+= wine/wine-config-6.png
+IMAGES_EN+= wine/wine-config-7.png
+IMAGES_EN+= wine/winetricks-run-1.png
+IMAGES_EN+= wine/winetricks-run-2.png
+IMAGES_EN+= wine/winetricks-menu-1.jpg
+IMAGES_EN+= wine/winetricks-uninstall-1.jpg
+IMAGES_EN+= wine/winetricks-uninstall-2.jpg
+IMAGES_EN+= wine/winetricks-uninstall-3.jpg
+IMAGES_EN+= wine/homura-launch-1.jpg
+IMAGES_EN+= wine/homura-run-2.jpg
+IMAGES_EN+= wine/homura-run-3.jpg
+IMAGES_EN+= wine/homura-install-1.jpg
+IMAGES_EN+= wine/homura-install-2.jpg
+IMAGES_EN+= wine/homura-install-3.jpg
+IMAGES_EN+= wine/homura-install-4.jpg
+IMAGES_EN+= wine/homura-install-5.jpg
+IMAGES_EN+= wine/homura-install-6.jpg
+IMAGES_EN+= wine/homura-install-7.jpg
+IMAGES_EN+= wine/homura-install-8.jpg
+IMAGES_EN+= wine/homura-uninstall-1.jpg
+IMAGES_EN+= wine/homura-run-2.jpg
+IMAGES_EN+= wine/homura-run-3.jpg
+IMAGES_EN+= wine/winetricks-run-1.png
+IMAGES_EN+= wine/winetricks-run-2.png
+IMAGES_EN+= wine/winetricks-app-install-1.png
+IMAGES_EN+= wine/winetricks-app-install-2.png
+IMAGES_EN+= wine/winetricks-menu-1.jpg
+IMAGES_EN+= wine/winetricks-uninstall-1.jpg
+IMAGES_EN+= wine/winetricks-uninstall-2.jpg
+IMAGES_EN+= wine/winetricks-uninstall-3.jpg
 
 # Images from the cross-document image library
 IMAGES_LIB=  callouts/1.png
@@ -212,6 +248,7 @@ SRCS+= security/chapter.xml
 SRCS+= serialcomms/chapter.xml
 SRCS+= usb-device-mode/chapter.xml
 SRCS+= virtualization/chapter.xml
+SRCS+= wine/chapter.xml
 SRCS+= x11/chapter.xml
 
 # Entities

en_US.ISO8859-1/books/handbook/book.xml

@@ -4,7 +4,6 @@
 <!--
      The FreeBSD Documentation Project
 
-     $FreeBSD$
 -->
 
 <!ENTITY % chapters SYSTEM "chapters.ent">
@@ -224,6 +223,7 @@
     &chap.kernelconfig;
     &chap.printing;
     &chap.linuxemu;
+    &chap.wine;
   </part>
 
   <part xml:id="system-administration">

en_US.ISO8859-1/books/handbook/chapters.ent

@@ -7,7 +7,6 @@
 
      Chapters should be listed in the order in which they are referenced.
 
-     $FreeBSD$
 -->
 
 <!ENTITY chap.preface			SYSTEM "preface/preface.xml">
@@ -26,6 +25,7 @@
   <!ENTITY chap.kernelconfig	SYSTEM "kernelconfig/chapter.xml">
   <!ENTITY chap.printing	SYSTEM "printing/chapter.xml">
   <!ENTITY chap.linuxemu	SYSTEM "linuxemu/chapter.xml">
+  <!ENTITY chap.wine		SYSTEM "wine/chapter.xml">
 
 <!-- Part Three -->
   <!ENTITY chap.config		SYSTEM "config/chapter.xml">

en_US.ISO8859-1/books/handbook/preface/preface.xml

@@ -36,6 +36,11 @@
     the two volume third edition was published in 2004:</para>
 
   <itemizedlist>
+    <listitem>
+      <para><xref linkend="wine"/> has been added with information
+	about how to run &windows; applications on &os;.</para>
+    </listitem>
+
     <listitem>
       <para><xref linkend="dtrace"/> has been added with information
 	about the powerful &dtrace; performance analysis tool.</para>

en_US.ISO8859-1/books/handbook/wine/Makefile

@@ -0,0 +1,14 @@
+#
+# Build the Handbook with just the content from this chapter.
+#
+#
+
+CHAPTERS= 	wine/chapter.xml
+
+VPATH=		..
+
+MASTERDOC=	${.CURDIR}/../${DOC}.${DOCBOOKSUFFIX}
+
+DOC_PREFIX?= 	${.CURDIR}/../../../..
+
+.include "../Makefile"