Preliminary update to FAQ to reflect latest net release.

(So far, just a new title, some minor updates, and a disclaimer in each
section that has to be updated for the net release, or at least looked at.)

winsup/doc/calls.texinfo

@@ -22,6 +22,9 @@ Calls starting with "cygwin_" are Cygwin-specific calls.
 
 @section ANSI C Library Functions
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 @itemize @code
 
 @item libc stdio (newlib/libc/stdio)
@@ -203,6 +206,9 @@ Calls starting with "cygwin_" are Cygwin-specific calls.
 
 @section POSIX.1/96 Functions
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 @item Process Primitives (Section 3)
 @itemize @code
 @item fork: P 3.1.1.1
@@ -531,6 +537,9 @@ Calls starting with "cygwin_" are Cygwin-specific calls.
 
 @section Misc Functions
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 @item Networking (net.cc) (Standardized by POSIX 1.g, which is probably still in draft?)
 @itemize @code
 @item accept

winsup/doc/faq.texinfo

@@ -1,5 +1,14 @@
 \input texinfo 
-@title The Cygwin Project FAQ 20.2 for Release B20.1.
+
+@title The Cygwin FAQ
+
+@subtitle (Only partially updated for the latest net release.)
+
+@author You can always find the latest version of this FAQ at @file{http://sourceware.cygnus.com/cygwin/faq/}.
+
+@c Something better than this is needed!
+@c @author This version of the FAQ is maintained by David Starks-Browning <starksb@ebi.ac.uk>.  It is possible thanks to contributions from the Cygwin community.
+
 @setfilename faq.txt
 
 @include what.texinfo

winsup/doc/history.texinfo

@@ -1,5 +1,8 @@
 @chapter History
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 @include changes.texinfo
 
 @section Release Beta 19 (Feb 26 1998)

winsup/doc/how.texinfo

@@ -4,6 +4,9 @@
 
 @subsection Where's the documentation?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 There are links to quite a lot of it on the main Cygwin project WWW page:
 @file{http://sourceware.cygnus.com/cygwin/}
 Be sure to at least read the Release Notes on the main WWW page, if
@@ -14,6 +17,9 @@ Tool-specific documentation is available at:
 
 @subsection What Cygwin mailing lists can I join?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 To subscribe to the main list, send a message to
 cygwin-subscribe@@sourceware.cygnus.com.  To unsubscribe from the 
 main list, send a message to cygwin-unsubscribe@@sourceware.cygnus.com.
@@ -34,6 +40,9 @@ There's an archive of the main mailing list at
 
 @subsection Why won't you/the mailing list answer my questions?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Perhaps your question has an answer that's already in the FAQ.
 Perhaps nobody has time to answer your question.  Perhaps nobody
 knows the answer...
@@ -42,6 +51,9 @@ knows the answer...
 
 @subsection Why is the install of the tools failing?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 If you are getting an error message saying "The decompression of
 %s failed.  There may not be enough free disk space in the TEMP
 directory.", read on.
@@ -60,17 +72,26 @@ That will get rid of any files with conflicting names and solve the
 
 @subsection Help! I haven't created /tmp and tools are behaving strangely!
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Many Unix tools (bash, byacc, etc.) expect that /tmp always exists.
 This is not guaranteed in Win32 land.  You should create /tmp or "mount"
 the directory of your choice to /tmp to avoid this problem.
 
 @subsection Why does bash spew out "49054596: No such file or directory"?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Are you sure you created a /tmp?  The bash shell will print a
 warning if it doesn't find a /tmp directory.
 
 @subsection How do I set /etc up?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 If you want a valid /etc set up (so "ls -l" will display correct
 user information for example) and if you are running NT (preferably
 with an NTFS file system), you should just need to create the /etc
@@ -81,6 +102,9 @@ you're running Windows 95/98.
 
 @subsection Bash says that it can't vfork (or just hangs).  Why?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Most often this is because it can't find itself in the path.  Make sure
 that your path includes the directory where bash lives, before you start
 it.
@@ -92,6 +116,9 @@ can't find @code{/bin/sh}.
 
 @subsection How can I get bash to read my .bashrc file on startup?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Your .bashrc is read from your home directory specified by the HOME
 environment variable.  It uses /.bashrc if HOME is not set.  So you need
 to set HOME correctly, or move your .bashrc to the top of the drive
@@ -99,10 +126,16 @@ mounted as / in Cygwin.
 
 @subsection How can I get bash filename completion to be case insensitive?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 "shopt -s nocaseglob" should do the trick.
 
 @subsection Can I use paths/filenames containing spaces in them?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Cygwin does support spaces in filenames and paths.  That said, some
 utilities that use the library may not, since files don't typically
 contain spaces in Unix.  If you stumble into problems with this, you
@@ -111,6 +144,9 @@ used by Cygwin tools.
 
 @subsection Why can't I cd into a shortcut to a directory?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Cygwin does not follow MS Windows Explorer Shortcuts (*.lnk
 files) yet.  It sees a shortcut as a regular file and this you
 cannot "cd" into it.
@@ -122,6 +158,9 @@ under native Win32 non-Cygwin applications such as Explorer.
 
 @subsection I'm having basic problems with find.  Why?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Make sure you are using the find that came with the Cygwin tools
 and that you aren't picking up the Win32 find command instead.  You
 can verify that you are getting the right one by doing a "type find"
@@ -129,6 +168,9 @@ in bash.
 
 @subsection Why don't cursor keys work under Win95/Win98?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Careful examination shows that they not just non-functional, but
 rather behave strangely, for example, with NumLock off, keys on numeric
 keyboard work, until you press usual cursor keys, when even numeric
@@ -156,6 +198,9 @@ properly).
 
 @subsection Is it OK to have multiple copies of the DLL?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 It's a bad idea to have multiple versions of the cygwin DLL in
 your path.  They often conflict in funny ways.  If you have
 multiple versions, it's usually OK to get rid of (or rename)
