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.

4 files changed, 40 insertions, 21 deletions

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index fff29ad0f..5206bcdbd 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,9 @@
+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.
diff --git a/winsup/doc/how-programming.texinfo b/winsup/doc/how-programming.texinfo
index 0f9fc70f8..8c548af49 100644
--- a/winsup/doc/how-programming.texinfo
+++ b/winsup/doc/how-programming.texinfo
@@ -78,10 +78,9 @@ MAKE_MODE to "UNIX" (actually case is not significant) or "WIN32"
 
 @subsection Why the undefined reference to @samp{WinMain@@16}?
 
-Try adding an empty main() function to one of your sources.
-
-Or, perhaps you have @samp{-lm} too early in the link command line.  It
-should be at the end:
+If you're using @samp{gcc}, try adding an empty main() function to one
+of your sources.  Or, perhaps you have @samp{-lm} too early in the
+link command line.  It should be at the end:
 
 @example
     bash$ gcc hello.c -lm
@@ -101,6 +100,12 @@ works, but
 
 This is an artifact of libm.a being a symbolic link to libcygwin.a.
 
+If you're using GCJ, you need to pass a "--main" flag:
+
+@example
+gcj --main=Hello Hello.java
+@end example
+
 @subsection How do I use Win32 API calls?
 
 @strong{(Please note: This section has not yet been updated for the latest
diff --git a/winsup/doc/how-using.texinfo b/winsup/doc/how-using.texinfo
index 63853fb6b..9d89c265a 100644
--- a/winsup/doc/how-using.texinfo
+++ b/winsup/doc/how-using.texinfo
@@ -27,24 +27,33 @@ containing packages, see
 
 @subsection Why is Cygwin suddenly @emph{so} slow?
 
-If you recently upgraded the @samp{cygwin} package and suddenly
-@emph{every} command takes a @emph{very} long time, then you probably
-have the obsolete @code{//c} notation in your PATH.  This now means
-the @emph{network share} @code{c}, which will slow things down
-tremendously if it does not exist.  See then next FAQ entry.
-
-@subsection Why doesn't //c (for C:) work anymore?
-
-(Similarly for any drive letter, e.g. @code{//z} for @code{Z:})
-
-This ``feature'' has long been deprecated, and no longer works at all
-in the latest release.  As of release 1.3.3, @code{//c} now means the
-@emph{network share} @code{c}.
-
+If you recently upgraded and suddenly @emph{every} command takes a
+@emph{very} long time, then something is probably attempting to 
+access a network share.  You may have the obsolete @code{//c}
+notation in your PATH or startup files.  This now means the
+@emph{network share} @code{c}, which will slow things down
+tremendously if it does not exist.  
+
+Using //c (for C:) doesn't work anymore.  (Similarly for any drive
+letter, e.g. @code{//z} for @code{Z:}) This ``feature'' has long been
+deprecated, and no longer works at all in the latest release.  As of
+release 1.3.3, @code{//c} now means the @emph{network share} @code{c}.
 For a detailed discussion of why this change was made, and how deal
 with it now, refer to
 @file{http://sources.redhat.com/ml/cygwin/2001-09/msg00014.html}.
 
+@subsection Why can't I access my network shares with @samp{cron}, or when using pubkey authentication with @samp{ssh}?
+
+Some Cygwin services normally run as the SYSTEM user, which has
+certain limitations. Under the Windows authentication scheme, the
+SYSTEM user cannot access network shares that require authentication.
+For more information, see
+@file{http://cygwin.com/cygwin-ug-net/ntsec.html}.
+
+Workarounds include using public network share that does not require
+authentication (for non-critical files), or running the service as
+your own user with @samp{cygrunsrv}.
+
 @subsection How should I set my PATH?
 
 This is done for you in the file /etc/profile, which is sourced by bash
diff --git a/winsup/doc/install.texinfo b/winsup/doc/install.texinfo
index fd210d18a..3884ee477 100644
--- a/winsup/doc/install.texinfo
+++ b/winsup/doc/install.texinfo
@@ -90,8 +90,7 @@ disk if you are paranoid.
 This should be safe, but only if Cygwin Setup is not substituted by
 something malicious, and no mirror has been compromised.
 
-@subsection What packages should I download?
-
+@subsection What packages should I download? Where are 'make', 'gcc', 'vi', etc?  
 When using Cygwin Setup for the first time, the default is to install
 a minimal subset of packages.  If you want anything beyond that, you
 will have to select it explicitly.  See
@@ -100,7 +99,7 @@ packages.
 
 If you want to build programs, of course you'll need @samp{gcc},
 @samp{binutils}, @samp{make} and probably other packages from the
-``Devel'' category.
+``Devel'' category. Text editors can be found under ``Editors''.
 
 @subsection How do I just get everything?