<example>
<title>Example use of cygwin_posix_to_win32_path_list</title>
<programlisting>
+<![CDATA[
char *_epath;
char *_win32epath;
_epath = _win32epath = getenv (NAME);
(cygwin_posix_to_win32_path_list_buf_size (_epath));
cygwin_posix_to_win32_path_list (_epath, _win32epath);
}
+]]>
</programlisting>
</example>
+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.
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
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
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