diff options
Diffstat (limited to 'winsup/doc/setup-net.sgml')
| -rw-r--r-- | winsup/doc/setup-net.sgml | 131 |
1 files changed, 131 insertions, 0 deletions
diff --git a/winsup/doc/setup-net.sgml b/winsup/doc/setup-net.sgml new file mode 100644 index 000000000..184233026 --- /dev/null +++ b/winsup/doc/setup-net.sgml @@ -0,0 +1,131 @@ +<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><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><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> + +DOCTOOL-INSERT-setup-dir +DOCTOOL-INSERT-setup-env +DOCTOOL-INSERT-setup-files +</chapter> |