* path.sgml: Encode programming example with CDATA.

diff --git a/winsup/cygwin/path.sgml b/winsup/cygwin/path.sgml
index 8efa53f..05e01d8 100644 (file)
--- 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 b346f53..f48de22 100644 (file)
--- 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 12d906c..6e38832 100644 (file)
--- 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 d2c2bac..c5b41fb 100644 (file)
--- 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