From b22830942a9a338983dc3e1dfaae2fc8bbcc0d73 Mon Sep 17 00:00:00 2001 From: Joshua Daniel Franklin Date: Fri, 13 Jan 2006 03:55:23 +0000 Subject: * faq-setup.xml (faq.setup.setup): Correct URL typo. (faq.setup.snapshots): Clarify. --- winsup/doc/ChangeLog | 2 ++ winsup/doc/faq-setup.xml | 65 ++++++++++++++++++++++++++++++------------------ 2 files changed, 43 insertions(+), 24 deletions(-) diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index 17b414e63..1cd9be0db 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,6 +1,8 @@ 2006-01-12 Igor Peshansky * doctool.c (scan_directory): Ignore "CVS" directories. + * faq-setup.xml (faq.setup.setup): Correct URL typo. + (faq.setup.snapshots): Clarify. 2005-12-30 Christopher Faylor diff --git a/winsup/doc/faq-setup.xml b/winsup/doc/faq-setup.xml index 360bee803..e0ef693f2 100644 --- a/winsup/doc/faq-setup.xml +++ b/winsup/doc/faq-setup.xml @@ -8,14 +8,14 @@ installer ``Cygwin Setup''. It is flexible and easy to use. You can pick and choose the packages you wish to install, and update them individually. Full source code is available for all packages and tools. More information on using Cygwin Setup may be found at -http://cygwin.com/cygwin-ug-net/setup-net.html. +. If you do it any other way, you're on your own! That said, keep in mind that the GUI installer is a "work in progress", so there might be a few 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. - - -- cgit v1.2.3