From 5ee7c5081900358e2cf95a6b183c2e3e2e57e2f6 Mon Sep 17 00:00:00 2001
From: Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
Date: Thu, 30 Sep 2004 05:03:52 +0000
Subject: [PATCH] 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.
---
winsup/doc/ChangeLog | 6 +++++
winsup/doc/how-programming.texinfo | 13 +++++++----
winsup/doc/how-using.texinfo | 35 +++++++++++++++++++-----------
winsup/doc/install.texinfo | 5 ++---
4 files changed, 39 insertions(+), 20 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?