libs/newlib-cygwin
libs
/
newlib-cygwin
mirror of git://sourceware.org/git/newlib-cygwin.git
4
0
Fork 0
Code Issues Projects Releases Wiki Activity

Rewrote "Adding or updating packages", 

plus a few other minor changes.
This commit is contained in:
David Starks-Browning 2000-06-14 20:56:56 +00:00
parent df031c83f4
commit fe905b6259
1 changed files with 50 additions and 47 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

97
winsup/doc/install.texinfo
View File

@ -7,11 +7,11 @@ choose the packages you wish to install, and update them individually.
The following packages are available with the latest net release: The following packages are available with the latest net release:
ash(really '/bin/sh'), bash, binutils, bison, byacc, bzip2, clear, common, ash, bash, binutils, bison, byacc, bzip2, clear, common, cygwin,
cygwin, dejagnu, diff, expect, fileutils, findutils, flex, gawk, gcc, dejagnu, diff, expect, fileutils, findutils, flex, gawk, gcc, gdb,
gdb, gperf, grep, groff, gzip, inetutils, less, libpng, login, m4, make, gperf, grep, groff, gzip, inetutils, less, libpng, login, m4, make, man,
man, patch, sed, shellutils, tar, tcltk, termcap, texinfo, textutils, patch, sed, shellutils, tar, tcltk, termcap, texinfo, textutils, time,
time, zlib zlib
Full source code is available for all packages and tools. Full source code is available for all packages and tools.
@ -57,8 +57,8 @@ C:\cygwin / user binmode
Note that /bin and /usr/bin point to the same location, as do /lib and Note that /bin and /usr/bin point to the same location, as do /lib and
/usr/lib. This is intentional, and you should not undo these mounts /usr/lib. This is intentional, and you should not undo these mounts
unless you @emph{really} know what you are doing. Currently, unless you @emph{really} know what you are doing. Currently,
@code{setup.exe} creates only binary mounts, but future versions will be @code{setup.exe} creates only binary mounts, but future versions will
more flexible. probably be more flexible.
You can let @code{setup.exe} download all the files for you on the fly. You can let @code{setup.exe} download all the files for you on the fly.
This is the 'internet' installation. Or you can download all (or some) This is the 'internet' installation. Or you can download all (or some)
@ -87,8 +87,9 @@ Then proceed according to your choice below.
Shut down @strong{all cygwin applications} (including inetd, etc.). Shut down @strong{all cygwin applications} (including inetd, etc.).
Then, @strong{in a command window} ("MS-DOS Prompt" in Windows 95/98), Then, in a @strong{Windows command prompt} ("MS-DOS Prompt" in Windows
'@code{cd}' to the temporary directory and type '@code{setup.exe}'. 95/98), '@code{cd}' to the temporary directory and type
'@code{setup.exe}'.
When prompted, specify the location of the root directory, or accept the When prompted, specify the location of the root directory, or accept the
default. default.
@ -99,13 +100,14 @@ the default.
Setup will connect to sourceware.cygnus.com to read a list of mirror Setup will connect to sourceware.cygnus.com to read a list of mirror
sites. Choose one from the list, or choose 'other' to supply your own. sites. Choose one from the list, or choose 'other' to supply your own.
If you supply your own, you must provide a full URL, not just the ftp If you supply your own, you must provide a full URL, not just the ftp
hostname. Setup will then proceed to download all packages from the ftp hostname. Setup will then proceed to download and install all packages
site. Of course this may take a while if you have a slow connection. from the ftp site. Of course this may take a while if you have a slow
connection.
When finished, Setup will have created a "Cygnus Solutions" folder on When finished, Setup will have created a "Cygnus Solutions" folder on
your Start Menu, containing a shortcut to @code{cygwin.bat}, which your Start Menu, containing a shortcut to @code{cygwin.bat}, which
invokes bash with various environment variables set correctly. The invokes bash with various environment variables set correctly. The
"Uninstall Cygwin" shortcut, if present, is unlikely to do a complete "Uninstall Cygwin" shortcut, if present, is unlikely to do a proper
job. If you want to completely uninstall Cygwin, you will probably have job. If you want to completely uninstall Cygwin, you will probably have
to delete some things by hand. to delete some things by hand.
@ -131,13 +133,14 @@ installation.
When you have all the necessary tar files together with When you have all the necessary tar files together with
@code{setup.exe}, proceed as you would for an internet installation, @code{setup.exe}, proceed as you would for an internet installation,
except choose directory installation ('d') when prompted. Setup will except choose directory installation ('d') when prompted. Setup will
install from the tar files that it finds there. Here are the details install all the tar files that it finds there. Here are the gory
again: details again:
Shut down @strong{all cygwin applications} (including inetd, etc.). Shut down @strong{all cygwin applications} (including inetd, etc.).
Then, @strong{in a command window} ("MS-DOS Prompt" in Windows 95/98), Then, in a @strong{Windows command prompt} ("MS-DOS Prompt" in Windows
'@code{cd}' to the temporary directory and type '@code{setup.exe}'. 95/98), '@code{cd}' to the temporary directory and type
'@code{setup.exe}'.
When prompted, specify the location of the root directory, or accept the When prompted, specify the location of the root directory, or accept the
default. default.
@ -148,7 +151,7 @@ This is @strong{not} the default.
When finished, Setup will have created a "Cygnus Solutions" folder on When finished, Setup will have created a "Cygnus Solutions" folder on
your Start Menu, containing a shortcut to @code{cygwin.bat}, which your Start Menu, containing a shortcut to @code{cygwin.bat}, which
invokes bash with various environment variables set correctly. The invokes bash with various environment variables set correctly. The
"Uninstall Cygwin" shortcut, if present, is unlikely to do a complete "Uninstall Cygwin" shortcut, if present, is unlikely to do a proper
job. If you want to completely uninstall Cygwin, you will probably have job. If you want to completely uninstall Cygwin, you will probably have
to delete some things by hand. to delete some things by hand.
@ -162,39 +165,40 @@ if your installation failed for some reason.
Later versions of @code{setup.exe} permit you to add and/or update Later versions of @code{setup.exe} permit you to add and/or update
packages to an existing cygwin installation. packages to an existing cygwin installation.
To update your installation, create an empty directory, cd to it, and @strong{You cannot use this method to update a B18, B19, B20, B20.1 or
download the latest version of @code{setup.exe} from the @code{latest} CD-ROM (1.0) installation of Cygwin. You must have previously installed
directory at a Cygwin mirror near you. a net release of Cygwin 1.1.0 or greater, using @code{setup.exe}, before
you can update packages with 'setup -u'.}
Once you've downloaded @code{setup.exe}, type To update your installation, create an empty temporary directory, and
download the latest version of @code{setup.exe} to it from a Cygwin
mirror near you.
Then, in a @strong{Windows command prompt} ("MS-DOS Prompt" in Windows
95/98), '@code{cd}' to the temporary directory and type
@example @example
./setup <pkg> setup -u <pkg>
@end example @end example
where "<pkg>" is the name of the package you wish to update, such as where "<pkg>" is the name of the package you wish to update, such as
"cygwin" or "gdb" or "make" or ... "cygwin" or "gdb" or "make" or ...
Answer the questions as you did when you first installed Cygwin. This Specify the root directory as you did when you first installed Cygwin.
will update the package. As with the initial installation, you can This will update the package. As with the initial installation, you can
update from the (i)nternet or from the (d)irectory. The latter requires update from the internet ('i') or from the directory ('d'). The latter
that you download the @code{.tar.gz} file of the package ahead of time, requires that you download the @code{.tar.gz} file of the package ahead
along with @code{setup.exe}. of time, along with @code{setup.exe}.
If you are updating "cygwin", then you must close @strong{all} Cygwin If you are updating the package "cygwin", then you must close
applications (including @code{inetd}, for example), and run @strong{all} Cygwin applications (including @code{inetd}, for example),
@code{setup.exe} from the Windows command prompt. before running setup.
If you supply the @code{-u} option to @code{setup.exe}, then You can omit the '-u' option, which will force setup to install the
@code{setup.exe} will only update the package if an older version is latest package (from internet or directory), regardless of whether
currently installed. For example: @code{setup.exe} believes it is necessary. You @strong{must} omit '-u'
@example if you are updating from a development snapshot, because development
./setup -u gdb snapshots have their version numbers "bumped" to the next release
@end example number. In this case, @code{setup.exe} will think your installation is
However, if you currently have a development snapshot installed, setup already up-to-date.
may fail to update the package, because development snapshots have their
version numbers "bumped" to the next release number. In this case, you
should not use @code{-u}. Omitting @code{-u} forces @code{setup.exe} to
perform the update, regardless of whether @code{setup.exe} deems it
necessary.
Once setup is complete you may remove the temporary directory. It will Once setup is complete you may remove the temporary directory. It will
contain @code{setup.exe}, the downloaded @code{.tar.gz} files, and a contain @code{setup.exe}, the downloaded @code{.tar.gz} files, and a
@ -207,24 +211,23 @@ if your installation failed for some reason.
This means that @code{setup.exe} could not make an http connection to This means that @code{setup.exe} could not make an http connection to
@file{http://sourceware.cygnus.com/cygwin/mirrors.html}. This is @file{http://sourceware.cygnus.com/cygwin/mirrors.html}. This is
required for an (i)nternet install. Either sourceware.cygnus.com was required for an internet ('i') install. Either sourceware.cygnus.com was
too busy, or there is a problem with your network. Note that too busy, or there is a problem with your network. Note that
@code{setup.exe} has very limited proxy functionality for firewalls, and @code{setup.exe} has very limited proxy functionality for firewalls, and
depends on IE4 or later being installed and configured properly. If you depends on IE4 or later being installed and configured properly. If you
cannot get the (i)nternet installation to work, just download the cannot get the internet installation to work, just download the
packages yourself and do a (d)irectory install. packages yourself and do a directory ('d') install.
@subsubsection System hangs when unpacking tar archives @subsubsection System hangs when unpacking tar archives
Your anti-virus software is interfering with @code{setup.exe}. You will Your anti-virus software is interfering with @code{setup.exe}. You will
have to disable it before running setup. In that case, you will have to disable it before running setup. In that case, you will
probably want to: probably want to:
@enumerate @enumerate
@item download all the .tar.gz files for the packages, along with @code{setup.exe} @item download all the .tar.gz files for the packages, along with @code{setup.exe}
@item scan it all for viruses @item scan it all for viruses
@item disable the anti-virus software @item disable the anti-virus software
@item perform a (d)irectory install @item perform a directory ('d') install
@item re-enable the anti-virus software @item re-enable the anti-virus software
@item scan everything below your Cygwin root directory (@code{C:\cygwin} by default) @item scan everything below your Cygwin root directory (@code{C:\cygwin} by default)
@end enumerate @end enumerate