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
This commit is contained in:
Joshua Daniel Franklin 2005-08-27 01:32:36 +00:00
parent 63958f00d3
commit 7a582da599
6 changed files with 28 additions and 111 deletions

View File

@ -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

View File

@ -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 $@

View File

@ -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 &amp; 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>

View File

@ -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

View File

@ -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>

View File

@ -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