@@ -168,6 +213,9 @@ in your path, though.
 
 @subsection Why aren't man, groff, etc. included in the betas?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 For obvious reasons, it isn't feasible for us to maintain and provide
 binary distributions of every tool ported to work with the Cygwin
 tools.  However, it's likely that a man command will show up in a
@@ -179,6 +227,9 @@ available for download there.
 
 @subsection Where can I find "less"?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 The less pager binary is available for the first time in the 20.1
 release.  You will get it if you upgrade.  It is also available from
 various ftp locations on the Net.  Search the mailing list archives for
@@ -186,16 +237,25 @@ the details.
 
 @subsection Where can I find "more"?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 If you are looking for the "more" pager, you should use the "less" pager
 instead.  See the last question and answer for more information.
 
 @subsection Where can I find "which"?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 While we don't include a which command, you can use the bash built
 in "type" command which does something fairly similar.
 
 @subsection How can I access other drives?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 The best way is to use the "mount" command to mount the drive letter so
 that you can refer to it with only single slashes:
 
@@ -237,6 +297,9 @@ must be more than one character long.
 
 @subsection How can I copy and paste into Cygwin console windows?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Under Windows NT, open the properties dialog of the console window.
 The options contain a toggle button, named "Quick edit mode".  It must
 be ON.  Save the properties.
@@ -246,6 +309,9 @@ Select the Misc tab.  Uncheck Fast Pasting.  Check QuickEdit.
 
 @subsection What does "mount failed: Device or resource busy" mean?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 This usually means that you are trying to mount to a location
 already in use by mount.  For example, if c: is mounted as '/'
 and you try to mount d: there as well, you will get this error
@@ -261,6 +327,9 @@ Cygwin library.
 
 @subsection How can I share files between Unix and Windows?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 During development, we have both Unix boxes running Samba and
 NT/Windows 95/98 machines.  We often build with cross-compilers
 under Unix and copy binaries and source to the Windows system
@@ -270,6 +339,9 @@ filesystem so we can also access the files under Windows 9x.
 
 @subsection Are mixed-case filenames possible with Cygwin?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Several Unix programs expect to be able to use to filenames
 spelled the same way, but with different case.  A prime example
 of this is perl's configuration script, which wants @code{Makefile} and
@@ -283,6 +355,9 @@ code for beta 16.
 
 @subsection What about DOS special filenames?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Files cannot be named com1, lpt1, or aux (to name a few); either as
 the root filename or as the extension part.  If you do, you'll have
 trouble.  Unix programs don't avoid these names which can make things
