diff --git a/winsup/cygwin/path.sgml b/winsup/cygwin/path.sgml
index 8efa53f14..05e01d86b 100644
--- a/winsup/cygwin/path.sgml
+++ b/winsup/cygwin/path.sgml
@@ -16,6 +16,7 @@ buffer.</para>
 <example>
 <title>Example use of cygwin_posix_to_win32_path_list</title>
 <programlisting>
+<![CDATA[
 char *_epath;
 char *_win32epath;
 _epath = _win32epath = getenv (NAME);
@@ -27,6 +28,7 @@ if (_epath != NULL && *_epath != 0
       (cygwin_posix_to_win32_path_list_buf_size (_epath));
     cygwin_posix_to_win32_path_list (_epath, _win32epath);
     }
+]]>
 </programlisting>
 </example>
 
diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index b346f5305..f48de2255 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,9 @@
+2004-12-30  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* path.sgml: Encode programming example with CDATA.
+	* overview.sgml: Add notes about SUS, newlib, and ash.
+	* overview2.sgml: Add notes about /usr/share/doc/Cygwin.
+
 2004-12-27  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
 
 	* Makefile.in: Update to use xmlto. 
diff --git a/winsup/doc/overview.sgml b/winsup/doc/overview.sgml
index 12d906c5d..6e38832e8 100644
--- a/winsup/doc/overview.sgml
+++ b/winsup/doc/overview.sgml
@@ -9,7 +9,13 @@ providing substantial <ulink
 url="http://www.pasc.org/#POSIX">POSIX</ulink> (Portable Operating
 System Interface) system call functionality, and a collection of tools,
 which provide a Linux look and feel. The Cygwin DLL works with all x86
-versions of Windows since Windows 95.
+versions of Windows since Windows 95. The API follows the <ulink
+url="http://www.opengroup.org/onlinepubs/009695399/nfindex.html">Single
+Unix Specification</ulink> as much as possible, and then Linux practice.
+Two other major differences between Cygwin and Linux are the C library
+(<literal>newlib</literal> instead of <literal>glibc</literal>) and
+default <command>/bin/sh</command>, which is <command>ash</command> on
+Cygwin but <command>bash</command> on most Linux distributions.
 </para>
 <para>
 With Cygwin installed, users have access to many standard UNIX
diff --git a/winsup/doc/overview2.sgml b/winsup/doc/overview2.sgml
index d2c2bac82..c5b41fb45 100644
--- a/winsup/doc/overview2.sgml
+++ b/winsup/doc/overview2.sgml
@@ -29,6 +29,8 @@ category. However, be advised that this will download and install
 several hundreds of megabytes of software to your computer. The best
 plan is probably to click on individual categories and install either
 entire categories or packages from the categories themselves.
+After installation, you can find Cygwin-specific documentation in
+the <literal>/usr/share/doc/Cygwin/</literal> directory.
 </para>
 <para>
 Developers coming from a Windows background will find a set of tools capable of
@@ -66,6 +68,8 @@ category. However, be advised that this will download and install
 several hundreds of megabytes of software to your computer. The best
 plan is probably to click on individual categories and install either
 entire categories or packages from the categories themselves.
+After installation, you can find Cygwin-specific documentation in
+the <literal>/usr/share/doc/Cygwin/</literal> directory.
 </para>
 <para>
 Developers coming from a UNIX background will find a set of utilities