Backport documentation changes from HEAD.

        * cygwin-api.in.sgml: Accommodate new "Compatibility" section layout.

2 files changed, 756 insertions, 0 deletions

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
new file mode 100644
index 00000000000..c7265e33369
--- /dev/null
+++ b/winsup/doc/ChangeLog
@@ -0,0 +1,694 @@
+2007-06-28  Brian Dessent  <brian@dessent.net>
+
+        Backport documentation changes from HEAD.
+        * cygwin-api.in.sgml: Accommodate new "Compatibility" section layout.
+
+2006-07-18  Corinna Vinschen  <corinna@vinschen.de>
+
+	* pathnames.sgml: Change text for the order in which executables
+	are evaluated.
+
+2006-06-01  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+        * faq-setup.xml (faq.setup.automated): New FAQ.
+
+2006-05-30  Dave Korn  <dave.korn@artimi.com> 
+
+	* faq-api.xml (faq.api.winsock):  Replace references to depracated
+	Win32_Winsock macro with __USE_W32_WINSOCK, and enlarge on details.
+
+2006-05-24  Christopher Faylor  <cgf@timesys.com>
+
+	* configure.in: Update to newer autoconf.
+	(thanks to Steve Ellcey)
+	* configure: Regenerate.
+	* aclocal.m4: New file.
+
+2006-04-04  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* faq-programming.xml (faq.programming.adjusting-heap):
+	Clarify argument parameter sizes.
+	* faq-using.xml (faq.using.chmod):
+	Improve chmod FAQ.
+
+2006-03-18  Christopher Faylor  <cgf@timesys.com>
+
+	* cygwinenv.sgml: Rename fork_retry to proc_retry since it has turned
+	out to be more general than just fork.
+
+2006-03-13  Christopher Faylor  <cgf@timesys.com>
+
+	* cygwinenv.sgml: Explain about new fork_retry CYGWIN environment
+	variable setting.
+
+2006-03-07  Bas van Gompel  <cygwin-patch.buzz<at>bavag.tmfweb.nl>
+
+	* cygwinenv.sgml: Add missing </para> at transparent_exe.
+
+2006-02-05  Corinna Vinschen  <corinna@vinschen.de>
+
+	* cygwinenv.sgml: Explain transparent_exe option.
+
+2006-02-01  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* faq-setup.xml (faq.setup.what-packages): 
+	Mention new cygcheck -p option.
+
+2006-01-27  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* faq-programming.xml (faq.programming.building-cygwin): 
+	Move cocom to the build requirements.
+
+2006-01-26  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* faq-programming.xml (faq.programming.building-cygwin): 
+	Simplify instructions, and remove tar usage basics.
+
+2006-01-26  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* faq-programming.xml (faq.programming.ipc): Add new FAQ about
+	cygserver and its relation to the "Bad system call" error.
+	* faq-setup.xml (faq.setup.uninstall-all): Mention postgresql.
+	* overview2.sgml: Update security info on shared memory.
+
+2006-01-25  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* faq-programming.xml (faq.programming.building-cygwin): Add
+	list of packages required for building and exact check instructions.
+	* faq-setup.xml (faq.setup.uninstall-service): New instructions
+	on uninstalling a cygwin service.
+	(faq.setup.uninstall-all): Reference new service uninstall FAQ.
+
+2006-01-25  Igor Peshansky  <pechtcha@cs.nyu.edu>
+
+	* faq-setup.xml (faq.setup.snapshots): Rename DLL using Windows tools.
+
+2006-01-18  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* Makefile.in : Remove references to old texinfo FAQ.
+	* calls.texinfo : Remove.
+	* changes.texinfo : Remove.
+	* copy.texinfo : Remove.
+	* faq.texinfo : Remove.
+	* history.texinfo : Remove.
+	* how-api.texinfo : Remove.
+	* how-programming.texinfo : Remove.
+	* how-resources.texinfo : Remove.
+	* how-using.texinfo : Remove.
+	* how.texinfo : Remove.
+	* install.texinfo : Remove.
+	* readme.texinfo : Remove.
+	* relnotes.texinfo : Remove.
+	* what.texinfo : Remove.
+	* who.texinfo : Remove.
+
+2006-01-12  Igor Peshansky  <pechtcha@cs.nyu.edu>
+
+	* doctool.c (scan_directory): Ignore "CVS" directories.
+	* faq-setup.xml (faq.setup.setup): Correct URL typo.
+	(faq.setup.snapshots): Clarify.
+
+2005-12-30  Christopher Faylor  <cgf@timesys.com>
+
+	* relnotes.texinfo: Remove entry about hyperthreaded processor.
+
+2005-12-30  Christopher Faylor  <cgf@timesys.com>
+
+	* faq-problems.html: Remove entry about hyperthreaded processor.
+
+2005-12-12  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* faq-programming.xml: Add note about struct stat64.
+
+2005-12-03  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* faq-setup.xml: Add note about clean_setup.pl.
+	* faq-using.xml: Remove unnecessary line of elisp.
+
+2005-10-02  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* faq-what.xml: Add 2003 and WOW64 to "supported" FAQ.
+	* faq-programming.xml: Fix cygexec FAQ, building link.
+
+2005-09-25  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* faq.xml: Remove copyright section, link to license.html
+	* faq-sections.xml: Remove copyright section, link to license.html
+	* faq-programming.xml: Remove confusing reference to Red Hat. 
+	* faq-what.xml: Reword "supported" FAQ.
+
+2005-09-15  Corinna Vinschen  <corinna@vinschen.de>
+
+	* cygwinenv.sgml (ntea): Add some wording to scare people away
+	from using this option.
+
+2005-08-26  Brian Dessent  <brian@dessent.net>
+
+	* faq-using.xml: Add 'net use' hint to network shares FAQ.
+
+2005-08-26  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* Makefile.in: Remove extra anchor to make NN4 happy.
+	* faq.xml: Link to cygwin.com/license.html
+	* faq-resources.xml: Link instead of duplicating info.
+	* faq-using.xml: Split out services and network shares FAQ.
+	* faq-what.xml: Link to cygwin.com/license.html
+
+2005-08-17  Christopher Faylor  <cgf@timesys.com>
+
+	* textbinary.sgml: Correct incorrect information about ability to
+	specify text mode in fopen().
+
+2005-08-05  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* cygwin.dsl: Add default DOCTYPE and output filename.
+	* Makefile: Update to switch FAQ from texinfo to DocBook.
+	* faq.xml: New file.
+	* faq-api.xml: New file.
+	* faq-problems.xml: New file.
+	* faq-programming.xml: New file.
+	* faq-resources.xml: New file.
+	* faq-sections.xml: New file.
+	* faq-setup.xml: New file.
+	* faq-using.xml: New file.
+	* faq-what.xml: New file.
+
+2005-07-10  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* cygwinenv.sgml: Update tty section to mention rxvt and xterm.
+	* how-programming.texinfo: Update GPL section of CVS FAQ. 
+	* how-using.texinfo: Expand FAQ about out of date packages.
+	* setup-net.sgml: Add troubleshooting setup.exe section.
+
+2005-07-08  Corinna Vinschen  <corinna@vinschen.de>
+
+	* how-using.texinfo: Fix typos.
+
+2005-06-20  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-resources.texinfo: Update section on cygwin-developers.
+	* how-using.texinfo: Add FAQ about firewall software. Update
+	section on mounting and specifically note using managed mounts.
+
+2005-06-03  Max Kaehn <slothman@electric-cloud.com>
+
+	* how-programming.texinfo: Add "How do I load cygwin1.dll dynamically
+	from a Visual Studio or MinGW application?"
+
+2005-05-28  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-using.texinfo : Update the mkdir -p section to reflect 
+	changes in handling network drives.
+
+2005-05-18  Brian Dessent  <brian@dessent.net>
+
+	* install.texinfo ("How do I uninstall..."): Rewrite to cover
+	removing services, dealing with permissions, and other common
+	tasks for removing Cygwin completely.
+
+2005-05-08  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-programming.texinfo: Replace MAKE_MODE entry with FAQ about
+	execvp errors and cygexec.
+
+2005-04-20  Brian Dessent  <brian@dessent.net>
+
+	* pathnames.sgml (mount-table): Indicate that user-specific
+	mounts override system-wide.
+
+2005-04-20  Gerd Spalink  <Gerd.Spalink@t-online.de>
+
+	* fhandler-tut.txt: Update description to cygwin 1.5.13
+
+2005-04-19  Corinna Vinschen  <corinna@vinschen.de>
+
+	* cygwinenv.sgml: Mention that check_case is deprecated.
+
+2005-04-16  Corinna Vinschen  <corinna@vinschen.de>
+
+	* cygwinenv.sgml: Add new words for (no)traverse option.
+
+2005-03-30  Christopher Faylor  <cgf@timesys.com>
+
+	* how-using.texinfo: Add more words to the "multiple DLL" section.
+
+2005-03-25  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-programming.texinfo: Mention generic-build-script in
+	packaging FAQ.
+
+2005-03-19  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-programming.texinfo: Remove incorrect libm.a note.
+
+2005-03-05  Christopher Faylor  <cgf@timesys.com>
+
+	* pathnames.sgml: Clarify binmode/textmode behavior slightly.
+	* textbinary.sgml: Ditto.
+
+2005-03-03  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-api.texinfo: Add Pierre's security text.
+
+2005-02-23  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* README: New file.
+
+2005-01-31  Corinna Vinschen  <corinna@vinschen.de>
+
+	* cygwinenv.sgml: Add words for (no)traverse option.
+
+2005-01-29  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* install.texinfo: Update setup.exe snapshot URL.
+	* ntsec.sgml: Add Pierre's Windows 2003 text.
+
+2005-01-28  Corinna Vinschen  <corinna@vinschen.de>
+
+	* how-using.texinfo: Change text about using shortcuts.
+
+2005-01-22  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-api.texinfo: Make snapshot URL an HTML link.
+	* how-programming.texinfo: Add details about building a
+	debugging version of the DLL.
+	* how-using.texinfo: Correct rxvt README location.
+	* install.texinfo: Add mount -m note to uninstall instructions.
+
+2005-01-21  Christopher Faylor  <cgf@timesys.com>
+
+	* how-programming.texinfo: Remove obsolete w32api instructions and add
+	some words about unpacking net release .tar.bz2.
+
+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. 
+	* cygwin.dsl: Change into DocBook XSL stylesheet for xmlto.
+	* pathnames.sgml: Correct documentation of mount behavior.
+
+2004-12-24  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* cygserver.sgml: Cleanup markup for XML validity.
+	* cygwin-api.in.sgml: Cleanup markup for XML validity.
+	* cygwin-ug-net.in.sgml: Cleanup markup for XML validity.
+	* cygwin-ug.in.sgml: Cleanup markup for XML validity.
+	* cygwinenv.sgml: Cleanup markup for XML validity.
+	* dll.sgml: Cleanup markup for XML validity.
+	* effectively.sgml: Cleanup markup for XML validity.
+	* filemodes.sgml: Cleanup markup for XML validity.
+	* legal.sgml: Cleanup markup for XML validity.
+	* ntsec.sgml: Cleanup markup for XML validity.
+	* overview.sgml: Cleanup markup for XML validity.
+	* overview2.sgml: Cleanup markup for XML validity.
+	* pathnames.sgml: Cleanup markup for XML validity.
+	* setup-net.sgml: Cleanup markup for XML validity.
+	* setup2.sgml: Cleanup markup for XML validity.
+	* textbinary.sgml: Cleanup markup for XML validity.
+	* utils.sgml: Cleanup markup for XML validity.
+
+2004-12-02  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* cygserver.sgml: Cleanup minor markup problem.
+	* how-resources.texinfo: Add man and info to documentation FAQ. 
+	* how-using.texinfo: Add more detail to Unicode FAQ.
+	* install.texinfo: Finally apply Pierre's patch from 2003-03-03.
+	* relnotes.texinfo: Add note about hyperthreading reports. 
+
+2004-09-30  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-using.texinfo: Fix typo. Add note about "Install For All Users"
+
+2004-09-30  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-programming.texinfo: Add gcj note to WinMain@16 FAQ.
+	* how-using.texinfo: Add FAQ about network shares and authentication.
+	* install.texinfo: Add "Where is make" to FAQ subtitle. 
+	
+2004-09-24  Corinna Vinschen  <corinna@vinschen.de>
+
+	* cygwinenv.sgml: smbntsec is not on by default.
+
+2004-09-14  Christopher Faylor  <cgf@timesys.com>
+
+	* what.texinfo: Fix two typos reported on cygwin list.
+
+2004-09-02  Corinna Vinschen  <corinna@vinschen.de>
+
+	* textbinary.sgml: Change default mode for non-mounted paths to binary.
+
+2004-07-16  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-resources.texinfo: Update documentation to /usr/share/doc.
+	* how-using.texinfo: Add paragraph about find -noleaf. 
+	
+2004-06-14  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-programming.texinfo: Add section about Visual Studio linking.
+	
+2004-06-13  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* faq.texinfo: Move outdated calls.texinfo to readme.texinfo.
+	* how-api.texinfo: Fix typos.
+	* how-programming.texinfo: Fix typos.
+	* how-resources.texinfo: Fix typos.
+	* how-using.texinfo: Fix typos.
+	* install.texinfo: Fix typos.
+	* readme.texinfo: Move outdated calls.texinfo to readme.texinfo.
+
+2004-05-21  Brian Ford  <ford@vss.fsi.com>
+
+	* pathnames.sgml: Remove /dev/kmem from the supported POSIX
+	device list.
+
+	* cygwinenv.sgml: Fix typo in check_case description.
+
+2004-03-30  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* ntsec.sgml: Replace chapter numbers with <link>s, 
+	replace release-numbers in <title>s with descriptions.
+
+2004-03-30  Ronald Landheer-Cieslak <ronald@landheer.com> 
+
+	* ntsec.sgml: Fix typos, correct chapter numbers.
+
+2004-03-29  Corinna Vinschen  <corinna@vinschen.de>
+
+	* pathnames.sgml: Fix /dev/srX description.
+
+2004-03-28  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-programming.texinfo: Make list in .lib FAQ enumerative. 
+
+2004-03-28  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* how-programming.texinfo: Add note about gcc .lib linking.
+	* pathnames.sgml: Mention create_devices.sh for /dev/ creation.
+
+2004-03-27  Corinna Vinschen  <corinna@vinschen.de>
+
+	* cygserver.sgml: New file.
+	* using.sgml: Include Cygserver docs.
+
+2004-03-26  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* cygwinenv.sgml: Add example for CYGWIN=error_start.
+	* pathnames.sgml: Update list of /dev/ devices.
+
+2004-02-22  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* Makefile.in: Fix problem links in faq0.html file.
+	* what.texinfo: Remove outdated 'recent' history.
+
+2004-02-19  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* cygwinenv.sgml: Remove incorrect ^Z information. Add 
+	some tags to server option description.
+	* textbinary.sgml: Remove incorrect ^Z information.
+
+2004-02-16  Corinna Vinschen  <corinna@vinschen.de>
+
+	* cygwinenv.sgml: Add server option description.
+
+2004-02-04  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* Makefile.in: Generate monolithic faq0.html file.
+
+2004-01-24  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* cygwinenv.sgml: Cleanup minor markup problems.
+	* dll.sgml: Cleanup minor markup problems.
+	* effectively.sgml: Cleanup minor markup problems.
+	* gcc.sgml: Cleanup minor markup problems.
+	* ntsec.sgml: Cleanup minor markup problems.
+	* pathnames.sgml: Cleanup minor markup problems.
+	* setup-net.sgml: Cleanup minor markup problems.
+	* textbinary.sgml: Cleanup minor markup problems.
+	* windres.sgml: Cleanup minor markup problems.
+
+2004-01-20  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* Makefile.in: Remove unused cygwin-ug and cygwin-api-int 
+	targets from default build.
+	* how-using.texinfo: Add information about 8-bit character 
+	display to FAQ.
+	* setup2.sgml: Add information about 8-bit character display
+	to "Setting up Cygwin".
+
+2004-01-15  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* setup-net.sgml: Add "internet-setup" id anchor.
+	* overview.sgml: Update "What is it?" section. Add links to
+	"Is it free software?" section. Update "Brief History" section.
+	* overview2.sgml: Rewrite "Expectations for {Windows,Unix}"
+	as "Quick Start for those more experienced with {Windows,Unix}".
+
+2004-01-11  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* Makefile.in: Add new target for single-file User's Guide, use new
+	cygwin.dsl for output.
+	* cygwin.dsl: New file, DSSSL stylesheet for custom Cygwin output.
+	* cygwin-api.in.sgml: Update to DocBook SGML 4.2 DTD.
+	* cygwin-ug-net.in.sgml: Update to DocBook SGML 4.2 DTD.
+	* cygwin-ug.in.sgml: Update to DocBook SGML 4.2 DTD.
+	* cygwinenv.sgml: Correct some tags. Add description of default values
+	to ntsec, export, and error_start items.
+	* dll.sgml: Add explanation of cyg prefix for DLLs.
+	* effectively.sgml: Use systemitem tag for names of Cygwin packages.
+	* how-programming.texinfo: Add example to FAQ entry.
+	* pathnames.sgml: Add discussion of /proc filesystem.
+	* setup-net.sgml: Correct some typos and grammar.
+
+2003-09-01  Corinna Vinschen  <corinna@vinschen.de>
+
+	* pathnames.sgml: Remove description how to mount raw devices and
+	dicourage it.  Desparately try to make usage of raw devices a bit
+	clearer.
+
+2003-07-31  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* effectively.sgml: New file, "Using Cygwin Effectively with Windows".
+	* legal.sgml: Update year in copyright notice.
+	* using.sgml: Include "Using Cygwin Effectively with Windows" section.
+
+2003-07-15  Christopher Faylor  <cgf@redhat.com>
+
+	* pathnames.sgml: Use correct registry key.  Clarify '@' operation.
+
+2003-07-03  Christopher Faylor  <cgf@redhat.com>
+
+	* ntsec.sgml: Reword references to "ntsec patch".
+
+2003-05-08  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* cygwin-ug-net.in.sgml: Remove outdated revision information and 
+	author's names.
+
+2003-04-26  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* gcc.sgml: Remove outdated "WinMainCRTStartup" references. Add a
+	hellogui.c example. 
+
+2003-03-26  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* setup-net.sgml: Make suggested additions to setup.exe documentation
+
+2003-03-23  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* setup-net.sgml: Improve setup.exe documentation
+
+2003-03-22  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* setup-net.sgml: Document setup.exe
+
+2003-02-07  Christopher Faylor  <cgf@redhat.com>
+
+	* how.texinfo: Add more w32api words.
+
+2003-02-07  Igor Pechtchanski <pechtcha@cs.nyu.edu>
+
+	* ntsec.sgml: Add note on special names for missing user/group.
+
+2002-12-18  Christopher Faylor  <cgf@redhat.com>
+
+	* overview2.sgml: Remove CTRL-Z discussion.
+	* cygwinenv.sgml: Expand on CYGWIN=binmode.
+
+2002-11-10  Christopher Faylor  <cgf@redhat.com>
+
+	* how-programming.texinfo: Document _WIN32 more fully.
+
+2002-10-22  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* ntsec.sgml: Correct some minor grammatical errors.
+
+2002-10-22  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* dll.sgml: Simplify dll build instructions.
+
+2002-09-11  Corinna Vinschen  <corinna@vinschen.de>
+
+	* ntsec.html: Add chapter for switching user context w/o password.
+
+2002-08-29  Christopher Faylor  <cgf@redhat.com>
+
+	* how-api.texinfo: Remove a line from the CRLF discussion about lseek
+	not working.  Answer thread safe question more simply.
+
+2002-08-27  Nicholas Wourms  <nwourms@netscape.net>
+
+	* calls.texinfo: Add getc_unlocked, getchar_unlocked, putc_unlocked
+	and putchar_unlocked.
+
+2002-08-21  Christopher Faylor  <cgf@redhat.com>
+
+	* dll.sgml: Remove indirect reference to older gccs.
+
+2002-06-22  Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
+
+	* dll.sgml: Refine dll build instructions.
+
+2002-08-21  Christopher Faylor  <cgf@redhat.com>
+
+	* ntsec.html: Correct some typos.
+
+2002-07-23  Nicholas Wourms  <nwourms@netscape.net>
+
+	* calls.texinfo: Add fcloseall and fcloseall_r.
+
+2002-06-24  Corinna Vinschen <corinna@vinschen.de>
+
+	* ntsec.sgml: Clean up text for examples of /etc/passwd and /etc/group.
+	Add examples with SIDs.  Warn about changing them crudely.
+
+2002-06-21  Christopher Faylor  <cgf@redhat.com>
+
+	* what.texinfo: Fix typo.
+
+2002-06-02  Christopher Faylor  <cgf@redhat.com>
+
+	* how-programming.texinfo: Add more words to the "how to build".
+
+2002-03-01  Christopher Faylor  <cgf@redhat.com>
+
+	* overview.sgml: Fix 'more more' typo.
+
+2002-01-12  Christopher Faylor  <cgf@redhat.com>
+
+	* overview.sgml: Fix Red Hat cygwin contract link.
+	* what.texinfo: Ditto.
+
+2002-01-01  Christopher Faylor  <cgf@redhat.com>
+
+	* Makefile.in: Duh.  Actually use bzip2 to create the tarball.  Don't
+	just change the name.
+
+2002-01-01  Christopher Faylor  <cgf@redhat.com>
+
+	* Makefile.in: Make .bz2 tarball.
+
+2001-12-11  Christopher Faylor  <cgf@redhat.com>
+
+	* what.texinfo: Clarify XP.
+
+2001-12-03  Christopher Faylor  <cgf@redhat.com>
+
+	Cleanup copyrights and Cygnus'isms throughout.
+	* setup.sgml: Nuke ancient instructions.
+
+Tue Oct 16 18:02:00 2001  Corinna Vinschen <corinna@vinschen.de>
+
+	* pathnames.sgml: Cleanup raw device text to be more coherent.
+
+Tue Oct 16 17:14:00 2001  Corinna Vinschen <corinna@vinschen.de>
+
+	* pathnames.sgml: Add description for new fixed device paths.
+
+Fri Sep  7 12:47:47 2001  Michael Schaap <cygwin@mscha.com>
+
+	* how-resources.texinfo: Add some additional words about where to find
+	documentation.
+
+Wed Jun 13 13:54:35 2001  Christopher Faylor <cgf@cygnus.com>
+
+	* who.texinfo: Oops.  Add a couple of important folk.
+
+Wed Jun 13 13:45:44 2001  Christopher Faylor <cgf@cygnus.com>
+
+	* who.texinfo: Remove email addresses.  Modernize.
+
+Tue May 29 21:30:07 2001  Christopher Faylor <cgf@cygnus.com>
+
+	* Makefile.in: Tweak to attempt to accomodate older texi2html.
+
+Tue May 29 16:24:46 2001  Christopher Faylor <cgf@cygnus.com>
+
+	* Makefile.in: Accomodate newer versions of docbook and openjade.
+
+Thu Apr 12 23:52:00 2001  Corinna Vinschen <corinna@vinschen.de>
+
+	* cygwinenv.sgml: Add text for `check_case' option.
+
+Fri Mar  2 12:42:00 2001  Corinna Vinschen <corinna@vinschen.de>
+
+	* cygwinenv.sgml: Add text for `winsymlinks' option.
+	* how-api.texinfo: Add text to explain new symlinks==shortcuts
+	and the CYGWIN setting `(no)winsymlinks'.
+	* how-using.texinfo: Add text that Cygwin now treats shortcuts
+	as symlinks.
+
+2001-02-07  Eric M. Monsler  <emonsler@beamreachnetworks.com>
+
+	* setup2.sgml: Add docs about domain accounts.
+
+Thu Dec 21 15:03:29 2000  Edward M. Lee <tailbert@yahoo.com>
+
+	* cygwinenv.sgml: Fix typo in <filename>. Add missing </para>.
+
+Tue Dec 19 21:06:00 2000  Corinna Vinschen <corinna@vinschen.de>
+
+	* cygwinenv.sgml: Add text for `smbntsec' option.
+
+Sat Nov 18 23:50:12 2000  Christopher Faylor <cgf@cygnus.com>
+
+	* cygwinenv.sgml: Remove CYGWIN=strace option.  Update CYGWIN options.
+	* setup2.sgml: Remove CYGWIN=strace example.
+	* how-programming.texinfo: Remove stuff about CYGWIN=strace.
+
+Thu Oct 26 10:00:00 2000  Corinna Vinschen <corinna@vinschen.de>
+
+	* ntsec.sgml: Slight changes. Fix some errors.
+
+Thu Oct 26  9:35:00 2000  Corinna Vinschen <corinna@vinschen.de>
+
+	* ntsec.sgml: Changed the (now incorrect) hint that ntsec only
+	uses access allowed ACEs.
+
+Fri Sep 29 23:52:00 2000  Corinna Vinschen <corinna@vinschen.de>
+
+	* pathnames.sgml: Add documentation about raw block special
+	devices and tape devices to the "POSIX devices" chapter.
+
+Fri Aug 18 15:51:06 2000  Christopher Faylor <cgf@cygnus.com>
+
+	* fhandler-tut.txt: hinfo -> dtable.
+
+Thu Jul 20 13:01:00 2000  Corinna Vinschen <corinna@vinschen.de>
+
+	* ntsec.sgml: Add description for the new setuid ability
+	of Cygwin since release 1.1.3.
+	* overview2.sgml: Add description for new chroot functionality.
+	* calls.texinfo: Add missing calls. Change comments for
+	setuid, setgid, seteuid, setegid, chroot.
+
+Tue May  3  0:25:00 2000  Corinna Vinschen <corinna@vinschen.de>
+
+        * ntsec.sgml: Revisited description of `ntsec' according to
+        the changes in release 1.1.
+        * setup.sgml: Include ntsec.
+        * setup-net.sgml: Ditto.
diff --git a/winsup/doc/cygwin-api.in.sgml b/winsup/doc/cygwin-api.in.sgml
new file mode 100644
index 00000000000..d28fd5b6447
--- /dev/null
+++ b/winsup/doc/cygwin-api.in.sgml
@@ -0,0 +1,62 @@
+<?xml version="1.0"?>
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"[]>
+
+<book id="cygwin-api">
+
+  <bookinfo>
+    <date>1998-08-31</date>
+    <title>Cygwin API Reference</title>
+    <authorgroup>
+      <author>
+        <firstname>DJ</firstname>
+        <surname>Delorie</surname>
+      </author>
+      <author>
+        <firstname>Geoffrey</firstname>
+        <surname>Noer</surname>
+      </author>
+    </authorgroup>
+
+    DOCTOOL-INSERT-legal
+
+    <revhistory>
+      <revision>
+	<revnumber>0.0</revnumber>
+	<date>1998-08-31</date>
+	<authorinitials>dj</authorinitials>
+	<revremark>Initial revision</revremark>
+      </revision>
+      <revision>
+	<revnumber>0.5.0</revnumber>
+	<date>1998-12-17</date>
+	<authorinitials>noer</authorinitials>
+	<revremark>Add pthread, sem calls.  Change revnumber to
+	three-part number: Cygwin API major, Cygwin API minor, Doc rev
+	number.  Starts out at 0.5.0.</revremark>
+      </revision>
+    </revhistory>
+  </bookinfo>
+
+  <toc></toc>
+
+<chapter id="compatibility"><title>Compatibility</title>
+DOCTOOL-INSERT-std-susv3
+DOCTOOL-INSERT-std-bsd
+DOCTOOL-INSERT-std-gnu
+DOCTOOL-INSERT-std-solaris
+DOCTOOL-INSERT-std-deprec
+DOCTOOL-INSERT-std-notimpl
+DOCTOOL-INSERT-std-notes
+</chapter>
+
+<chapter id="cygwin-functions"><title>Cygwin Functions</title>
+
+<para>These functions are specific to Cygwin itself, and probably
+won't be found anywhere else.  </para>
+
+DOCTOOL-INSERT-func-
+
+</chapter>
+
+</book>