From 7a582da59905eeab32366cc741e51b1da567fa7a Mon Sep 17 00:00:00 2001
From: Joshua Daniel Franklin <joshuadfranklin@yahoo.com>
Date: Sat, 27 Aug 2005 01:32:36 +0000
Subject: [PATCH] 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
---
winsup/doc/ChangeLog | 8 +++
winsup/doc/Makefile.in | 2 +
winsup/doc/faq-resources.xml | 108 ++---------------------------------
winsup/doc/faq-using.xml | 15 +++--
winsup/doc/faq-what.xml | 4 +-
winsup/doc/faq.xml | 2 +-
6 files changed, 28 insertions(+), 111 deletions(-)
diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index d87b4a6d2..eea5ceb6d 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,11 @@
+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
diff --git a/winsup/doc/Makefile.in b/winsup/doc/Makefile.in
index 5313ed965..4ecc82ac7 100644
--- a/winsup/doc/Makefile.in
+++ b/winsup/doc/Makefile.in
@@ -68,9 +68,11 @@ cygwin-api.sgml : cygwin-api.in.sgml ./doctool Makefile
faq/faq.html :
-xmlto html -o faq -m $(srcdir)/cygwin.dsl $(srcdir)/faq-sections.xml
+ -sed -i 's;</a><a name="id[0-9]*"></a>;</a>;g' faq/faq.*.html
faq/faq-nochunks.html :
-xmlto html -o faq -m $(srcdir)/cygwin.dsl $(srcdir)/faq.xml
+ -sed -i 's;</a><a name="id[0-9]*"></a>;</a>;g' faq/faq-nochunks.html
./doctool : doctool.c
gcc -g $< -o $@
diff --git a/winsup/doc/faq-resources.xml b/winsup/doc/faq-resources.xml
index 29ffb5ff4..9bf42f722 100644
--- a/winsup/doc/faq-resources.xml
+++ b/winsup/doc/faq-resources.xml
@@ -37,115 +37,15 @@ for a list of them.)
<qandaentry id="faq.resources.mailing-lists">
<question><para>What Cygwin mailing lists can I join?</para></question>
<answer>
-
<para>Comprehensive information about the Cygwin mailing lists can be found at
-<ulink url="http://cygwin.com/lists.html">http://cygwin.com/lists.html</ulink>.
-</para>
-<para>To subscribe to the main list, send a message to
-cygwin-subscribe@cygwin.com. To unsubscribe from the
-main list, send a message to cygwin-unsubscribe@cygwin.com.
-In both cases, the subject and body of the message are ignored.
-</para>
-<para>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.
-</para>
-<para>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.
-</para>
-<para>There is a searchable archive of the main mailing list at
-<ulink url="http://cygwin.com/ml/cygwin/">http://cygwin.com/ml/cygwin/</ulink>. There is an alternate
-archive, also searchable, at <ulink url="http://www.delorie.com/archives/">http://www.delorie.com/archives/</ulink>.
-You can also search at <ulink url="http://www.google.com/">http://www.google.com/</ulink> and include
-"cygwin" in the list of search terms.
-</para>
-<para>Cygwin mailing lists are not gatewayed to USENET, so anti-spam measures
-in your email address are neither required nor appreciated. Also, avoid
-sending HTML content to Cygwin mailing lists.
+<ulink url="http://cygwin.com/lists.html" />.
</para>
</answer></qandaentry>
-<qandaentry id="faq.resources.posting">
-<question><para>Posting Guidelines (Or: Why won't you/the mailing list answer my questions?)</para></question>
+<qandaentry id="faq.resources.problems">
+<question><para>What if I have a problem? (Or: Why won't you/the mailing list answer my questions?)</para></question>
<answer>
-
-<para>If you follow these guidelines, you are much more likely to get a
-helpful response from the Cygwin developers and/or the Cygwin community at
-large:
-</para>
-<itemizedlist><listitem><para>Read the User's Guide and the FAQ first.
-</para></listitem>
-<listitem><para>Check the mailing list archives. Your topic may have come up
-before. (It may even have been answered!) Use the search facilities
-at the links above. Try the alternate site if the main archive is not
-producing search results.
-</para></listitem>
-<listitem><para>Explain your problem carefully and completely. "I installed Blah
-and it doesn't work!" wastes everybody's time. It provides no
-information for anyone to help you with your problem. You should
-provide:
-</para>
-<itemizedlist><listitem><para>A problem statement: How does it behave, how do you think it
-should behave, and what makes you think it's broken? (Oh yeah, and what
-is <emphasis>"it"</emphasis>?)
-</para></listitem>
-<listitem><para>Information about your Windows OS ("Win95 OSR2" or "NT4/SP3" or
-"Win2K" or "Win98 SE" or ...).
-</para></listitem>
-<listitem><para>Details about your installation process, or attempts at same. (Internet or
-Directory install? If the former, exactly when and from what mirror?
-If the latter, which packages did you download? Which version of
-setup.exe? Any subsequent updates?)
-</para></listitem>
-<listitem><para>Details about your Cygwin setup, accomplished by <emphasis>attaching</emphasis>
-the output of 'cygcheck -s -v -r' to your message. (Do not paste the
-output into your message.)
-</para></listitem>
-<listitem><para>A valid return address, so that a reply doesn't require manual editing of
-the 'To:' header.
-</para></listitem>
-</itemizedlist>
-
-</listitem>
-<listitem><para>Your message must be relevant to the list. Messages that are
-<emphasis>not</emphasis> directly related to Cygwin are considered off-topic and are
-unwelcome. For example, the following are off-topic:
-</para>
-<itemizedlist><listitem><para>General programming language questions
-</para></listitem>
-<listitem><para>General Windows programming questions
-</para></listitem>
-<listitem><para>General UNIX shell programming questions
-</para></listitem>
-<listitem><para>General application usage questions
-</para></listitem>
-<listitem><para>How to make millions by working at home
-</para></listitem>
-<listitem><para>Announcements from LaserJet toner cartridge suppliers
-</para></listitem>
-</itemizedlist>
-
-</listitem>
-<listitem><para>Read and obey ``How To Ask Questions The Smart Way'' by Eric
-S. Raymond, at <ulink url="http://www.catb.org/~esr/faqs/smart-questions.html">http://www.catb.org/~esr/faqs/smart-questions.html</ulink>.
-</para>
-</listitem>
-</itemizedlist>
-
-<para>If you do not follow the above guidelines, you may still elicit a
-response, but you may not appreciate it!
-</para>
-<para>For inquiries about support contracts and commercial licensing, visit
-<ulink url="http://www.redhat.com/software/cygwin/">http://www.redhat.com/software/cygwin/</ulink>.
-</para>
-<para>Beyond that, perhaps nobody has time to answer your question. Perhaps
-nobody knows the answer.
+<para>Comprehensive information about reporting problems with Cygwin can be found at <ulink url="http://cygwin.com/problems.html" />.
</para>
</answer></qandaentry>
diff --git a/winsup/doc/faq-using.xml b/winsup/doc/faq-using.xml
index ce66c9de2..2629dbe8b 100644
--- a/winsup/doc/faq-using.xml
+++ b/winsup/doc/faq-using.xml
@@ -50,7 +50,7 @@ with it now, refer to
</answer></qandaentry>
<qandaentry id="faq.using.services">
-<question><para>Why don't my services work (or access network shares)?</para></question>
+<question><para>Why don't my services work?</para></question>
<answer>
<para>Most Windows services run as a special user called <literal>SYSTEM</literal>. If you
@@ -62,10 +62,17 @@ select "Install for All Users", or this script will do the trick:
<screen>
eval "`mount -m | sed -e 's/ -u / -s /g' -e 's/$/;/'`"
</screen>
+</answer></qandaentry>
-<para>The <literal>SYSTEM</literal> user cannot access network shares that require
-authentication. For more information, see
-<ulink url="http://cygwin.com/cygwin-ug-net/ntsec.html">http://cygwin.com/cygwin-ug-net/ntsec.html</ulink>.
+<qandaentry id="faq.using.shares">
+<question><para>Why can't my services access network shares?</para></question>
+<answer>
+
+<para>When a service switches to a certain user, it is running as
+<literal>SYSTEM</literal> impersonating the user account. During
+impersonation, the user's password is not available and so non-public
+network shares are not available. For more information, see
+<ulink url="http://cygwin.com/cygwin-ug-net/ntsec.html" />.
</para>
<para>Workarounds include using public network share that does not require
authentication (for non-critical files), or running the service as
diff --git a/winsup/doc/faq-what.xml b/winsup/doc/faq-what.xml
index fb6c41ac3..8ff468530 100644
--- a/winsup/doc/faq-what.xml
+++ b/winsup/doc/faq-what.xml
@@ -28,7 +28,7 @@ standard Windows command shell.
<para>Wait a minute... Cygwin is only <emphasis>supported</emphasis> if you are paying for
it, such as through a support contract with Red Hat. For information
about getting a Red Hat support contract, see
-<ulink url="http://www.redhat.com/software/tools/cygwin/">http://www.redhat.com/software/tools/cygwin/</ulink>.
+<ulink url="http://cygwin.com/license.html" />.
</para>
<para>That said, Cygwin can be expected to run on all modern 32 bit versions of
Windows, except Windows CE. This includes Windows 95/98/ME/NT/2000/XP.
@@ -70,7 +70,7 @@ how the GNU General Public License may affect your use of these tools.
<para>In particular, if you intend to port a proprietary (non-GPL'd)
application using Cygwin, you will need the proprietary-use license
for the Cygwin library. This is available for purchase; please visit
-<ulink url="http://www.redhat.com/software/tools/cygwin/">http://www.redhat.com/software/tools/cygwin/</ulink> for more information.
+<ulink url="http://cygwin.com/license.html" /> for more information.
All other questions should be sent to the project
mailing list cygwin@cygwin.com.
</para>
diff --git a/winsup/doc/faq.xml b/winsup/doc/faq.xml
index 58dfbd5d8..8e2db662b 100644
--- a/winsup/doc/faq.xml
+++ b/winsup/doc/faq.xml
@@ -85,7 +85,7 @@ with source code available to all.
</para>
<para>Cygwin is currently available for proprietary use only through a
proprietary-use license. Please see
-<ulink url="http://www.redhat.com/software/cygwin/">http://www.redhat.com/software/cygwin/</ulink> for more information
+<ulink url="http://cygwin.com/license.html" /> for more information
about the Red Hat Cygwin Product.
</para>
<para>In accordance with section 10 of the GPL, Red Hat, Inc. permits