* how-using.texinfo: Add FAQ about firewall software. Update

        section on mounting and specifically note using managed mounts.

3 files changed, 51 insertions, 40 deletions

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index 0a14adf19..e839e02e8 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,9 @@
+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
diff --git a/winsup/doc/how-resources.texinfo b/winsup/doc/how-resources.texinfo
index 2e3a714ad..fe5111c9d 100644
--- a/winsup/doc/how-resources.texinfo
+++ b/winsup/doc/how-resources.texinfo
@@ -41,13 +41,14 @@ Similarly, to subscribe to the Cygwin announcements list, send a message
 to cygwin-announce-subscribe@@cygwin.com.  To unsubscribe,
 send a message to cygwin-announce-unsubscribe@@cygwin.com.
 
-If you are going to help develop the Cygwin library by volunteering for
-the project, you will want to subscribe to the Cygwin developers list,
-called cygwin-developers.  If you are contributing to Cygwin tools &
-applications, rather than the library itself, then you should subscribe
-to cygwin-apps.  The same mechanism as described for the first two lists
-works for these as well.  Both cygwin-developers and cygwin-apps are
-by-approval lists.
+If you want to contribe to Cygwin tools & applications, rather than
+the library itself, then you should subscribe to cygwin-apps. There
+is also a low-volume list called cygwin-developers which is reserved
+for knowledgeable people who regularly contribute to the Cygwin DLL.
+Please do not ask for read-only access to this mailing list.  Both
+cygwin-developers and cygwin-apps are by-approval lists.  The same
+mechanism as described for the first two lists works for these as
+well.  
 
 There is a searchable archive of the main mailing list at
 @file{http://cygwin.com/ml/cygwin/}.  There is an alternate
diff --git a/winsup/doc/how-using.texinfo b/winsup/doc/how-using.texinfo
index 96f9ffc4a..660d3d1b2 100644
--- a/winsup/doc/how-using.texinfo
+++ b/winsup/doc/how-using.texinfo
@@ -510,35 +510,33 @@ the following line to your .inputrc file:
 	"\e[2~": paste-from-clipboard 
 @end example 
 
-
-@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
-message.  First "umount" the old location, then "mount" the new one and
-you should have better luck.
-
-If you are trying to umount '/' and are getting this message, you may
-need to run @code{regedit.exe} and change the "native" key for the '/'
-mount in one of the mount points kept under
-HKEY_CURRENT_USER/Software/Red Hat, Inc./CYGWIN.DLL setup/<version>
-where <version> is the latest registry version associated with the
-Cygwin library.
+@subsection What firewall should I use with Cygwin? 
+
+We have had good reports about Kerio Personal Firewall, ZoneLabs
+Integrity Desktop, and the built-in firewall in Windows XP. Other
+well-known products including ZoneAlarm and Norton Internet Security have
+caused problems for some users but work fine for others. If you are
+having strange connection-related problems, disabling the firewall is a
+good troubleshooting step.
+
+Cygwin uses sockets to implement many of its functions, such as IPC.
+Some overzealous firewalls install themselves deeply into the winsock
+stack (with the 'layered service provider' API) and install hooks
+throughout.  Sadly the mailing list archives are littered with examples
+of poorly written firewall-type software that causes things to break.
+Note that with many of these products, simply disabling the firewall
+does not remove these changes; it must be completely uninstalled.
 
 @subsection How can I share files between Unix and Windows?
 
-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
-or just toy with them directly off the Samba-mounted partition.
-On dual-boot NT/Windows 9x machines, we usually use the FAT
-filesystem so we can also access the files under Windows 9x.
+During development, we have both Linix boxes running Samba and Windows
+machines.  We often build with cross-compilers under Linix and copy
+binaries and source to the Windows system or just toy with them
+directly off the Samba-mounted partition.  On dual-boot NT/Windows 9x
+machines, we usually use the FAT filesystem so we can also access the
+files under Windows 9x.
 
-@subsection Are mixed-case filenames possible with Cygwin?
+@subsection Is Cygwin case-sensitive? What are managed mounts?
 
 Several Unix programs expect to be able to use to filenames
 spelled the same way, but with different case.  A prime example
@@ -546,15 +544,21 @@ of this is perl's configuration script, which wants @code{Makefile} and
 @code{makefile}.  WIN32 can't tell the difference between files with
 just different case, so the configuration fails.
 
-In releases prior to beta 16, mount had a special mixed case option
-which renamed files in such a way as to allow mixed case filenames.  We
-chose to remove the support when we rewrote the path handling code for
-beta 16.  The standard Windows apps -- explorer.exe,
-cmd.exe/command.com, etc. -- do not distinguish filenames that differed
-only in case, resulting in some (very) undesirable behavior.
+To help with this problem, starting in @samp{cygwin-1.5.0} it is
+possible to have a case sensitive Cygwin managed mount. This is an
+experimental feature and should be used with caution. You should only
+use it for directories that are initially unpopulated and are due to
+be completely managed by cygwin (hence the name).  So, the best use
+would be to create an empty directory, mount it, and then add files to
+it:  
 
-Sergey Okhapkin had maintained a mixed-case patch ('coolview') until
-about B20.1, but this has not been updated to recent versions of Cygwin.
+@example
+mkdir /managed-dir
+mount -o managed c:/cygwin/managed-dir /managed-dir
+cd /managed-dir/
+touch makefile
+touch Makefile
+@end example 
 
 @subsection What about DOS special filenames?