import winsup-2000-02-17 snapshot

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\&gt;</prompt><userinput>copy /b xaa + xab + xac + ... + xak + xal full.exe</userinput>
+<prompt>C:\Cygnus\&gt;</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\&gt;</prompt> <userinput>copy /b xba + xbb + xbc + xbd + xbe + xbf + xbg user-src.tar.bz2</userinput>
+<prompt>C:\Cygnus\&gt;</prompt> <userinput>del xb*.*</userinput>
+<prompt>C:\Cygnus\&gt;</prompt> <userinput>bunzip2 user-src.tar.bz2</userinput>
+<prompt>C:\Cygnus\&gt;</prompt> <userinput>tar xvf user-src.tar</userinput>
+</screen>
+
+<para>For the development tools source:</para>
+
+<screen>
+<prompt>C:\Cygnus\&gt;</prompt> <userinput>copy /b xca + xcb + xcc + xcd + ... + xck + xcl dev-src.tar.bz2</userinput>
+<prompt>C:\Cygnus\&gt;</prompt> <userinput>del xc*.*</userinput>
+<prompt>C:\Cygnus\&gt;</prompt> <userinput>bunzip2 dev-src.tar.bz2</userinput>
+<prompt>C:\Cygnus\&gt;</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>