From d587c1276e7ccf0035c5e925f8566aa651966a47 Mon Sep 17 00:00:00 2001 From: David Starks-Browning Date: Fri, 26 Jul 2002 22:49:34 +0000 Subject: [PATCH] rewrite (incl new heading) section on installing snapshots --- winsup/doc/install.texinfo | 42 +++++++++++++++----------------------- 1 file changed, 16 insertions(+), 26 deletions(-) diff --git a/winsup/doc/install.texinfo b/winsup/doc/install.texinfo index 03cacc8f4..2442aefc0 100644 --- a/winsup/doc/install.texinfo +++ b/winsup/doc/install.texinfo @@ -225,16 +225,25 @@ It's up to you to deal with other changes you made to your system, such as installing the inetd service, altering system paths, etc. Setup would not have done any of these things for you. -@subsection Can I use setup to install snapshots? +@subsection How do I install snapshots? -No. It used to be possible, but not any more. +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. -If experimenting with developer snapshots from -@file{http://cygwin.com/snapshots/}, 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 +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. + +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. The following steps should work: +everything else. @enumerate @@ -252,22 +261,3 @@ to @code{C:\cygwin\bin\cygwin1.dll}. @end enumerate -The obvious warnings about updating the cygwin package and using developer -snapshots apply: - -@enumerate - -@item Close @strong{all} Cygwin applications, including shells and services -(e.g. inetd), before updating @code{cygwin1.dll}. You may have to -restart Windows to clear the DLL from memory. - -@item 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. - -@item If you cannot download a snapshot from the main ftp distribution -site, use a mirror, and look in the @samp{snapshots} directory. You may -have to hunt for one that has a copy of the latest snapshot. Start at -@file{http://cygwin.com/mirrors.html}. - -@end enumerate