@@ -293,6 +368,9 @@ letters 'aux' in it will hang.
 
 @subsection When it hangs, how do I get it back?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 If something goes wrong and the tools hang on you for some reason (easy
 to do if you try and read a file called aux.sh), first try hitting ^C to
 return to bash or the cmd prompt.
@@ -306,6 +384,9 @@ This should never be necessary under Windows NT.
 
 @subsection Why the weird directory structure?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Why are cpp.exe, cc1.exe, etc., not in the bin directory?
 
 Why more than one lib and include directory?
@@ -346,6 +427,9 @@ it's worth it for people with more complex installations.
 
 @subsection How do anti-virus programs like Cygwin?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 One person reported that McAfee VirusScan for NT (and others?) is
 incompatible with Cygwin.  This is because it tries to scan the
 newly loaded shared memory in the cygwin.dll, which can cause fork()s
@@ -353,6 +437,9 @@ to fail, wreaking havoc on many of the tools.
 
 @subsection Why can't I run bash as a shell under NT Emacs?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Place the following code in your startup file and try again:
 
 @smallexample
@@ -366,6 +453,9 @@ Place the following code in your startup file and try again:
 
 @subsection Where did the man/info pages go?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 In order to save space and download times, we have stopped providing
 the man/info files for the tools with the binary install since we are
 not yet providing a man page or info reader.  Both types of
@@ -374,6 +464,9 @@ site.  Or consult the online documentation over the WWW.
 
 @subsection Why can't B20's "cygcheck -s" find cpp?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 This is a confusingly worded warning that will be reworded in future
 versions.  In fact, cygcheck should normally *not* find cpp; if it does,
 it may be a problem (e.g. it might pick up Borland's cpp, which would
@@ -381,6 +474,9 @@ cause problems).
 
 @subsection Why do I get a message saying Out of Queue slots?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 "Out of queue slots!" generally occurs when you're trying to remove
 many files that you do not have permission to remove (either because
 you don't have permission, they are opened exclusively, etc).  What
@@ -395,6 +491,9 @@ this explanation).
 
 @subsection Why don't symlinks work on samba-mounted filesystems?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Symlinks are marked with "system" file attribute.  Samba does not
 enable this attribute by default.  To enable it, consult your Samba
 documentation and then add these lines to your samba configuration
@@ -409,12 +508,18 @@ Note that the 0775 can be anything as long as the 0010 bit is set.
 
 @subsection Why does df report sizes incorrectly.
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 There is a bug in the Win32 API function GetFreeDiskSpace that
 makes it return incorrect values for disks larger than 2 GB in size.
 Perhaps that may be your problem?
 
 @subsection Has the screen program been ported yet?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Screen requires either unix domain sockets or fifoes.  Neither of
 them have been implemented in Cygwin yet.
 
@@ -422,6 +527,9 @@ them have been implemented in Cygwin yet.
 
 @subsection How does everything work?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 There's a C library which provides a Unix-style API.  The
 applications are linked with it and voila - they run on Windows.
 
@@ -440,6 +548,9 @@ WWW site.
 
 @subsection Are development snapshots for the Cygwin library available?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Yes.  They're made whenever anything interesting happens inside the
 Cygwin library (usually roughly on a nightly basis, depending on how much
 is going on).  They are only intended for those people who wish to
@@ -451,6 +562,9 @@ http://sourceware.cygnus.com/cygwin/snapshots/
 
 @subsection How is the DOS/Unix CR/LF thing handled?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Let's start with some background.
 
 In UNIX, a file is a file and what the file contains is whatever the
@@ -502,6 +616,9 @@ Explanation adapted from mailing list email by Earnie Boyd
 
 @subsection Is the Cygwin library multi-thread-safe?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 No.
 
 There is an experimental configure option (--enable-threadsafe), which
@@ -533,6 +650,9 @@ should be fine.
 
 @subsection Why is some functionality only supported in Windows NT?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Windows 9x: n.
 32 bit extensions and a graphical shell for a 16 bit patch to an
 8 bit operating system originally coded for a 4 bit microprocessor,
@@ -545,6 +665,9 @@ is not supported in Win 9x.
 
 @subsection How is fork() implemented?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Cygwin fork() essentially works like a non-copy on write version
 of fork() (like old Unix versions used to do).  Because of this it
 can be a little slow.  In most cases, you are better off using the
