Update changelog and build instructions.

Author: michaelrsweet

CHANGES.md

@@ -4,7 +4,7 @@ Changes in HTMLDOC
 v1.9.21 (YYYY-MM-DD)
 --------------------
 
-- Update HTTP/HTTPS connection error reporting to include the reason.
+- Updated HTTP/HTTPS connection error reporting to include the reason.
 - Updated markdown parser.
 - Fixed a bug in the new PDF link code (Issue #536)
 - Fixed a bug in the number-up code (Issue #539)

INSTALL.md

@@ -1,50 +1,56 @@
-How to Install HTMLDOC from Source
-==================================
+Building and Installing HTMLDOC
+===============================
+
+This file describes how to compile and install HTMLDOC from source code.  For
+more information on HTMLDOC see the file called `README.md`.
+
+
+Before You Begin
+----------------
 
 To compile HTMLDOC you'll need C and C++ compilers (clang and gcc are fine)
 along with the following libraries:
 
-- FLTK 1.1.x or higher for GUI support
-- CUPS 2.2 or higher for HTTP/HTTPS support
-- libjpeg (7 or higher) or libjpeg-turbo for JPEG support
-- libpng 1.6 or higher for PNG support
-- zlib 1.1 or higher
+- FLTK 1.3.x+ for GUI support
+- CUPS 2.2+ for HTTP/HTTPS support
+- libjpeg 7+ or libjpeg-turbo for JPEG support
+- libpng 1.6+ or higher for PNG support
+- zlib 1.1+ or higher
 
 
-Windows
--------
+Getting Prerequisites
+---------------------
 
-Visual Studio + Advanced Installer solutions are included in the "vcnet"
-directory.  The Visual Studio solution uses NuGet packages for all of the
-dependent libraries, and the current version of Advanced Installer is required
-to build the installer (MSI) target.
+CentOS 8/Fedora 23+/RHEL 8:
 
-We highly recommend building and installing the HTMLDOC MSI target, as it takes
-care of registering the installation location with Windows.  If you want to
-install the software by hand, create a directory for the software and copy the
-HTMLDOC executable, the "fonts" directory, the "data" directory, and the "doc"
-directory to it so that it looks like this:
+    sudo dnf groupinstall 'Development Tools'
+    sudo dnf install cups-devel libjpeg-turbo-devel libpng-devel zlib-devel
 
-    C:\Install\Dir\
-        htmldoc.exe
-        data\
-            ... data files ...
-        doc\
-            ... doc files ...
-        fonts\
-            ... fonts files ...
+Debian/Raspbian/Ubuntu:
 
-Then create the following registry entries with REGEDIT:
+    sudo apt-get install build-essential libcups2-dev libjpeg-dev libpng-dev \
+        zlib1g-dev
 
-    HKEY_LOCAL_MACHINE\Software\HTMLDOC\doc = C:\install\dir\doc
-    HKEY_LOCAL_MACHINE\Software\HTMLDOC\data = C:\install\dir
+macOS:
+
+- Install Xcode from the AppStore
+- Install brew if necessary from <https://brew.sh>
+- Run the following commands to install the required image libraries:
 
+    brew install libjpeg
+    brew install libpng
 
-Linux, macOS, and Other UNIX Platforms
---------------------------------------
+Windows:
 
-To compile the software under UNIX you first need to run the "configure" script
-in the source directory.  Usually this is just:
+- Install Visual Studio 2019+
+- Install Advanced Installer for making MSI installer files
+
+
+Building on Linux, macOS, and Other Unix Platforms
+--------------------------------------------------
+
+To compile the software you first need to run the "configure" script in the
+source directory.  Usually this is just:
 
     ./configure
 
@@ -57,19 +63,31 @@ Finally, run "make install" (typically as root) to install the software:
     sudo make install
 
 
-Ubuntu and Debian Notes
------------------------
+Building on Windows
+-------------------
 
-You should install the following packages:
-
-    sudo apt-get install build-essential autoconf libfltk1.3-dev \
-        libcups2-dev libjpeg-dev libpng-dev pkg-config zlib1g-dev
+Visual Studio + Advanced Installer projects are included in the "vcnet"
+directory.  The Visual Studio project uses NuGet packages for all of the
+dependent libraries, and the current version of Advanced Installer is required
+to build the installer (MSI) target.
 
+We highly recommend building and installing the HTMLDOC MSI target, as it takes
+care of registering the installation location with Windows.  If you want to
+install the software by hand, create a directory for the software and copy the
+HTMLDOC executable, the "fonts" directory, the "data" directory, and the "doc"
+directory to it so that it looks like this:
 
-CentOS, Fedora, and RHEL Notes
-------------------------------
+    C:\Install\Dir\
+        data\
+            ... data files ...
+        doc\
+            ... doc files ...
+        fonts\
+            ... fonts files ...
+        ghtmldoc.exe
+        htmldoc.exe
 
-Install the following packages to get full functionality:
+Then create the following registry entries with REGEDIT:
 
-    sudo dnf install autoconf fltk-devel cups-devel libjpeg-devel \
-    	libpng-devel pkgconfig zlib-devel
+    HKEY_LOCAL_MACHINE\Software\HTMLDOC\doc = C:\install\dir\doc
+    HKEY_LOCAL_MACHINE\Software\HTMLDOC\data = C:\install\dir