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

Cleanup copyrights and Cygnus'isms throughout. 

* setup.sgml: Nuke ancient instructions.
This commit is contained in:
Christopher Faylor 2001-12-04 04:20:31 +00:00
parent 8adfbe93d9
commit 63928f6088
19 changed files with 122 additions and 434 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
winsup/doc/ChangeLog
View File

@ -1,3 +1,8 @@
2001-12-03 Christopher Faylor <cgf@redhat.com>
Cleanup copyrights and Cygnus'isms throughout.
* setup.sgml: Nuke ancient instructions.
Tue Oct 16 18:02:00 2001 Corinna Vinschen <corinna@vinschen.de>
* pathnames.sgml: Cleanup raw device text to be more coherent.

2
winsup/doc/Makefile.in
View File

@ -1,5 +1,5 @@
# -*- Makefile -*- for winsup/doc
# Copyright (c) 1998-2000 Cygnus Solutions.
# Copyright (c) 1998-2000,2001 Red Hat, Inc.
#
# This file is part of Cygwin.
#

35
winsup/doc/configure vendored
View File

@ -28,7 +28,6 @@ program_suffix=NONE
program_transform_name=s,x,x,
silent=
site=
sitefile=
srcdir=
target=NONE
verbose=
@ -143,7 +142,6 @@ Configuration:
--help print this message
--no-create do not create output files
--quiet, --silent do not print \`checking...' messages
--site-file=FILE use FILE as the site file
--version print the version of autoconf that created configure
Directory and file names:
--prefix=PREFIX install architecture-independent files in PREFIX
@ -314,11 +312,6 @@ EOF
-site=* | --site=* | --sit=*)
site="$ac_optarg" ;;
-site-file | --site-file | --site-fil | --site-fi | --site-f)
ac_prev=sitefile ;;
-site-file=* | --site-file=* | --site-fil=* | --site-fi=* | --site-f=*)
sitefile="$ac_optarg" ;;
-srcdir | --srcdir | --srcdi | --srcd | --src | --sr)
ac_prev=srcdir ;;
-srcdir=* | --srcdir=* | --srcdi=* | --srcd=* | --src=* | --sr=*)
@ -484,16 +477,12 @@ fi
srcdir=`echo "${srcdir}" | sed 's%\([^/]\)/*$%\1%'`
# Prefer explicitly selected file to automatically selected ones.
if test -z "$sitefile"; then
if test -z "$CONFIG_SITE"; then
if test "x$prefix" != xNONE; then
CONFIG_SITE="$prefix/share/config.site $prefix/etc/config.site"
else
CONFIG_SITE="$ac_default_prefix/share/config.site $ac_default_prefix/etc/config.site"
fi
if test -z "$CONFIG_SITE"; then
if test "x$prefix" != xNONE; then
CONFIG_SITE="$prefix/share/config.site $prefix/etc/config.site"
else
CONFIG_SITE="$ac_default_prefix/share/config.site $ac_default_prefix/etc/config.site"
fi
else
CONFIG_SITE="$sitefile"
fi
for ac_site_file in $CONFIG_SITE; do
if test -r "$ac_site_file"; then
@ -582,7 +571,7 @@ else { echo "configure: error: can not run $ac_config_sub" 1>&2; exit 1; }
fi
echo $ac_n "checking host system type""... $ac_c" 1>&6
echo "configure:586: checking host system type" >&5
echo "configure:575: checking host system type" >&5
host_alias=$host
case "$host_alias" in
@ -603,7 +592,7 @@ host_os=`echo $host | sed 's/^\([^-]*\)-\([^-]*\)-\(.*\)$/\3/'`
echo "$ac_t""$host" 1>&6
echo $ac_n "checking target system type""... $ac_c" 1>&6
echo "configure:607: checking target system type" >&5
echo "configure:596: checking target system type" >&5
target_alias=$target
case "$target_alias" in
@ -621,7 +610,7 @@ target_os=`echo $target | sed 's/^\([^-]*\)-\([^-]*\)-\(.*\)$/\3/'`
echo "$ac_t""$target" 1>&6
echo $ac_n "checking build system type""... $ac_c" 1>&6
echo "configure:625: checking build system type" >&5
echo "configure:614: checking build system type" >&5
build_alias=$build
case "$build_alias" in
@ -653,7 +642,7 @@ fi
# Extract the first word of "${ac_tool_prefix}gcc", so it can be a program name with args.
set dummy ${ac_tool_prefix}gcc; ac_word=$2
echo $ac_n "checking for $ac_word""... $ac_c" 1>&6
echo "configure:657: checking for $ac_word" >&5
echo "configure:646: checking for $ac_word" >&5
if eval "test \"`echo '$''{'ac_cv_prog_CC'+set}'`\" = set"; then
echo $ac_n "(cached) $ac_c" 1>&6
else
@ -685,7 +674,7 @@ if test -n "$ac_tool_prefix"; then
# Extract the first word of "gcc", so it can be a program name with args.
set dummy gcc; ac_word=$2
echo $ac_n "checking for $ac_word""... $ac_c" 1>&6
echo "configure:689: checking for $ac_word" >&5
echo "configure:678: checking for $ac_word" >&5
if eval "test \"`echo '$''{'ac_cv_prog_CC'+set}'`\" = set"; then
echo $ac_n "(cached) $ac_c" 1>&6
else
@ -721,7 +710,7 @@ if test -z "$CC"; then
# Extract the first word of "cc", so it can be a program name with args.
set dummy cc; ac_word=$2
echo $ac_n "checking for $ac_word""... $ac_c" 1>&6
echo "configure:725: checking for $ac_word" >&5
echo "configure:714: checking for $ac_word" >&5
if eval "test \"`echo '$''{'ac_cv_prog_CC'+set}'`\" = set"; then
echo $ac_n "(cached) $ac_c" 1>&6
else
@ -775,7 +764,7 @@ if test $ac_cv_prog_gcc = yes; then
ac_save_CFLAGS="$CFLAGS"
CFLAGS=
echo $ac_n "checking whether ${CC-cc} accepts -g""... $ac_c" 1>&6
echo "configure:779: checking whether ${CC-cc} accepts -g" >&5
echo "configure:768: checking whether ${CC-cc} accepts -g" >&5
if eval "test \"`echo '$''{'ac_cv_prog_cc_g'+set}'`\" = set"; then
echo $ac_n "(cached) $ac_c" 1>&6
else

2
winsup/doc/configure.in
View File

@ -1,5 +1,5 @@
dnl Autoconf configure script for winsup/regexp
dnl Copyright 1997 Cygnus Solutions.
dnl Copyright 1997,1998,1999,2000,2001 Red Hat, Inc.
dnl
dnl This file is part of Cygwin.
dnl

11
winsup/doc/cygwin-api.in.sgml
View File

@ -1,13 +1,12 @@
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
<!ENTITY cygnus-copyright "<YEAR>1998</YEAR><HOLDER>Cygnus
Solutions</HOLDER>">
<!ENTITY cygnus-copyright "<YEAR>1998</YEAR><HOLDER>Red Hat, Inc.</HOLDER>">
<!ENTITY cygnus-code-copyright "
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Copyright (C) 1998 Cygnus Solutions.
Copyright (C) 1998,2001 Red Hat, Inc.
This is copyrighted software that may only
be reproduced, modified, or distributed
under license from Cygnus Solutions.
under license from Red Hat, Inc.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
">
]>
@ -34,13 +33,13 @@ under license from Cygnus Solutions.
<revision>
<revnumber>0.0</revnumber>
<date>1998-08-31</date>
<authorinitials>dj@cygnus.com</authorinitials>
<authorinitials>dj</authorinitials>
<revremark>Initial revision</revremark>
</revision>
<revision>
<revnumber>0.5.0</revnumber>
<date>1998-12-17</date>
<authorinitials>noer@cygnus.com</authorinitials>
<authorinitials>noer</authorinitials>
<revremark>Add pthread, sem calls. Change revnumber to
three-part number: Cygwin API major, Cygwin API minor, Doc rev
number. Starts out at 0.5.0.</revremark>

20
winsup/doc/cygwin-ug-net.in.sgml
View File

@ -1,14 +1,14 @@
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
<!ENTITY cygnus-copyright
"<YEAR>1999</YEAR>
<HOLDER>Cygnus Solutions</HOLDER>">
"<YEAR>1999,2000,2001</YEAR>
<HOLDER>Red Hat, Inc.</HOLDER>">
<!ENTITY cygnus-code-copyright "
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Copyright (C) 1998, 1999 Cygnus Solutions.
Copyright (C) 1998, 1999,2000,2001 Red Hat, Inc.
This is copyrighted software that may only
be reproduced, modified, or distributed
under license from Cygnus Solutions.
under license from Red Hat, Inc.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
">
]>
@ -16,9 +16,17 @@ under license from Cygnus Solutions.
<book id="cygwin-ug-net">
<bookinfo>
<date>1999-02-08</date>
<date>2001-22-03</date>
<title>Cygwin User's Guide</title>
<authorgroup>
<author>
<firstname>Corinna</firstname>
<surname>Vinschen</surname>
</author>
<author>
<firstname>Christopher</firstname>
<surname>Faylor</surname>
</author>
<author>
<firstname>DJ</firstname>
<surname>Delorie</surname>
@ -39,7 +47,7 @@ DOCTOOL-INSERT-legal
<revision>
<revnumber>0.0</revnumber>
<date>1998-10-06</date>
<authorinitials>noer@cygnus.com</authorinitials>
<authorinitials>noer</authorinitials>
<revremark>Initial revision</revremark>
</revision>
<revision>

20
winsup/doc/cygwin-ug.in.sgml
View File

@ -1,13 +1,13 @@
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
<!ENTITY cygnus-copyright "<YEAR>1999</YEAR>
<HOLDER>Cygnus Solutions</HOLDER>">
<!ENTITY cygnus-copyright "<YEAR>1999,2000,2001</YEAR>
<HOLDER>Red Hat, Inc.</HOLDER>">
<!ENTITY cygnus-code-copyright "
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Copyright (C) 1998, 1999 Cygnus Solutions.
Copyright (C) 1998, 1999, 2000, 2001 Red Hat, Inc.
This is copyrighted software that may only
be reproduced, modified, or distributed
under license from Cygnus Solutions.
under license from Red Hat, Inc.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
">
]>
@ -15,9 +15,17 @@ under license from Cygnus Solutions.
<book id="cygwin-ug">
<bookinfo>
<date>1998-01-28</date>
<date>2001-22-03</date>
<title>Cygwin User's Guide</title>
<authorgroup>
<author>
<firstname>Corinna</firstname>
<surname>Vinschen</surname>
</author>
<author>
<firstname>Christopher</firstname>
<surname>Faylor</surname>
</author>
<author>
<firstname>DJ</firstname>
<surname>Delorie</surname>
@ -38,7 +46,7 @@ DOCTOOL-INSERT-legal
<revision>
<revnumber>0.0</revnumber>
<date>1998-08-31</date>
<authorinitials>dj@cygnus.com</authorinitials>
<authorinitials>dj</authorinitials>
<revremark>Initial revision</revremark>
</revision>
<revision>

2
winsup/doc/doctool.c
View File

@ -1,6 +1,6 @@
/* doctool.c
Copyright 1998 Cygnus Solutions.
Copyright 1998,1999,2000,2001 Red Hat, Inc.
This file is part of Cygwin.

6
winsup/doc/gcc.sgml
View File

@ -9,11 +9,11 @@ options. Here's a simple example:</para>
<example>
<title>Building Hello World with GCC</title>
<screen>
<prompt>C:\cygnus\&gt;</prompt> <userinput>gcc hello.c -o hello.exe</userinput>
<prompt>C:\cygnus\&gt;</prompt> <userinput>hello.exe</userinput>
<prompt>C:\&gt;</prompt> <userinput>gcc hello.c -o hello.exe</userinput>
<prompt>C:\&gt;</prompt> <userinput>hello.exe</userinput>
Hello, World
<prompt>C:\cygnus\&gt;</prompt>
<prompt>C:\&gt;</prompt>
</screen>
</example>

2
winsup/doc/history.texinfo
View File

@ -298,7 +298,7 @@ Under NT only, utilities mkpasswd and mkgroup can generate a valid
/etc/passwd and /etc/group.
Earlier releases stored mount points in the registry under
"Cygnus Support". This changed to "Cygnus Solutions" starting
"Cygnus Support". This changed to "Red Hat, Inc." starting
with beta 18. Either use a registry editor (regedit under NT)
to rename the old entry or just redo your mount points and the
cygwin.dll will automatically create the new one for you.

2
winsup/doc/how-using.texinfo
View File

@ -461,7 +461,7 @@ you should have better luck.
If you are trying to umount '/' and are getting this message, you may
need to run @code{regedit.exe} and change the "native" key for the '/'
mount in one of the mount points kept under
HKEY_CURRENT_USER/Software/Cygnus Solutions/CYGWIN.DLL setup/<version>
HKEY_CURRENT_USER/Software/Red Hat, Inc./CYGWIN.DLL setup/<version>
where <version> is the latest registry version associated with the
Cygwin library.

2
winsup/doc/install.texinfo
View File

@ -218,7 +218,7 @@ manually:
@itemize @bullet
@item Cygwin shortcuts on the Desktop and Start Menu
@item The registry tree @samp{Software\Cygnus Solutions} under
@item The registry tree @samp{Software\Red Hat, Inc.} under
@code{HKEY_LOCAL_MACHINE} and/or @code{HKEY_CURRENT_USER}.
@item Anything under the Cygwin root folder, @samp{C:\cygwin} by

12
winsup/doc/legal.sgml
View File

@ -1,11 +1,11 @@
<LegalNotice id="legal">
<Para>Copyright &copy; 1998,1999 Cygnus Solutions.</Para>
<Para>Copyright &copy; 1998,1999,2000,2001 Red Hat, Inc.</Para>
<!--
<Para>GNUPro&trade;, the GNUPro&trade; logo, and the Cygnus Solutions
logo are trademarks of Cygnus Solutions. All other brand and product
<Para>GNUPro&trade;, the GNUPro&trade; logo, and the Red Hat
logo are trademarks of Red Hat, Inc. All other brand and product
names are trademarks of their respective owners.</Para>
<Para>Permission is granted to make and distribute verbatim copies of
@ -23,10 +23,8 @@ for modified versions, except that this permission notice may be
stated in a translation approved by the Free Software
Foundation.</Para>
<Para>This documentation has been prepared by Cygnus Solutions
Technical Publications; to contact the Cygnus Solutions Technical
Publications staff, email: <Email>doc@cygnus.com</Email>.</Para>
<Para>This documentation has been prepared by Red Hat, Inc.
Technical Publications.</para>
-->
</LegalNotice>

13
winsup/doc/overview.sgml
View File

@ -24,17 +24,18 @@ from the bash shell (provided) or from the command.com.</para>
<para>Yes. Parts are GNU software (gcc, gas, ld, etc...), parts are
covered by the standard X11 license, some of it is public domain,
some of it was written by Cygnus and placed under the GPL. None of it
some of it was written by Red Hat and placed under the GPL. None of it
is shareware. You don't have to pay anyone to use it but you should be
sure to read the copyright section of the FAQ more more information on
how the GNU General Public License may affect your use of these
tools. If you intend to port a proprietary application using the Cygwin
library, you may want the Cygwin proprietary-use license.
For more information about the
proprietary-use license, please contact sales@cygnus.com. Customers of
the native Win32 GNUPro should feel free to submit bug reports and ask
questions through the normal channels. All other questions should be
sent to the project mailing list cygwin@sourceware.cygnus.com.</para>
For more information about the proprietary-use license, please go to
<ulink URL="http://cygwin.com/cygwin-redhat.com">http://cygwin.com/cygwin-redhat.com
</ulink>. Customers of the native Win32 GNUPro should feel free to submit bug
reports and ask questions through the normal channels. All other
questions should be sent to the project mailing list
<email>cygwin@cygwin.com</email>.</para>
</sect1>

5
winsup/doc/overview2.sgml
View File

@ -164,7 +164,7 @@ backslashes) and CIFS paths (//server/share or \\server\share) as well.</para>
<sect2 id="ov-hi-textvsbinary"><title>Text Mode vs. Binary Mode</title>
<para>Interoperability with other Win32 programs such as text editors was
critical to the success of the port of the development tools. Most Cygnus
critical to the success of the port of the development tools. Most Red Hat
customers upgrading from the older DOS-hosted toolchains expected the new
Win32-hosted ones to continue to work with their old development
sources.</para>
@ -184,8 +184,7 @@ set to override this behavior.</para>
</sect2>
<sect2 id="ov-hi-ansiclib"><title>ANSI C Library</title>
<para>We chose to include
Cygnus' own existing ANSI C library
<para>We chose to include Red Hat's own existing ANSI C library
"newlib" as part of the library, rather than write all of the lib C
and math calls from scratch. Newlib is a BSD-derived ANSI C library,
previously only used by cross-compilers for embedded systems

74
winsup/doc/pathnames.sgml
View File

@ -42,7 +42,7 @@ the appropriate priviledges (Administrator priviledges in Windows
NT).</para>
<para>The current user's table is located under
"HKEY_CURRENT_USER/Software/Cygnus Solutions/Cygwin/mounts
"HKEY_CURRENT_USER/Software/Red Hat, Inc./Cygwin/mounts
v&lt;version&gt;"
where &lt;version&gt; is the latest registry version associated with
the Cygwin library (this version is not the same as the release
@ -70,10 +70,13 @@ to the current user.</para>
<example>
<title>Displaying the current set of mount points</title>
<screen>
<prompt>c:\cygnus\&gt;</prompt> <userinput>mount</userinput>
Device Directory Type Flags
D: /d user textmode
C: / system textmode
<prompt>c:\&gt;</prompt> <userinput>mount</userinput>
f:\cygwin\bin on /usr/bin type system (binmode)
f:\cygwin\lib on /usr/lib type system (binmode)
f:\cygwin on / type system (binmode)
e:\src on /usr/src type system (binmode)
c: on /cygdrive/c type user (binmode,noumount)
e: on /cygdrive/e type user (binmode,noumount)
</screen>
</example>
@ -102,43 +105,6 @@ information on text and binary modes.</para>
</sect2>
<sect2><title>Cygwin Mount Table Strategies</title>
<para>Which set of mounts is right for a given Cygwin user depends
largely on how closely you want to simulate a POSIX environment,
whether you mix Windows and Cygwin programs, and how many drive
letters you are using. If you want to be very POSIX-like (assuming
"CygwinRoot" is the top directory of your Cygwin distribution), you may
want to do something like this:</para>
<example><title>POSIX-like mount setup</title>
<screen>
<prompt>C:\&gt;</prompt> <userinput>mount c:\Cygnus\CygwinRoot /</userinput>
<prompt>C:\&gt;</prompt> <userinput>mount c:\ /c</userinput>
<prompt>C:\&gt;</prompt> <userinput>mount d:\ /d</userinput>
<prompt>C:\&gt;</prompt> <userinput>mount e:\ /cdrom</userinput>
</screen>
</example>
<para>However, if you mix Windows and Cygwin programs a lot, you might
want to create an "identity" mapping, so that conversions between the
two (see <Xref Linkend="cygpath">) can be eliminated:</para>
<example><title>Identity mount setup</title>
<screen>
<prompt>C:\&gt;</prompt> <userinput>mount c:\ /</userinput>
<prompt>C:\&gt;</prompt> <userinput>mount d:\foo /foo</userinput>
<prompt>C:\&gt;</prompt> <userinput>mount d:\bar /bar</userinput>
<prompt>C:\&gt;</prompt> <userinput>mount e:\grill /grill</userinput>
</screen>
</example>
<para>You'd have to repeat this for all top-level subdirectories on
all drives, but then you'd always have the top-level directories
available as the same names in both systems.</para>
</sect2>
<sect2><title>Additional Path-related Information</title>
<para>The <command>cygpath</command> program provides the ability to
@ -147,10 +113,10 @@ translate between Win32 and POSIX pathnames in shell scripts. See
<para>The <EnVar>HOME</EnVar>, <EnVar>PATH</EnVar>, and
<EnVar>LD_LIBRARY_PATH</EnVar> environment variables are automatically
converted from Win32 format to POSIX format (e.g. from
<filename>C:\cygnus\cygwin-b20\H-i586-cygwin32\bin</filename> to
<filename>/bin</filename>, if there was a mount from that Win32 path to
that POSIX path) when a Cygwin process first starts.</para>
converted from Win32 format to POSIX format (e.g. from
<filename>c:\cygwin\bin</filename> to <filename>/bin</filename>, if
there was a mount from that Win32 path to that POSIX path) when a Cygwin
process first starts.</para>
<para>Symbolic links can also be used to map Win32 pathnames to POSIX.
For example, the command
@ -339,11 +305,11 @@ does not. In the same situation the function call
<filename>filename.exe</filename>. The two files can be distinguished
by examining their inodes, as demonstrated below.
<screen>
<prompt>C:\Cygnus\&gt;</prompt> <userinput>ls * </userinput>
<prompt>C:\&gt;</prompt> <userinput>ls * </userinput>
a a.exe b.exe
<prompt>C:\Cygnus\&gt;</prompt> <userinput>ls -i a a.exe</userinput>
<prompt>C:\&gt;</prompt> <userinput>ls -i a a.exe</userinput>
445885548 a 435996602 a.exe
<prompt>C:\Cygnus\&gt;</prompt> <userinput>ls -i b b.exe</userinput>
<prompt>C:\&gt;</prompt> <userinput>ls -i b b.exe</userinput>
432961010 b 432961010 b.exe
</screen>
If a shell script <filename>myprog</filename> and a program
@ -381,13 +347,13 @@ In the following example compare the behaviors of the bash built-in
<example><title> Using @pathname</title>
<screen>
<prompt>/Cygnus$</prompt> <userinput>echo 'This is "a long" line' > mylist</userinput>
<prompt>/Cygnus$</prompt> <userinput>echo @mylist</userinput>
<prompt>bash$</prompt> <userinput>echo 'This is "a long" line' > mylist</userinput>
<prompt>bash$</prompt> <userinput>echo @mylist</userinput>
@mylist
<prompt>/Cygnus$</prompt> <userinput>/bin/echo @mylist</userinput>
<prompt>bash$</prompt> <userinput>/bin/echo @mylist</userinput>
This is a long line
<prompt>/Cygnus$</prompt> <userinput>rm mylist</userinput>
<prompt>/Cygnus$</prompt> <userinput>/bin/echo @mylist</userinput>
<prompt>bash$</prompt> <userinput>rm mylist</userinput>
<prompt>bash$</prompt> <userinput>/bin/echo @mylist</userinput>
@mylist
</screen>
</example>

131
winsup/doc/setup-net.sgml
View File

@ -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\&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 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\&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><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

208
winsup/doc/setup2.sgml
View File

@ -1,173 +1,22 @@
<sect1 id="setup-dir"><title>Directory Structure</title>
<para>
Cygwin knows how to emulate a standard UNIX directory structure, to
some extent. This is done through the use of mount tables that map
Win32 paths to POSIX ones. The mount table may be set up and modified
with the <command>mount</command> command. This section explains how
to properly organize the structure. </para>
<para> When you set up the system you should decide where you want the
root to be mapped. Possible choices are the root of your Windows
system, such as
<filename>c:</filename> or a directory such as
<filename>c:\progra~1\root</filename>.
</para>
<para>
Execute the following commands inside bash as it is difficult to
change the position of the root from the Windows command prompt.
Changing the mount points may invalidate <EnVar>PATH</EnVar>, if this
happens simply exit and relaunch bash. Create the directory if
needed, then <command>umount /</command> the current root and
<command>mount</command> it in its new place. You also have to decide if
you want to use text or binary mode.
</para>
<para>
Next, create the traditional main UNIX directories, with
the following command (in some shells it is necessary to issue
separate <command>mkdir</command> commands, each with a single
argument).
</para>
<screen>
<prompt>/$</prompt> <userinput>mkdir /tmp /bin /etc /var /usr</userinput>
</screen>
<para>
Next we will initialize the content of these directories.
</para>
<para>
You should make sure that you always have a valid
<filename>/tmp</filename> directory. If you want to avoid creating a
real <filename>/tmp</filename>, you can use the
<command>mount</command> utility to point <filename>/tmp</filename> to
another directory, such as <filename>c:\tmp</filename>, or create a
symbolic link <filename>/tmp</filename> to point to such a directory.
</para>
<para>
The <filename>/bin</filename> directory should contain the shell
<filename>sh.exe</filename>. You have three choices. The first is to
copy this program from the Cygnus <filename>bin</filename> directory.
The second is to use <command>mount</command> to mount the Cygnus
<filename>bin</filename> directory to <filename>/bin</filename> (the
advantage of this approach is that your <envar>PATH</envar> will be
shorter inside bash). The third is to make <filename>/bin</filename> a
symbolic link to the Cygnus <filename>bin</filename> directory.
</para>
<para>
Note that Cygwin comes with two shells: <command>bash.exe</command> and
<command>sh.exe</command>, which is based on <command>ash</command>. The
system is faster when <command>ash</command> is used as the
non-interactive shell.
The only functionality supported in <command>ash</command> is that
of the traditional <command>sh</command>.
In case of trouble with <command>ash</command> make
<command>sh.exe</command> point to <command>bash.exe</command>.
</para>
<para>
We now turn to <filename>/etc</filename>. You may want to copy in it
the <filename>termcap</filename> file from the Cygnus
<filename>etc</filename> directory, although the defaults built into
the programs suffice for the normal console. You may also use
<command>mount</command> or create as symbolic link to the Cygnus
<filename>etc</filename>, just as for <filename>/bin</filename>
above.
</para>
<para> Under Windows NT, if you want to create
<filename>/etc/passwd</filename> and <filename>/etc/group</filename>
(i.e. so that <command>whoami</command> works and
<command>ls -l</command> replaces the UID with a name) based on the accounts local to the machine, just do this:
</para>
<screen>
<prompt>/$</prompt> <userinput>cd /etc</userinput>
<prompt>/etc$</prompt> <userinput>mkpasswd -l > /etc/passwd</userinput>
<prompt>/etc$</prompt> <userinput>mkgroup -l > /etc/group</userinput>
</screen>
<para>If you are logging in based on an NT network domain, and want to
also create entries in <filename>/etc/passwd</filename> and
<filename>/etc/group</filename> based on all the accounts in the
domain, then after creating local entries do this:
</para>
<screen>
<prompt>/$</prompt> <userinput>cd /etc</userinput>
<prompt>/etc$</prompt> <userinput>mkpasswd -d >> /etc/passwd</userinput>
<prompt>/etc$</prompt> <userinput>mkgroup -d >> /etc/group</userinput>
</screen>
<para>Alternatively, to add only your account to the passwd file,
assuming your NT name is "my_ntusername", instead of the above
<command>mkpasswd</command> you should do:
</para>
<screen>
<prompt>/$</prompt> <userinput>cd /etc</userinput>
<prompt>/etc$</prompt> <userinput>mkpasswd -d | grep my_ntusername >> /etc/passwd</userinput>
</screen>
<para> Future changes to your NT registry or network domain will NOT be reflected in
<filename>/etc/passwd</filename> or <filename>/etc/group </filename> after
this so you may want to regenerate these files periodically. Under Windows
9x, you can create and edit these files with a text editor. </para>
<para>
The <command>who</command> command requires the
<filename>/var/run/utmp</filename> to exist.
Create it if you wish.
The system also logs information in <filename>/var/log/wtmp</filename>,
if it exists.
</para>
<para>
The <filename>/usr</filename> directory is not used by the Cygwin
system but it is a standard place to install optional packages.
</para>
<para>
You may also want to mount directories such as <filename>/a</filename>
and <filename>/d</filename> to refer to your local and network drives.
</para>
<para>
You do not need to create <filename>/dev</filename> in order to set up
mounts for devices such as <filename>/dev/null</filename> as these
are already automatically simulated inside the Cygwin library.
</para>
</sect1>
<sect1 id="setup-env"><title>Environment Variables</title>
<para>
Before starting bash, you must set some environment variables, some of
which can also be set or modified inside bash. Cygnus provides you
with a .bat file where the most important ones are set before bash in
Before starting bash, you may set some environment variables. A .bat
file is provided where the most important ones are set before bash in
launched. This is the safest way to launch bash initially. The .bat
file is installed by default in
<filename>\cygnus\cygwin-b20/cygnus.bat</filename> and pointed to in
the Start Menu. You can edit it to your liking.
</para>
file is installed in the root directory that you specified during setup
and pointed to in the Start Menu under the "Cygwin" option. You can
edit it this file your liking.</para>
<para>
The <envar>CYGWIN</envar> variable is used to configure many global
settings for the Cygwin
runtime system. Initially you can leave <envar>CYGWIN</envar> unset
or set it to <literal>tty</literal> (e.g. to support job control with ^Z
etc...) using a syntax like this in the DOS shell, before launching bash.
</para>
settings for the Cygwin runtime system. Initially you can leave
<envar>CYGWIN</envar> unset or set it to <literal>tty</literal> (e.g.
to support job control with ^Z etc...) using a syntax like this in the
DOS shell, before launching bash. </para>
<screen>
<prompt>C:\Cygnus\&gt;</prompt> <userinput>set CYGWIN=tty notitle glob</userinput>
<prompt>C:\&gt;</prompt> <userinput>set CYGWIN=tty notitle glob</userinput>
</screen>
<para>
@ -177,10 +26,9 @@ to run. This environment variable is converted from Windows format
(e.g. <filename>C:\WinNT\system32;C:\WinNT</filename>) to UNIX format
(e.g., <filename>/WinNT/system32:/WinNT</filename>) when a Cygwin
process first starts.
Set it so that it contains at least the Cygnus
<filename>bin</filename> directory
<filename>C:\cygnus\cygwin-b20\H-i586-cygwin32\bin</filename> before
launching bash.
Set it so that it contains at least the <filename>x:\cygwin\bin</filename>
directory where "<filename>x:\cygwin</filename> is the "root" of your
cygwin installation if you wish to use cygwin tools outside of bash.
</para>
<para>
@ -191,33 +39,17 @@ when a Cygwin process first starts. Set it to point to your home directory
before launching bash.
</para>
<para>
<command>make</command> uses an environment variable
<envar>MAKE_MODE</envar> to decide if it uses
<filename>command.com</filename> or <filename>/bin/sh</filename> to
run command lines. If you are getting strange errors from
<command>make</command> about "/c not found", set
<envar>MAKE_MODE</envar> to <literal>UNIX</literal> at the command
prompt or in bash.
</para>
<screen>
<prompt>C:\Cygnus\&gt;</prompt> <userinput>set MAKE_MODE=UNIX</userinput>
<prompt>/Cygnus$</prompt> <userinput>export MAKE_MODE=UNIX</userinput>
</screen>
<para>
The <envar>TERM</envar> environment variable specifies your terminal
type. You can set it to <literal>cygwin</literal>.
type. It is automatically set to <literal>cygwin</literal> if you have
not set it to something else.
</para>
<para>The <envar>LD_LIBRARY_PATH</envar> environment variable is
used by the Cygwin function <function>dlopen ()</function> as a list
of directories to search for .dll files to load. This environment
variable is converted from Windows format to UNIX format
when a Cygwin process first starts.
Most Cygwin applications do not make use of the
<para>The <envar>LD_LIBRARY_PATH</envar> environment variable is used by
the Cygwin function <function>dlopen ()</function> as a list of
directories to search for .dll files to load. This environment variable
is converted from Windows format to UNIX format when a Cygwin process
first starts. Most Cygwin applications do not make use of the
<function>dlopen ()</function> call and do not need this variable.
</para>

2
winsup/doc/textbinary.sgml
View File

@ -127,7 +127,7 @@ In the second case we rely on the DOS shell to redirect in binary mode.
<para>UNIX programs that have been written for maximum portability
will know the difference between text and binary files and act
appropriately under Cygwin. For those programs, the text mode default
is a good choice. Programs included in official Cygnus distributions
is a good choice. Programs included in official Cygwin distributions
should work well in the default mode. </para>
<para>Text mode makes it much easier to mix files between Cygwin and