diff options
Diffstat (limited to 'winsup/doc/setup-net.sgml')
-rw-r--r-- | winsup/doc/setup-net.sgml | 131 |
1 files changed, 7 insertions, 124 deletions
diff --git a/winsup/doc/setup-net.sgml b/winsup/doc/setup-net.sgml index d6719e655..cc40f312b 100644 --- a/winsup/doc/setup-net.sgml +++ b/winsup/doc/setup-net.sgml @@ -1,131 +1,14 @@ <chapter id="setup-net"><title>Setting Up Cygwin</title> -<sect1><title>Cygwin Contents</title> - -<para>The following packages are included in the full release:</para> - -<para>Development tools: binutils, bison, byacc, dejagnu, diff, -expect, flex, gas, gcc, gdb, itcl, ld, libstdc++, make, patch, tcl, -tix, tk</para> - -<para>User tools: ash, bash, bzip2, diff, fileutils, findutils, gawk, -grep, gzip, less, m4, sed, shellutils, tar, textutils, time</para> - -<para>The user tools release only contains the user tools.</para> - -<para>Full source code is available for these tools.</para> - -</sect1> -<sect1 id="installing-binaries"><title>Installing the binary release</title> - -<para>Important! Be sure to remove any older versions of the Cygwin -tools from your <EnVar>PATH</EnVar> environment variable so you do -not execute them by mistake.</para> - -<para>Connect to one of the ftp servers listed in -<ulink URL="http://sourceware.cygnus.com/cygwin/mirrors.html"> -http://sourceware.cygnus.com/cygwin/mirrors.html</ulink> and -<command>cd</command> to the directory containing the latest release. -</para> - -<para>If you want the development tools and the programs necessary to -run the GNU configure mechanism, you should download the full binary -release called <filename>full.exe</filename>. If you only care -about the user tools listed above, download -<filename>usertools.exe</filename> instead.</para> - -<para>If you have an unreliable connection, download the appropriate -binary in smaller chunks instead. For the split full installer, get -the files in the `full-split' subdirectory. Once downloaded, -combine the split files at the command prompt by doing a:</para> - -<screen> -<prompt>C:\Cygnus\></prompt><userinput>copy /b xaa + xab + xac + ... + xak + xal full.exe</userinput> -<prompt>C:\Cygnus\></prompt><userinput>del xa*.*</userinput> -</screen> - -<para>A similar process can be used for the user tools.</para> - -<para>Once you have installed the executable on your system, run -it. First off, the installer will prompt you for a location to extract -the temporary files it needs to install the release on your -system. The default should be fine for most people.</para> - -<para>Next it will ask you to choose an install location. The default is -<filename><replaceable>system-drive</replaceable>:\cygnus\cygwin-b20</filename>. -Feel free to choose another location if you would prefer.</para> - -<para>Finally, it will ask you for the name of the Program Files -folder shortcut to add. By default, the installer will create a -`Cygwin B20' entry in a folder called `Cygnus Solutions'. When this -step is completed, it will install the tools and exit.</para> - -<para>If you should ever want to uninstall the tools, you may do so -via the "Add/Remove Programs" control panel.</para> - -<para> At this point you should be able to look under the start menu and -select "Cygwin Beta 20" (or whatever you named it). This will pop up a bash -shell with special environment variables set up for you. If you are running -Windows 95 or 98 and are faced with the error message "Out of environment -space", you need to increase the amount of environment space. Adding the -line <command>shell=C:\command.com /e:4096 /p</command> to the file -<filename>C:\CONFIG.SYS</filename> and then rebooting should do the trick if -<filename>C:</filename> is your system drive letter.</para> - -<para>If you want to install the sources follow the -instructions in the next section, else go directly to -<Xref LinkEnd="setup-dir"> to complete your system setup.</para> - -</sect1> -<sect1 id="installing-source"><title>Installing the source code</title> - -<para>Before downloading the source code corresponding to the release, -you should install the latest release of the tools (either the full -release or just the user tools).</para> - -<para>Create the directory that will house the source code. -<command>cd</command> there.</para> - -<para>Connect to one of the ftp servers listed above and -<command>cd</command> to the directory containing the latest release. -</para> - -<para>The source code is split into two units: user tools and development -tools. If you want the user tools source code, <command>cd</command> into -the <filename>user-src-split</filename> subdirectory. Download the files -there. If you want the development tools sources, <command>cd</command> -into the <filename>dev-src-split</filename> subdirectory. Download the -files there.</para> - -<para>Back in the Windows command shell, for the user tools -source:</para> - -<screen> -<prompt>C:\Cygnus\></prompt> <userinput>copy /b xba + xbb + xbc + xbd + xbe + xbf + xbg user-src.tar.bz2</userinput> -<prompt>C:\Cygnus\></prompt> <userinput>del xb*.*</userinput> -<prompt>C:\Cygnus\></prompt> <userinput>bunzip2 user-src.tar.bz2</userinput> -<prompt>C:\Cygnus\></prompt> <userinput>tar xvf user-src.tar</userinput> -</screen> - -<para>For the development tools source:</para> - -<screen> -<prompt>C:\Cygnus\></prompt> <userinput>copy /b xca + xcb + xcc + xcd + ... + xck + xcl dev-src.tar.bz2</userinput> -<prompt>C:\Cygnus\></prompt> <userinput>del xc*.*</userinput> -<prompt>C:\Cygnus\></prompt> <userinput>bunzip2 dev-src.tar.bz2</userinput> -<prompt>C:\Cygnus\></prompt> <userinput>tar xvf dev-src.tar</userinput> -</screen> - -<para>Both will expand into a directory called -<filename>src</filename>.</para> - -<para>Note: if you want the sources corresponding to everything in the -full.exe binary installer, you will need to download and expand both -the <filename>user-src.tar.bz2</filename> and -<filename>dev-src.tar.bz2</filename> source archives!</para> +<sect1><title>Internet Setup</title> +<para>To install the Cygwin net release, go to <ulink +URL="http://cygwin.com/">http://cygwin.com/</ulink> and click on <ulink +URL="http://cygwin.com/">"Install Cygwin Now!"</ulink>. This will +download a GUI installer called <command>setup.exe</command> which can +be run to download a complete cygwin installation via the internet. +Follow the instructions on each screen to install Cygwin.</para> </sect1> -DOCTOOL-INSERT-setup-dir DOCTOOL-INSERT-setup-env DOCTOOL-INSERT-ntsec DOCTOOL-INSERT-setup-files |