Index: faq-setup.xml
===================================================================
RCS file: /cvs/src/src/winsup/doc/faq-setup.xml,v
retrieving revision 1.2
diff -u -p -r1.2 faq-setup.xml
--- faq-setup.xml 4 Dec 2005 03:55:28 -0000 1.2
+++ faq-setup.xml 12 Jan 2006 02:33:20 -0000
@@ -15,7 +15,7 @@ that the GUI installer is a "work in pro
difficulties, especially if you are behind a firewall or have other
specific requirements. If something doesn't work right for you, and
it's not covered here or in the latest development snapshot at
-http://cygwin.com/setup/, then by all means report it to the
+http://cygwin.com/snapshots/, then by all means report it to the
mailing list.
For a searchable list of packages that can be installed with Cygwin,
@@ -392,37 +392,54 @@ thing stored in the registry.
First, are you sure you want to do this? Snapshots are risky. They
have not been tested. Use them only if there is a feature or
bugfix that you need to try, and you are willing to deal with any
-problems.
-
-Before installing a snapshot, you must first Close all Cygwin
-applications, including shells and services (e.g. inetd, sshd), before
-updating cygwin1.dll. You may have to restart Windows to clear
-the DLL from memory.
-
-You cannot use Setup to install a snapshot.
+problems, or at the request of a Cygwin developer.
You should generally install the full
cygwin-inst-YYYYMMDD.tar.bz2 update, rather than just the DLL,
-otherwise some components may be out of sync. Cygwin tar won't be
-able to update /usr/bin/cygwin1.dll, but it should succeed with
-everything else.
+otherwise some components may be out of sync.
-
-Download the snapshot, and run:
+You cannot use Cygwin Setup to install a snapshot.
+
+First, you will need to download the snapshot from the snapshots
+page at http://cygwin.com/snapshots/. Note the directory where
+you saved the snapshot tarball.
+
+Before installing a snapshot, you must first Close all Cygwin
+applications, including shells and services (e.g., inetd, sshd).
+You will not be able to replace cygwin1.dll if any Cygwin process is
+running. You may have to restart Windows to clear the DLL from memory
+(beware of automatic service startup).
+
+Most of the downloaded snapshot can be installed using tar. Cygwin
+tar won't be able to update /usr/bin/cygwin1.dll (because it's
+used by tar itself), but it should succeed with everything else. If
+you are only installing the DLL snapshot, skip the first tar command. Open
+a bash shell (it should be the only running Cygwin process) and issue
+the following commands:
- cd /
- tar jxvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.bz2 --exclude=usr/bin/cygwin1.dll
- cd /tmp
- tar jxvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.bz2 usr/bin/cygwin1.dll
+ /bin/tar -C/ -jxvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.bz2 --exclude=usr/bin/cygwin1.dll
+ /bin/tar -C/tmp -jxvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.bz2 usr/bin/cygwin1.dll
+ /bin/mv /bin/cygwin1.dll /bin/cygwin1-prev.dll
-
-After closing all Cygwin apps (see above), use Explorer or the
+Note that after the "mv" command you will not be able to run any
+Cygwin programs. Exit the bash shell, and use Explorer or the
Windows command shell to move C:\cygwin\tmp\usr\bin\cygwin1.dll
-to C:\cygwin\bin\cygwin1.dll.
+to C:\cygwin\bin\cygwin1.dll (assuming you installed Cygwin in
+C:\cygwin).
+
+The operative word in trying the snapshots is "trying". 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 http://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
+C:\cygwin\bin\cygwin1.dll, and
+rename C:\cygwin\bin\cygwin1-prev.dll back to
+C:\cygwin\bin\cygwin1.dll (again assuming that your "/" is
+C:\cygwin). To restore the rest of the snapshot
+files, reinstall the "cygwin" package using Setup.
-
-
Index: install.texinfo
===================================================================
RCS file: /cvs/src/src/winsup/doc/install.texinfo,v
retrieving revision 1.53
diff -u -p -r1.53 install.texinfo
--- install.texinfo 18 May 2005 11:56:27 -0000 1.53
+++ install.texinfo 12 Jan 2006 02:33:20 -0000
@@ -13,7 +13,7 @@ that the GUI installer is a "work in pro
difficulties, especially if you are behind a firewall or have other
specific requirements. If something doesn't work right for you, and
it's not covered here or in the latest development snapshot at
-@file{http://cygwin.com/setup/}, then by all means report it to the
+@file{http://cygwin.com/snapshots/}, then by all means report it to the
mailing list.
For a searchable list of packages that can be installed with Cygwin,
@@ -311,36 +311,54 @@ thing stored in the registry.
First, are you sure you want to do this? Snapshots are risky. They
have not been tested. Use them @strong{only} if there is a feature or
bugfix that you need to try, and you are willing to deal with any
-problems.
-
-Before installing a snapshot, you must first Close @strong{all} Cygwin
-applications, including shells and services (e.g. inetd, sshd), before
-updating @code{cygwin1.dll}. You may have to restart Windows to clear
-the DLL from memory.
-
-You cannot use Setup to install a snapshot.
+problems, or at the request of a Cygwin developer.
You should generally install the full
@code{cygwin-inst-YYYYMMDD.tar.bz2} update, rather than just the DLL,
-otherwise some components may be out of sync. Cygwin tar won't be
-able to update @code{/usr/bin/cygwin1.dll}, but it should succeed with
-everything else.
+otherwise some components may be out of sync.
-@enumerate
+You cannot use Cygwin Setup to install a snapshot.
+
+First, you will need to download the snapshot from the snapshots
+page at @file{http://cygwin.com/snapshots/}. Note the directory where
+you saved the snapshot tarball.
+
+Before installing a snapshot, you must first Close @strong{all} Cygwin
+applications, including shells and services (e.g., @code{inetd}, @code{sshd}).
+You will not be able to replace @code{cygwin1.dll} if any Cygwin process is
+running. You may have to restart Windows to clear the DLL from memory
+(beware of automatic service startup).
+
+Most of the downloaded snapshot can be installed using @code{tar}. Cygwin
+@code{tar} won't be able to update @code{/usr/bin/cygwin1.dll} (because it's
+used by @code{tar} itself), but it should succeed with everything else. If
+you are only installing the DLL snapshot, skip the first tar command. Open
+a @code{bash} shell (it should be the only running Cygwin process) and issue
+the following commands:
-@item Download the snapshot, and run:
@example
- cd /
- tar jxvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.bz2 --exclude=usr/bin/cygwin1.dll
- cd /tmp
- tar jxvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.bz2 usr/bin/cygwin1.dll
+ /bin/tar -C/ -jxvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.bz2 --exclude=usr/bin/cygwin1.dll
+ /bin/tar -C/tmp -jxvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.bz2 usr/bin/cygwin1.dll
+ /bin/mv /bin/cygwin1.dll /bin/cygwin1-prev.dll
@end example
-@item After closing all Cygwin apps (see above), use Explorer or the
+Note that after the "@code{mv}" command you will not be able to run any
+Cygwin programs. Exit the bash shell, and use Explorer or the
Windows command shell to move @code{C:\cygwin\tmp\usr\bin\cygwin1.dll}
-to @code{C:\cygwin\bin\cygwin1.dll}.
+to @code{C:\cygwin\bin\cygwin1.dll} (assuming you installed Cygwin in
+@code{C:\cygwin}).
-@end enumerate
+The operative word in trying the snapshots is "@emph{trying}". 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 @file{http://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
+@code{C:\cygwin\bin\cygwin1.dll}, and
+rename @code{C:\cygwin\bin\cygwin1-prev.dll} back to
+@code{C:\cygwin\bin\cygwin1.dll} (again assuming that your "@code{/}" is
+@code{C:\cygwin}). To restore the rest of the snapshot
+files, reinstall the "@code{cygwin}" package using Setup.
@subsection Can Cygwin Setup maintain a ``mirror''?