diff --git a/docs/install.html b/docs/install.html
index edf449812..b962f7100 100644
--- a/docs/install.html
+++ b/docs/install.html
@@ -18,30 +18,23 @@
Prior to installing Tahoe the following must be installed:
- - gcc including g++ (programming language)
-
If you are building for Windows or for Cygwin (which are two different platforns), the Cygwin version of gcc will work (it can be used to build executable for either of those platforms).
-
+ - gcc including g++ -- the Cygwin version of gcc works for Cygwin and for Windows
- - GNU make (build tool)
+ - GNU make
- - Python including development headers i.e. "Python.h" (programming language)
+ - Python including development headers i.e. "Python.h"
- - zope.interface (programming language extension)
-
Note that Tahoe does not require the entire Zope package, merely the much smaller zope.interface component.
-
+ - zope.interface -- not the entire Zope package, merely the much smaller zope.interface component
- - Twisted (network and operating system integration library)
-
Installing Twisted from the Twisted "sumo" source tarball works on all supported platforms.
-
+ - Twisted -- from the Twisted "sumo" source tarball
- - OpenSSL, including development headers (cryptography library)
+ - OpenSSL, including development headers
- - PyOpenSSL (secure transport layer)
+ - PyOpenSSL
- - Crypto++, including development headers (cryptography library)
+ - Crypto++, including development headers
- - pywin32
-
This one is required only if you are installing on Windows native. (It is not required if you are installing on Linux, Mac, Solaris, Cygwin, or any other platform.)
+ - pywin32 -- required only for Windows -- not required for Cygwin