@@ -571,6 +694,9 @@ shared area and then returns from fork itself.
 
 @subsection How does wildcarding (globbing) work?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 If an application using CYGWIN.DLL starts up, and can't find the
 @code{PID} environment variable, it assumes that it has been started
 from the a DOS style command prompt.  This is pretty safe, since the
@@ -587,6 +713,9 @@ Beware: globbing uses @code{malloc}.  If your application defines
 
 @subsection How do symbolic links work?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 CYGWIN.DLL generates link files with a magic header.  When
 you open a file or directory that is a link to somewhere else, it
 opens the file or directory listed in the magic header.  Because we
@@ -599,6 +728,9 @@ attribute.
 
 @subsection Why do some files, which are not executables have the 'x' type.
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 When working out the unix-style attribute bits on a file, the library
 has to fill out some information not provided by the WIN32 API.  
 
@@ -607,6 +739,9 @@ ones which have a "#!" as their first characters.
 
 @subsection How secure is Cygwin in a multi-user environment?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Cygwin is not secure in a multi-user environment.  For
 example if you have a long running daemon such as "inetd"
 running as admin while ordinary users are logged in, or if
@@ -621,6 +756,9 @@ all processes.
 
 @subsection How do the net-related functions work?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 The network support in Cygwin is supposed to provide the Unix API, not
 the Winsock API.
 
@@ -668,6 +806,9 @@ As of the b19 release, this information may be slightly out of date.
 
 @subsection I don't want Unix sockets, how do I use normal Win32 winsock?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 To use the vanilla Win32 winsock, you just need to #define Win32_Winsock
 and #include "windows.h" at the top of your source file(s).  You'll also
 want to add -lwsock32 to the compiler's command line so you link against
