Cygwin: FAQ: describe test releases, deprecate developer snapshots

Signed-off-by: Corinna Vinschen <corinna@vinschen.de>

1 files changed, 31 insertions, 52 deletions

diff --git a/winsup/doc/faq-setup.xml b/winsup/doc/faq-setup.xml
index da9fce534..981a7246a 100644
--- a/winsup/doc/faq-setup.xml
+++ b/winsup/doc/faq-setup.xml
@@ -21,10 +21,10 @@ tools.
 is available on using the Cygwin Setup program.
 </para>
 <para>If you do it any other way, you're on your own!
-If something doesn't work right for you, and
-it's not covered here or in the latest development snapshot at
-<ulink url="https://cygwin.com/snapshots/"/>, then by all means report it to the
-mailing list.
+If something doesn't work right for you, and it's not covered here or in
+the latest Cygwin test package (see
+<ulink url="https://cygwin.com/faq/faq-api.html#faq.api.testrels"/>),
+then by all means report it to the mailing list.
 </para>
 <para>For a searchable list of packages that can be installed with Cygwin,
 see <ulink url="https://cygwin.com/packages/"/>.
@@ -627,56 +627,35 @@ directory has been stored in the registry at all.
 
 </answer></qandaentry>
 
-<qandaentry id="faq.setup.snapshots">
-<question><para>How do I install snapshots?</para></question>
+<qandaentry id="faq.setup.testrels">
+<question><para>How do I install Cygwin test releases?</para></question>
 <answer>
 
-<para>First, are you sure you want to do this?  Snapshots are risky.  They
-have not been tested.  Use them <emphasis role='bold'>only</emphasis> if there is a feature or
-bugfix that you need to try, and you are willing to deal with any
-problems, or at the request of a Cygwin developer.
-</para>
-<para>You cannot use the Cygwin Setup program to install a snapshot.
-</para>
-<para>First, you will need to download the snapshot from the snapshots
-page at <ulink url="https://cygwin.com/snapshots/"/>.  Note the directory where
-you saved the snapshot tarball.
-</para>
-<para>Before installing a snapshot, you must first Close <emphasis role='bold'>all</emphasis> Cygwin
-applications, including shells and services (e.g., <literal>inetd</literal>, <literal>sshd</literal>).
-You will not be able to replace <literal>cygwin1.dll</literal> if any Cygwin process is
-running.  You may have to restart Windows to clear the DLL from memory
-(beware of automatic service startup).
-</para>
-<para>Most of the downloaded snapshot can be installed using <literal>tar</literal>.  Cygwin
-<literal>tar</literal> won't be able to update <literal>/usr/bin/cygwin1.dll</literal> (because it's
-used by <literal>tar</literal> itself), but it should succeed with everything else.  If
-you are only installing the DLL snapshot, skip the first tar command.  Open
-a <literal>bash</literal> shell (it should be the only running Cygwin process) and issue
-the following commands:
-<screen>
-	/bin/tar -C / -xvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.* --exclude=usr/bin/cygwin1.dll
-	/bin/tar -C /tmp -xvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.* usr/bin/cygwin1.dll
-</screen>
-</para>
-<para>Exit the bash shell, and use Explorer or the Windows command shell to
-first rename <literal>C:\cygwin\bin\cygwin1.dll</literal> to
-<literal>C:\cygwin\bin\cygwin1-prev.dll</literal> and then move
-<literal>C:\cygwin\tmp\usr\bin\cygwin1.dll</literal>
-to <literal>C:\cygwin\bin\cygwin1.dll</literal> (assuming you installed Cygwin in
-<literal>C:\cygwin</literal>).
-</para>
-<para>The operative word in trying the snapshots is "<emphasis>trying</emphasis>".  If you
-notice a problem with the snapshot that was not present in the release
-DLL (what we call a "regression"), please report it to the Cygwin
-mailing list (see <ulink url="https://cygwin.com/problems.html"/> for problem
-reporting guidelines).  If you wish to go back to the older version of the
-DLL, again, close all Cygwin processes, delete
-<literal>C:\cygwin\bin\cygwin1.dll</literal>, and
-rename <literal>C:\cygwin\bin\cygwin1-prev.dll</literal> back to
-<literal>C:\cygwin\bin\cygwin1.dll</literal> (again assuming that your "<literal>/</literal>" is
-<literal>C:\cygwin</literal>).  To restore the rest of the snapshot
-files, reinstall the "<literal>cygwin</literal>" package using the Cygwin Setup program.
+<para>You can install Cygwin test releases just like test releases of
+any other package using the Cygwin Setup program.  Ideally, you install
+not only the <emphasis role='bold'>cygwin</emphasis> test package, but
+also the <emphasis role='bold'>cygwin-debuginfo</emphasis> test package
+with the same version number.  The cygwin-debuginfo package allows source
+code debugging using gdb.  Install the
+<emphasis role='bold'>cygwin-devel</emphasis> test package, if you also
+want to test building against a new API.
+</para>
+<para>However, are you sure you want to do this?  Test releases are risky.
+They have only been marginally tested most of the time.  Use them
+<emphasis role='bold'>only</emphasis> if there is a feature or bugfix that
+you need to try, and you are willing to deal with any problems, or at the
+request of a Cygwin developer.
+</para>
+<para>The operative word in trying the test releases is
+"<emphasis>trying</emphasis>".  If you notice a problem with the snapshot
+that was not present in the release DLL (what we call a "regression"),
+please report it to the Cygwin mailing list
+(see <ulink url="https://cygwin.com/problems.html"/> for problem
+reporting guidelines).  If you wish to go back to the most recent non-test
+release of the Cygwin DLL, close all Cygwin processes, as usual, start the
+Cygwin Setup program and choose the most recent non-test release of the
+cygwin package, as well as the cygwin-debuginfo and cygwin-devel packages.
+That's all there is to it.
 </para>
 
 </answer></qandaentry>