JehanneOS/newlib
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

"setup.exe" -> "Cygwin Setup" throughout. Other minor changes throughout.

Browse Source
This commit is contained in:
David Starks-Browning 2002-03-03 10:57:57 +00:00
parent 6c766d2095
commit 2550d8015b
1 changed files with 55 additions and 52 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

107
winsup/doc/install.texinfo
View File

@ -10,9 +10,8 @@ see @file{http://cygwin.com/packages/}.
Full source code is available for all packages and tools. Full source code is available for all packages and tools.
There is one recommended way to install Cygwin, which is to use the GUI There is only one recommended way to install Cygwin, which is to use the GUI
installer @samp{setup.exe}. There are some variations on how you go installer ``Cygwin Setup''. It is flexible and easy to use.
about that.
Do it any other way, and you're on your own! That said, keep in mind Do it any other way, and 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 that the GUI installer is a "work in progress", so there might be a few
@ -21,18 +20,18 @@ specific requirements. If something doesn't work right for you, and
it's not covered here or elsewhere, then by all means report it to the it's not covered here or elsewhere, then by all means report it to the
mailing list. mailing list.
@section Installation using the @samp{setup.exe} program @section Installation using ``Cygwin Setup''
The @samp{setup.exe} program is the recommended way to install Cygwin, The Cygwin Setup program is the only recommended way to install Cygwin,
but it is still a work in progress. Expect features and functionality but it is still a work in progress. Expect features and functionality
to change. For this reason, it is a good idea to note the version and to change. For this reason, it is a good idea to note the version and
build time reported by @code{setup.exe} when you run it. This will help build time reported by Cygwin Setup when you run it. This will help
diagnose problems, should you have any. Check the cygwin mailing list diagnose problems, should you have any. Check the cygwin mailing list
for the latest news about @code{setup.exe}. for the latest news about Cygwin Setup.
@subsection Why not install in C:\? @subsection Why not install in C:\?
The @code{setup.exe} program will prompt you for a "root" directory. The Cygwin Setup program will prompt you for a "root" directory.
The default is @samp{C:\cygwin}, but you can change it. You are urged not to The default is @samp{C:\cygwin}, but you can change it. You are urged not to
choose something like 'C:\' (the root directory on the system drive) for choose something like 'C:\' (the root directory on the system drive) for
your Cygwin root. If you do, then critical Cygwin system directories your Cygwin root. If you do, then critical Cygwin system directories
@ -40,24 +39,27 @@ like 'etc', 'lib' and 'bin' could easily be corrupted by other (non-Cygwin)
applications or packages that use \etc, \lib or \bin. Perhaps there is applications or packages that use \etc, \lib or \bin. Perhaps there is
no conflict now, but who knows what you might install in the future? no conflict now, but who knows what you might install in the future?
It's also just good common sense to segregate your Cygwin "filesystems" It's also just good common sense to segregate your Cygwin "filesystems"
from the rest of your Windows system disk. (In the past, there had been from the rest of your Windows system disk.
genuine bugs that would cause problems for people who installed in C:\,
but we believe those are gone now.)
@subsection Can I use the new setup to update a B18, B19, B20, B20.1 or CD-ROM (1.0) installation of Cygwin? (In the past, there had been genuine bugs that would cause problems
for people who installed in C:\, but we believe those are gone now.)
No, you must start from scratch with the new setup. The overall @subsection Can I use Cygwin Setup to update a B18, B19, B20, B20.1 or CD-ROM (1.0) installation of Cygwin?
structure has changed so much that it would be silly to try to
accomodate old installations of Cygwin. You'll probably be much better
off with a whole new installation anyway. You may backup or rename your
old installation first, or just install the new one somewhere else. Be
sure to make note of your current mount table, because this will be
overwritten during the new setup.
Once you've installed the latest net release, the new setup will update No, you must start from scratch with the new Cygwin Setup. The
overall structure has changed so much that it would be pointless to
try to accomodate old installations of Cygwin. You will probably be
much better off with a whole new installation anyway. You may backup
or rename your old installation first, or just install the new one
somewhere else. Be sure to make note of your current mount table,
because this will be overwritten during the new setup. Make sure you
don't end up with two different versions of @samp{cygwin1.dll} in your
path.
Once you've installed the latest net release, Cygwin Setup will update
just the individual packages that need it. just the individual packages that need it.
@subsection Is @code{setup.exe}, or one of the packages, infected with a virus? @subsection Is Cygwin Setup, or one of the packages, infected with a virus?
Unlikely. Unless you can confirm it, please don't report it to the Unlikely. Unless you can confirm it, please don't report it to the
mailing list. Anti-virus products have been known to detect false mailing list. Anti-virus products have been known to detect false
@ -66,12 +68,13 @@ problems for you, consider disabling your anti-virus software when
running @code{setup}. Read the next entry for a fairly safe way to do running @code{setup}. Read the next entry for a fairly safe way to do
this. this.
@subsection My computer hangs when I try to run @code{setup.exe}! @subsection My computer hangs when I run Cygwin Setup!
Network Associates (formerly McAfee) products have been reported to Both Network Associates (formerly McAfee) and Norton anti-virus
"hang" when extracting Cygwin tar archives. Consider disabling your products have been reported to "hang" when extracting Cygwin tar
anti-virus software when running @code{setup}. The following archives. If this happens to you, consider disabling your anti-virus
procedure should be a fairly safe way to do that: software when running Cygwin Setup. The following procedure should be
a fairly safe way to do that:
@enumerate @enumerate
@item Download @code{setup.exe} and scan it explicitly. @item Download @code{setup.exe} and scan it explicitly.
@ -83,19 +86,20 @@ procedure should be a fairly safe way to do that:
@item Re-activate your anti-virus software and scan everything @item Re-activate your anti-virus software and scan everything
in C:\cygwin (or wherever you chose to install). If you're concerned in C:\cygwin (or wherever you chose to install). If you're concerned
about a malicious package, say if a mirror is compromised, then you about a malicious package, say if a mirror is compromised, then you
should scan your entire hard disk after running setup. should scan your entire hard disk after running Cygwin Setup.
@end enumerate @end enumerate
This should be safe provided setup.exe is not substituted by something This should be safe, but only if Cygwin Setup is not substituted by
malicious. something malicious.
@subsection What packages should I download? @subsection What packages should I download?
When using @samp{setup.exe} for the first time, the default is to When using Cygwin Setup for the first time, the default is to install
install a minimal subset of packages. If you want anything beyond a minimal subset of packages. If you want anything beyond that, you
that, you will have to select it explicitly. See will have to select it explicitly. See
@file{http://cygwin.com/packages/} for a searchable list of packages available. @file{http://cygwin.com/packages/} for a searchable list of available
packages.
If you want to build programs, of course you'll need @samp{gcc}, If you want to build programs, of course you'll need @samp{gcc},
@samp{binutils}, @samp{make} and probably other packages from the @samp{binutils}, @samp{make} and probably other packages from the
@ -106,11 +110,12 @@ If you want to build programs, of course you'll need @samp{gcc},
In the past, the default was to install everything, much to the In the past, the default was to install everything, much to the
irritation of many users. Now the default is to install only a basic irritation of many users. Now the default is to install only a basic
core of packages. At the moment, there is no easy way to get core of packages. At the moment, there is no easy way to get
everything. You must do the following: everything. In the current version of Cygwin Setup, if you want
everything, you must do the following:
@enumerate @enumerate
@item When the GUI says ``Select packages to install'', click on the @item When the Cygwin Setup says ``Select packages to install'', click on the
``View'' button until it says ``Full''. ``View'' button until it says ``Full''.
@item Wherever it says ``Skip'', click twice until it gives the @item Wherever it says ``Skip'', click twice until it gives the
@ -120,14 +125,14 @@ installed.
@end enumerate @end enumerate
If a package you've selected for installation has prerequisites, those If a package you've selected for installation has prerequisites, those
will automatically be installed too. It's a lot of clicking but you will automatically be installed too. It's a lot of clicking but only
only the first time. Once you install a package, any subsequent the first time. Once you install a package, any subsequent updates to
updates to that package will be installed by default. Note that new that package will be installed by default. Note that new packages are
packages are added rather frequently, so you'll have to regularly added regularly, so you will always have to check the list for any
check the list for any ``Skip'' entries if you want to stay up to date ``Skip'' entries if you want to stay up to date with a complete
with a complete installation. installation.
This should become much easier in a future version of @samp{setup.exe}. This should become much easier in a future version of Cygwin Setup.
@subsection How much disk space does Cygwin require? @subsection How much disk space does Cygwin require?
@ -142,11 +147,10 @@ subdirectories there.
@subsection What if setup fails? @subsection What if setup fails?
First, make sure that you are using the latest version of First, make sure that you are using the latest version of Cygwin
@code{setup.exe}. It's a work in progress, with improvements and Setup. It is a work in progress, with improvements and bugfixes being
bugfixes being made often. The latest version is always available from made often. The latest version is always available from the 'Install
the 'Install Cygwin now' link on the Cygwin Home Page at Cygwin now' link on the Cygwin Home Page at @file{http://cygwin.com/}.
@file{http://cygwin.com/}.
If you are downloading from the internet, setup will fail if it cannot If you are downloading from the internet, setup will fail if it cannot
download the list of mirrors at download the list of mirrors at
@ -174,9 +178,8 @@ what happened that wasn't supposed to happen, etc.
@subsection What's the difference between packages in @samp{latest} and @samp{contrib}? @subsection What's the difference between packages in @samp{latest} and @samp{contrib}?
There is no difference as far as @code{setup.exe} is concerned, and There is no difference as far as Cygwin Setup is concerned. The
you should not worry about this either. The distinction is distinction is historical, not practical.
historical, not practical.
@subsection My Windows logon name has a space in it, will this cause problems? @subsection My Windows logon name has a space in it, will this cause problems?
@ -196,7 +199,7 @@ README file for that package.)
@subsection How do I uninstall individual packages? @subsection How do I uninstall individual packages?
Run @code{setup.exe} as you would to install packages. In the list of Run Cygwin Setup as you would to install packages. In the list of
packages to install, browse the relevant category or click on the packages to install, browse the relevant category or click on the
``View'' button to get a full listing. Click on the cycle glyph until ``View'' button to get a full listing. Click on the cycle glyph until
the action reads ``Uninstall''. Proceed by clicking ``Next''. the action reads ``Uninstall''. Proceed by clicking ``Next''.
@ -255,7 +258,7 @@ snapshots apply:
@enumerate @enumerate
@item Close all Cygwin apps, including shells and services @item Close @strong{all} Cygwin applications, including shells and services
(e.g. inetd), before updating @code{cygwin1.dll}. You may have to (e.g. inetd), before updating @code{cygwin1.dll}. You may have to
restart Windows to clear the DLL from memory. restart Windows to clear the DLL from memory.