@@ -675,6 +816,9 @@ libwsock32.a.
 
 @subsection What version numbers are associated with Cygwin?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 There is a cygwin.dll major version number that gets incremented
 every time we make a new Cygwin release available.  This
 corresponds to the name of the release (e.g. beta 19's major
@@ -699,6 +843,9 @@ This has been "B15.0" since the beta 15 release.
 
 @subsection Why isn't _timezone set correctly?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Did you explicitly call tzset() before checking the value of _timezone?
 If not, you must do so.
 
@@ -706,6 +853,9 @@ If not, you must do so.
 
 @subsection Why is gcc failing?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 If the error is "gcc: installation problem, cannot exec `cpp':
 No such file or directory", the GCC_EXEC_PREFIX environment variable
 hasn't been set correctly.  The current release does not need
@@ -715,6 +865,9 @@ see this message.
 
 @subsection Why can't bison find bison.simple or bison.hairy?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 If you are getting a warning to this effect, you need to set
 the BISONLIB environment variable.  The value should be the directory
 in which bison.simple and bison.hairy are installed.  This will be
@@ -724,6 +877,9 @@ systems, you would want to set it to @code{C:/cygnus/cygwin-b20/share}.
 
 @subsection Why is make behaving badly?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Starting with the beta 19 release, make defaults to a win32 mode in
 which backslashes in filenames are permitted and cmd.exe/command.com
 is used as the sub-shell.  In this mode, escape characters aren't
@@ -748,10 +904,16 @@ install sets MAKE_MODE to UNIX.
 
 @subsection Why the undefined reference to "WinMain@@16"?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Try adding an empty main() function to one of your sources.
 
 @subsection How do I use Win32 API calls?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 It's pretty simple actually.  Cygwin tools require that you explicitly
 link the import libraries for whatever Win32 API functions that you
 are going to use, with the exception of kernel32, which is linked
@@ -801,12 +963,18 @@ the file that makes the reference.
 
 @subsection How do I compile a Win32 executable that doesn't use Cygwin?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 The -mno-cygwin flag to gcc makes gcc link against standard Microsoft
 DLLs instead of Cygwin.  This is desirable for native Windows programs
 that don't need a UNIX emulation layer.
 
 @subsection How do I make the console window go away?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 The default during compilation is to produce a console application.
 It you are writing a GUI program, you should either compile with
 -mwindows as explained above, or add the string
@@ -814,12 +982,18 @@ It you are writing a GUI program, you should either compile with
 
 @subsection Why does make complain about a "missing separator"?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 This problem usually occurs as a result of someone editing a Makefile
 with a text editor that replaces tab characters with spaces.  Command
 lines must start with tabs.
 
 @subsection Why can't we redistribute Microsoft's Win32 headers?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Subsection 2.d.f of the `Microsoft Open Tools License agreement' looks like
 it says that can not "permit further redistribution of the
 Redistributables to their end users".  We take this to mean that we can
@@ -829,6 +1003,9 @@ Win32 headers which are pretty complete.
 
 @subsection How do I link against .lib files?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 1. Build a C file with a function table.  Put all functions you intend
 to use in that table.  This forces the linker to include all the object
 files from the .lib.  Maybe there is an option to force LINK.EXE to
@@ -857,6 +1034,9 @@ rewriting the runtime library in question from specs...
 
 @subsection How do I rebuild the tools on my NT box?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Assuming that you have the src installed as /src, will build in
 the directory /obj, and want to install the tools in /install:
 
@@ -870,6 +1050,9 @@ make install > install.log 2>&1
 
 @subsection How can I compile a powerpc NT toolchain?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Unfortunately, this will be difficult.  It hasn't been built for
 some time (late 1996) since Microsoft has dropped development of
 powerpc NT.  Exception handling/signals support semantics/args have been
@@ -879,12 +1062,18 @@ Please send us patches if you do this work!
 
 @subsection How can I compile an Alpha NT toolchain?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 We have not ported the tools to Alpha NT and do not have plans to
 do so at the present time.  We would be happy to add support
 for Alpha NT if someone contributes the changes to us.
 
 @subsection How can I adjust the heap/stack size of an application?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Pass heap/stack linker arguments to gcc.  To create foo.exe with
 a heap size of 1024 and a stack size of 4096, you would invoke
 gcc as:
@@ -893,20 +1082,32 @@ gcc as:
 
 @subsection How can I find out which dlls are needed by an executable?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 objdump -p provides this information.
 
 @subsection How do I build a DLL?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 There's documentation that explains the process on the main Cygwin
 project web page (http://sourceware.cygnus.com/cygwin/).
 
 @subsection How can I set a breakpoint at MainCRTStartup?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Set a breakpoint at *0x401000 in gdb and then run the program in
 question.
 
 @subsection How can I build a relocatable dll?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 You must execute the following sequence of five commands, in this
 order:
 
@@ -1005,6 +1206,9 @@ like -ltcl80 in your linker command.
 
 @subsection How can I debug what's going on?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 You can debug your application using @code{gdb}.  Make sure you
 compile it with the -g flag!  If your application calls functions in
 MS dlls, gdb will complain about not being able to load debug information
@@ -1014,6 +1218,9 @@ info would not be compatible with gdb).
 
 @subsection Can I use a system trace mechanism instead?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Yes.  If you have a newer cygwin with the @code{strace.exe} program,
 @code{strace} can run other cygwin programs with various debug and
 trace messages enabled.  For information on using the @code{strace}
@@ -1033,6 +1240,9 @@ mechanism is well documented in the Cygwin library sources in the file
 
 @subsection The linker complains that it can't find something.
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 A common error is to put the library on the command line before
 the thing that needs things from it.
 
@@ -1042,19 +1252,31 @@ This is right @code{gcc hello.cc -lstdc++}.
 @subsection I use a function I know is in the API, but I still get a link
 error.
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 The function probably isn't declared in the header files, or
 the UNICODE stuff for it isn't filled in.
 
 @subsection Can you make DLLs that are linked against libc ?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Yes.
 
 @subsection Where is malloc.h?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Include stdlib.h instead of malloc.h.
 
 @subsection Can I use my own malloc?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 If you define a function called @code{malloc} in your own code, and link
 with the DLL, the DLL @emph{will} call your @code{malloc}.  Needless to
 say, you will run into serious problems if your malloc is buggy.
@@ -1067,12 +1289,18 @@ to occur after @code{main} is called, then this will surely break.
 
 @subsection Can I mix objects compiled with msvc++ and gcc?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Yes, but only if you are combining C object files.  MSVC C++ uses a
 different mangling scheme than GNU C++, so you will have difficulties
 combining C++ objects.
 
 @subsection Can I use the gdb debugger to debug programs built by VC++?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 No, not for full (high level source language) debugging.
 The Microsoft compilers generate a different type of debugging
 symbol information, which gdb does not understand.
@@ -1085,6 +1313,9 @@ data types, line numbers, local variables etc.
 
 @subsection Where can I find info on x86 assembly?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 CPU reference manuals for Intel's current chips are available in
 downloadable PDF form on Intel's web site:
 
@@ -1092,12 +1323,18 @@ downloadable PDF form on Intel's web site:
 
 @subsection Shell scripts aren't running properly from my makefiles?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 You need to have . (dot) in your $PATH.  You should NOT need to add
 /bin/sh in front of each and every shell script invoked in your
 Makefiles.
 
 @subsection What preprocessor do I need to know about?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 We use _WIN32 to signify access to the Win32 API and __CYGWIN__ for
 access to the Cygwin environment provided by the dll.
 
@@ -1108,11 +1345,17 @@ be compiled with VC++.
 
 @subsection Where can I get f77 and objc components for B20 EGCS 1.1?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 B20-compatible versions of the f77 and objc components are available
 from @file{http://www.xraylith.wisc.edu/~khan/software/gnu-win32/}.
 
 @subsection How should I port my Unix GUI to Windows?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 There are two basic strategies for porting Unix GUIs to Windows.
 
 The first is to use a portable graphics library such as tcl/tk, X11, or
@@ -1129,6 +1372,9 @@ advantages inherent in using Cygwin.
 
 @subsection Why not use DJGPP ?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 DJGPP is a similar idea, but for DOS instead of Win32.  DJGPP uses a
 "DOS extender" to provide a more reasonable operating interface for its
 applications.   The Cygwin toolset doesn't have to do this since all of

winsup/doc/install.texinfo

@@ -1,6 +1,9 @@
 @chapter Installation Instructions
 @section Contents
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 The following packages are included in the full release:
 
 Development tools:
@@ -18,6 +21,9 @@ these two units.
 
 @section Installing the binary release:
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Important!  Be sure to remove any older versions of the Cygwin tools
 from your PATH environment variable so you do not execute them by
 mistake.
@@ -89,6 +95,9 @@ via the "Add/Remove Programs" control panel.
 
 @section Installing the source code
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Before downloading the source code corresponding to the release,
 you should install the latest release of the tools (either the full
 release or just the user tools).
@@ -134,6 +143,9 @@ And you should be done...
 
 @section Upgrading to B20.1
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.  Even the section's title is wrong!)}
+
 If you downloaded the original B20.0 release, you should definitely at
 least upgrade the Cygwin library to the version present in B20.1.  To do
 this, download the file

winsup/doc/relnotes.texinfo

@@ -1,6 +1,10 @@
 @chapter Known/potential Problems in the B20.1 Release
 
 @section Windows 95 freezing up
+
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 While this problem may have been worse under B19, Control-c's in bash
 under Win 95 may still be able to lock up the Win 95 kernel, freezing
 your machine.  This problem can be fixed if you are running the OSR2
@@ -9,6 +13,10 @@ on MSDN subscription CDs.  More information about OSR2 and the USB patch
 is available from @file{http://www.compuclinic.com/osr2faq/index.html}.
 
 @section Some programs can't deal with // pathname scheme in arguments
+
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 gcc and other tools aren't fully compatible with the current pathname
 scheme: it can't grok an argument of -I//d/foo which means it is vital
 that when attempting to configure/build UNIX packages, that only normal

winsup/doc/sites.texinfo

@@ -2,21 +2,32 @@
 
 @section FTP Sites
 
+@emph{(Please note: The mirrors listed in this section are not monitored
+automatically.  If you notice an error here, such as a broken link, a
+site that's down, or an ommission, please notify the FAQ maintainer.
+You can always find an up-to-date list of mirrors at
+@file{http://sourceware.cygnus.com/cygwin/mirrors.html}.)}
+
+@c Just commenting out unreachable sites now, though problem could have
+@c been transient or a simple typo.  It would be nice to automate this,
+@c perhaps against the cygwin/mirrors.html page.
+
 @itemize @bullet
 @item North America:
 @itemize @bullet
-@item Alberta: @file{ftp://ftp.reversion.ca/pub/mirrors/cygwin/}
+@c @item Alberta: @file{ftp://ftp.reversion.ca/pub/mirrors/cygwin/}
-@item Arizona: @file{ftp://ftp.ninemoons.com/pub/cygwin/}
+@c @item Arizona: @file{ftp://ftp.ninemoons.com/pub/cygwin/}
 @item California: @file{ftp://ftp.yggdrasil.com/mirrors/site/sourceware.cygnus.com/pub/cygwin/}
-@item California (secondary): @file{ftp://sourceware.cygnus.com/pub/cygwin/}
+@item California : @file{ftp://sourceware.cygnus.com/pub/cygwin/} (This
-@item Kansas: @file{ftp://ftp.the-b.org/pub/cygwin/}
+is the "master" site, and is almost always too busy to permit logins.)
-@item Tennessee: @file{ftp://ftp.sunsite.utk.edu/pub/cygwin/}
+@c @item Kansas: @file{ftp://ftp.the-b.org/pub/cygwin/}
+@c @item Tennessee: @file{ftp://ftp.sunsite.utk.edu/pub/cygwin/}
 @end itemize
 
-@item Central America:
+@c @item Central America:
-@itemize @bullet
+@c @itemize @bullet
-@item Costa Rica: @file{ftp://sunsite.ulatina.ac.cr/cygwin/}
+@c @item Costa Rica: @file{ftp://sunsite.ulatina.ac.cr/cygwin/}
-@end itemize
+@c @end itemize
 
 @item South America:
 @itemize @bullet
@@ -36,48 +47,50 @@
 @item Japan: @file{ftp://ring.crl.go.jp/archives/pc/gnu-win32/}
 @item Japan: @file{ftp://ring.astem.or.jp/archives/pc/gnu-win32/}
 @item Japan: @file{ftp://ring.jah.ne.jp/archives/pc/gnu-win32/}
-@item Japan: @file{ftp://ring.saitama-u.ac.jp/archives/pc/gnu-win32/}
+@c @item Japan: @file{ftp://ring.saitama-u.ac.jp/archives/pc/gnu-win32/}
 @item Japan: @file{ftp://ring.nacsis.ac.jp/archives/pc/gnu-win32/}
 @item Japan: @file{ftp://ring.exp.fujixerox.co.jp/archives/pc/gnu-win32/}
 @item Japan: @file{ftp://ring.so-net.ne.jp/archives/pc/gnu-win32/}
 @item Japan: @file{ftp://ring.ip-kyoto.ad.jp/archives/pc/gnu-win32/}
 @item Japan: @file{ftp://sysg.kek.jp/cygnus/cygwin/}
 @item Japan: @file{ftp://ftp.u-aizu.ac.jp/pub/gnu/gnu-win32/}
-@item Taiwan: @file{ftp://ftp1.sinica.edu.tw/pub3/CYGNUS/cygwin/}
+@c @item Taiwan: @file{ftp://ftp1.sinica.edu.tw/pub3/CYGNUS/cygwin/}
+@c (mixed w/ old!)
 @end itemize
 
-@item Australasia:
+@c @item Australasia:
-@itemize @bullet
+@c @itemize @bullet
-@item Australia: @file{ftp://mirror.aarnet.edu.au/pub/cygwin/}
+@c @item Australia: @file{ftp://mirror.aarnet.edu.au/pub/cygwin/}
-@end itemize
+@c @end itemize
 
 @item Europe:
 @itemize @bullet
 @item Austria: @file{ftp://gd.tuwien.ac.at/gnu/cygwin/}
 @item Czech Republic: @file{ftp://sunsite.ms.mff.cuni.cz/MIRRORS/sourceware.cygnus.com/pub/cygwin/}
 @item Denmark: @file{ftp://sunsite.auc.dk/pub/cygwin/}
-@item Finland: @file{ftp://ftp.funet.fi/mirrors/sourceware.cygnus.com/pub/cygwin/}
+@c @item Finland: @file{ftp://ftp.funet.fi/mirrors/sourceware.cygnus.com/pub/cygwin/}
-@item Germany: @file{ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin32/mirrors/cygnus/}
+@item Germany: @file{ftp://ftp.franken.de/pub/win32/develop/gnuwin32/cygwin/mirrors/cygnus/}
 @item Greece: @file{ftp://ftp.ntua.gr/pub/pc/cygwin/}
-@item Hungary: @file{ftp://ftp.szrmkk.hu/pub/gnu-win32/ftp.cygnus.com/}
+@c @item Hungary: @file{ftp://ftp.szrmkk.hu/pub/gnu-win32/ftp.cygnus.com/}
 @item Italy: @file{ftp://ftp.unina.it/pub/Unix/cygnus/cygwin/}
 @item Poland: @file{ftp://sunsite.icm.edu.pl/pub/cygnus/cygwin/}
-@item Slovenia: @file{ftp://sunsite.fri.uni-lj.si/pub/gnu-win32/}
+@c @item Slovenia: @file{ftp://sunsite.fri.uni-lj.si/pub/gnu-win32/}
 @item Spain: @file{ftp://ftp.rediris.es/mirror/cygwin}
 @item Sweden: @file{ftp://ftp.sunet.se/pub/lang/cygwin/}
 @item Switzerland: @file{ftp://sunsite.cnlab-switch.ch/mirror/cygwin/}
 @item UK: @file{ftp://sunsite.org.uk/Mirrors/sourceware.cygnus.com/pub/cygwin/}
-@item UK: @file{ftp://ftp.ccp14.dl.ac.uk/ccp14/ftp-mirror/programming/cygnus-gnu-win32/pub/gnu-win32/}
+@c @item UK: @file{ftp://ftp.ccp14.dl.ac.uk/ccp14/ftp-mirror/programming/cygnus-gnu-win32/pub/gnu-win32/}
+@item UK: @file{ftp://ftp.mirror.ac.uk/sites/sourceware.cygnus.com/pub/cygwin/}
 @end itemize
 @end itemize
 
 @section The Cygwin Project WWW Site
 
 The main WWW page for the Cygwin project is
-@file{http://sourceware.cygnus.com/cygwin/}.
+@file{http://sourceware.cygnus.com/cygwin/}.  There you will find a
+great many links to additional resources and related sites.
 
-A page containing tool-specific information is
+You can find documentation for the individual Gnu tools at
-@file{http://www.cygnus.com/pubs/gnupro/}.
+@file{http://www.fsf.org/manual/}.  (You should read Gnu manuals from a
-
+local mirror, check @file{http://www.fsf.org/server/list-mirrors.html}
-Links to additional documentation are accessible from the main
+for a list of them.)
-web page.

winsup/doc/what.texinfo

@@ -39,18 +39,23 @@ it with their friends, etc.  The Cygwin license allows you those
 freedoms, so it is free software.
 
 The Cygwin 1.0 product is a "commercial" distribution of cygwin.  As
-such, it includes such non-software things as printed manuals,
+such, it includes such non-software things as printed manuals, support,
-support, and aggregation of useful utilities.  There is nothing
+and aggregation of useful utilities.  There is nothing (software-wise)
-(software-wise) in there that you can't already get off the net
+in there that you can't already get off the net already, if you take the
-already, if you take the time to find and download everything (and
+time to find and download everything (and usually, build it yourself),
-usually, build it yourself).  We test it all to make sure it works
+although the @emph{versions} available for download may be different
-together, and package it in a convenient form.  We consider such
+than those distributed with the commercial product.  We test it all to
-testing and packaging to be a valuable service and thus charge a fee
+make sure it works together, and package it in a convenient form.  We
-for it.  Plus, it provides income for the cygwin project so we can
+consider such testing and packaging to be a valuable service and thus
-continue working on it :-)
+charge a fee for it.  Plus, it provides income for the cygwin project so
+we can continue working on it.  For further details about the commercial
+product, see @file{http://www.cygnus.com/cygwin/}.
 
 @section A brief history of the project
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 The first thing done was to enhance the development tools (gcc, gdb,
 gas, et al) so that they could generate/interpret Win32 native object
 files.

winsup/doc/who.texinfo

@@ -1,5 +1,8 @@
 @chapter Who's behind the project?
 
+@strong{(Please note: This section has not yet been updated for the latest
+net release.)}
+
 Chris Faylor (cgf@@cygnus.com) is behind many of the recent
 changes in Cygwin.  Prior to joining Cygnus, he contributed significant
 fixes to the process control and environ code, reworked the strace