diff --git a/winsup/doc/install.texinfo b/winsup/doc/install.texinfo index 202db8e66..816541291 100644 --- a/winsup/doc/install.texinfo +++ b/winsup/doc/install.texinfo @@ -199,32 +199,43 @@ would not have done any of these things for you. @subsection Can I use setup to install snapshots? -Yes. If experimenting with developer snapshots from +No. It used to be possible, but not any more. + +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. However, Cygwin tar -won't work because it will load the DLL that you're trying to update, -and a non-Cygwin program like WinZip will put everything in the wrong -place. The solution is to use @code{setup.exe}. +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: -Just bunzip2 the cygwin-inst tarball, rename it to cygwin-YYYYMMDD.tar, -gzip it, put it in an empty directory, and run @code{setup.exe} there. -You should be given the option to install it. +@enumerate + +@item Download the snapshot, and run: +@example + cd / + tar jxvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.bz2 + cd /tmp + tar jxvf /posix/path/to/cygwin-inst-YYYYMMDD.tar.bz2 usr/bin/cygwin1.dll +@end example + +@item After closing all Cygwin apps (see below), use Explorer or the +Windows command shell to move @code{C:\cygwin\tmp\usr\bin\cygwin1.dll} +to @code{C:\cygwin\bin\cygwin1.dll}. + +@end enumerate The obvious warnings about updating the cygwin package and using developer snapshots apply: @enumerate -@item Always download the latest version of setup from -@file{http://cygwin.com/setup.exe}. - @item Close all Cygwin apps, including shells and services -(e.g. inetd), before running setup. You may have to restart Windows to -clear the DLL from memory. +(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. +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