newlib/winsup/doc/faq-resources.xml
Jon Turney c549e953a9 Fix some broken links in Cygwin FAQ
GNU no longer encourages the use of documentation mirrors, to avoid
referring to obsolete documentation.  Also www.fsf.org/manual/ is
just a redirect to www.gnu.org/manual/

Links to using-utils.html #fragments are no longer correct as each utility
is now a separate page, since 646745cb.

indiana.edu seems to have moved XLiveCD information, without a redirect.

Linking to clean_setup.pl on cygwin.com doesn't work, as direct downloads
aren't allowed, so instead state where it can be found on a mirror.

Signed-off-by: Jon Turney <jon.turney@dronecode.org.uk>
2016-12-15 13:02:31 +00:00

56 lines
2.3 KiB
XML

<?xml version="1.0" encoding='UTF-8'?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<qandadiv id="faq.resources">
<title>Further Resources</title>
<!-- faq-resources.xml -->
<qandaentry id="faq.resources.documentation">
<question><para>Where's the documentation?</para></question>
<answer>
<para>If you have installed Cygwin, you can find lots of documentation in
<literal>/usr/share/doc/</literal>. Some packages have Cygwin specific
instructions in a file
<literal>/usr/share/doc/Cygwin/<replaceable>package_name</replaceable>.README</literal>.
In addition, many packages ship with standard documentation, which you can
find in
<literal>/usr/share/doc/<replaceable>package_name</replaceable></literal> or
by using the <literal>man</literal> or <literal>info</literal> tools. (Hint:
use <literal>cygcheck -l <replaceable>package_name</replaceable></literal> to
list what man pages the package includes.) Some older packages still keep
their documentation in <literal>/usr/doc/</literal>
instead of <literal>/usr/share/doc/</literal>.
</para>
<para>There are links to quite a lot of documentation on the main Cygwin
project web page, <ulink url="https://cygwin.com/"/>, including this FAQ.
Be sure to at least read any 'Release Notes' or 'Readme' or 'read this'
links on the main web page, if there are any.
</para>
<para>There is a comprehensive Cygwin User's Guide at
<ulink url="https://cygwin.com/cygwin-ug-net/cygwin-ug-net.html"/>
and an API Reference at
<ulink url="https://cygwin.com/cygwin-api/cygwin-api.html"/>.
</para>
<para>You can find documentation for the individual GNU tools at
<ulink url="http://www.gnu.org/manual/"/>.
</para>
</answer></qandaentry>
<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="https://cygwin.com/lists.html"/>.
</para>
</answer></qandaentry>
<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>Comprehensive information about reporting problems with Cygwin can be found at <ulink url="https://cygwin.com/problems.html"/>.
</para>
</answer></qandaentry>
</qandadiv>