From 63928f6088d7f44f4f8d3962aff68891071a2fb6 Mon Sep 17 00:00:00 2001 From: Christopher Faylor Date: Tue, 4 Dec 2001 04:20:31 +0000 Subject: Cleanup copyrights and Cygnus'isms throughout. * setup.sgml: Nuke ancient instructions. --- winsup/doc/ChangeLog | 5 + winsup/doc/Makefile.in | 2 +- winsup/doc/configure | 35 +++---- winsup/doc/configure.in | 2 +- winsup/doc/cygwin-api.in.sgml | 11 +- winsup/doc/cygwin-ug-net.in.sgml | 20 ++-- winsup/doc/cygwin-ug.in.sgml | 20 ++-- winsup/doc/doctool.c | 2 +- winsup/doc/gcc.sgml | 6 +- winsup/doc/history.texinfo | 2 +- winsup/doc/how-using.texinfo | 2 +- winsup/doc/install.texinfo | 2 +- winsup/doc/legal.sgml | 12 +-- winsup/doc/overview.sgml | 13 +-- winsup/doc/overview2.sgml | 5 +- winsup/doc/pathnames.sgml | 74 ++++---------- winsup/doc/setup-net.sgml | 131 ++---------------------- winsup/doc/setup2.sgml | 210 ++++----------------------------------- winsup/doc/textbinary.sgml | 2 +- 19 files changed, 122 insertions(+), 434 deletions(-) (limited to 'winsup/doc') diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index b53588ffc..46c13bad4 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,8 @@ +2001-12-03 Christopher Faylor + + Cleanup copyrights and Cygnus'isms throughout. + * setup.sgml: Nuke ancient instructions. + Tue Oct 16 18:02:00 2001 Corinna Vinschen * pathnames.sgml: Cleanup raw device text to be more coherent. diff --git a/winsup/doc/Makefile.in b/winsup/doc/Makefile.in index 9e9a7266b..198e9ca3f 100644 --- a/winsup/doc/Makefile.in +++ b/winsup/doc/Makefile.in @@ -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. # diff --git a/winsup/doc/configure b/winsup/doc/configure index 09d5a070c..eea87df57 100755 --- a/winsup/doc/configure +++ b/winsup/doc/configure @@ -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 diff --git a/winsup/doc/configure.in b/winsup/doc/configure.in index a51a474a9..503777724 100644 --- a/winsup/doc/configure.in +++ b/winsup/doc/configure.in @@ -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 diff --git a/winsup/doc/cygwin-api.in.sgml b/winsup/doc/cygwin-api.in.sgml index 13d7f8c2f..06baf5247 100644 --- a/winsup/doc/cygwin-api.in.sgml +++ b/winsup/doc/cygwin-api.in.sgml @@ -1,13 +1,12 @@ 1998Cygnus - Solutions"> + 1998Red Hat, Inc."> ]> @@ -34,13 +33,13 @@ under license from Cygnus Solutions. 0.0 1998-08-31 - dj@cygnus.com + dj Initial revision 0.5.0 1998-12-17 - noer@cygnus.com + noer 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. diff --git a/winsup/doc/cygwin-ug-net.in.sgml b/winsup/doc/cygwin-ug-net.in.sgml index 633689631..41e876f22 100644 --- a/winsup/doc/cygwin-ug-net.in.sgml +++ b/winsup/doc/cygwin-ug-net.in.sgml @@ -1,14 +1,14 @@ 1999 - Cygnus Solutions"> + "1999,2000,2001 + Red Hat, Inc."> ]> @@ -16,9 +16,17 @@ under license from Cygnus Solutions. - 1999-02-08 + 2001-22-03 Cygwin User's Guide + + Corinna + Vinschen + + + Christopher + Faylor + DJ Delorie @@ -39,7 +47,7 @@ DOCTOOL-INSERT-legal 0.0 1998-10-06 - noer@cygnus.com + noer Initial revision diff --git a/winsup/doc/cygwin-ug.in.sgml b/winsup/doc/cygwin-ug.in.sgml index 3a7371a88..91054f324 100644 --- a/winsup/doc/cygwin-ug.in.sgml +++ b/winsup/doc/cygwin-ug.in.sgml @@ -1,13 +1,13 @@ 1999 - Cygnus Solutions"> + 1999,2000,2001 + Red Hat, Inc."> ]> @@ -15,9 +15,17 @@ under license from Cygnus Solutions. - 1998-01-28 + 2001-22-03 Cygwin User's Guide + + Corinna + Vinschen + + + Christopher + Faylor + DJ Delorie @@ -38,7 +46,7 @@ DOCTOOL-INSERT-legal 0.0 1998-08-31 - dj@cygnus.com + dj Initial revision diff --git a/winsup/doc/doctool.c b/winsup/doc/doctool.c index 26e76669d..ae034f345 100644 --- a/winsup/doc/doctool.c +++ b/winsup/doc/doctool.c @@ -1,6 +1,6 @@ /* doctool.c - Copyright 1998 Cygnus Solutions. + Copyright 1998,1999,2000,2001 Red Hat, Inc. This file is part of Cygwin. diff --git a/winsup/doc/gcc.sgml b/winsup/doc/gcc.sgml index d13bba116..238babfa3 100644 --- a/winsup/doc/gcc.sgml +++ b/winsup/doc/gcc.sgml @@ -9,11 +9,11 @@ options. Here's a simple example: Building Hello World with GCC -C:\cygnus\> gcc hello.c -o hello.exe -C:\cygnus\> hello.exe +C:\> gcc hello.c -o hello.exe +C:\> hello.exe Hello, World -C:\cygnus\> +C:\> diff --git a/winsup/doc/history.texinfo b/winsup/doc/history.texinfo index f13be55fc..8856a70b8 100644 --- a/winsup/doc/history.texinfo +++ b/winsup/doc/history.texinfo @@ -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. diff --git a/winsup/doc/how-using.texinfo b/winsup/doc/how-using.texinfo index 15b092537..94504d05c 100644 --- a/winsup/doc/how-using.texinfo +++ b/winsup/doc/how-using.texinfo @@ -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/ +HKEY_CURRENT_USER/Software/Red Hat, Inc./CYGWIN.DLL setup/ where is the latest registry version associated with the Cygwin library. diff --git a/winsup/doc/install.texinfo b/winsup/doc/install.texinfo index 5e8c32787..39934f83c 100644 --- a/winsup/doc/install.texinfo +++ b/winsup/doc/install.texinfo @@ -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 diff --git a/winsup/doc/legal.sgml b/winsup/doc/legal.sgml index 721899c46..1190ecce1 100644 --- a/winsup/doc/legal.sgml +++ b/winsup/doc/legal.sgml @@ -1,11 +1,11 @@ -Copyright © 1998,1999 Cygnus Solutions. +Copyright © 1998,1999,2000,2001 Red Hat, Inc. diff --git a/winsup/doc/overview.sgml b/winsup/doc/overview.sgml index 4b48094aa..a69fcb55a 100644 --- a/winsup/doc/overview.sgml +++ b/winsup/doc/overview.sgml @@ -24,17 +24,18 @@ from the bash shell (provided) or from the command.com. 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. +For more information about the proprietary-use license, please go to +http://cygwin.com/cygwin-redhat.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@cygwin.com. diff --git a/winsup/doc/overview2.sgml b/winsup/doc/overview2.sgml index 4c8595dd5..755b4c42c 100644 --- a/winsup/doc/overview2.sgml +++ b/winsup/doc/overview2.sgml @@ -164,7 +164,7 @@ backslashes) and CIFS paths (//server/share or \\server\share) as well. Text Mode vs. Binary Mode 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. @@ -184,8 +184,7 @@ set to override this behavior. ANSI C Library -We chose to include -Cygnus' own existing ANSI C library +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 diff --git a/winsup/doc/pathnames.sgml b/winsup/doc/pathnames.sgml index 8dd8dcb78..00b216e92 100644 --- a/winsup/doc/pathnames.sgml +++ b/winsup/doc/pathnames.sgml @@ -42,7 +42,7 @@ the appropriate priviledges (Administrator priviledges in Windows NT). 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<version>" where <version> 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. Displaying the current set of mount points -c:\cygnus\> mount -Device Directory Type Flags -D: /d user textmode -C: / system textmode +c:\> mount +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) @@ -102,43 +105,6 @@ information on text and binary modes. -Cygwin Mount Table Strategies - -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: - -POSIX-like mount setup - -C:\> mount c:\Cygnus\CygwinRoot / -C:\> mount c:\ /c -C:\> mount d:\ /d -C:\> mount e:\ /cdrom - - - -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 ) can be eliminated: - -Identity mount setup - -C:\> mount c:\ / -C:\> mount d:\foo /foo -C:\> mount d:\bar /bar -C:\> mount e:\grill /grill - - - -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. - - - Additional Path-related Information The cygpath program provides the ability to @@ -147,10 +113,10 @@ translate between Win32 and POSIX pathnames in shell scripts. See The HOME, PATH, and LD_LIBRARY_PATH environment variables are automatically -converted from Win32 format to POSIX format (e.g. from -C:\cygnus\cygwin-b20\H-i586-cygwin32\bin to -/bin, if there was a mount from that Win32 path to -that POSIX path) when a Cygwin process first starts. +converted from Win32 format to POSIX format (e.g. from +c:\cygwin\bin to /bin, if +there was a mount from that Win32 path to that POSIX path) when a Cygwin +process first starts. 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.exe. The two files can be distinguished by examining their inodes, as demonstrated below. -C:\Cygnus\> ls * +C:\> ls * a a.exe b.exe -C:\Cygnus\> ls -i a a.exe +C:\> ls -i a a.exe 445885548 a 435996602 a.exe -C:\Cygnus\> ls -i b b.exe +C:\> ls -i b b.exe 432961010 b 432961010 b.exe If a shell script myprog and a program @@ -381,13 +347,13 @@ In the following example compare the behaviors of the bash built-in Using @pathname -/Cygnus$ echo 'This is "a long" line' > mylist -/Cygnus$ echo @mylist +bash$ echo 'This is "a long" line' > mylist +bash$ echo @mylist @mylist -/Cygnus$ /bin/echo @mylist +bash$ /bin/echo @mylist This is a long line -/Cygnus$ rm mylist -/Cygnus$ /bin/echo @mylist +bash$ rm mylist +bash$ /bin/echo @mylist @mylist 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 @@ Setting Up Cygwin -Cygwin Contents - -The following packages are included in the full release: - -Development tools: binutils, bison, byacc, dejagnu, diff, -expect, flex, gas, gcc, gdb, itcl, ld, libstdc++, make, patch, tcl, -tix, tk - -User tools: ash, bash, bzip2, diff, fileutils, findutils, gawk, -grep, gzip, less, m4, sed, shellutils, tar, textutils, time - -The user tools release only contains the user tools. - -Full source code is available for these tools. - - -Installing the binary release - -Important! Be sure to remove any older versions of the Cygwin -tools from your PATH environment variable so you do -not execute them by mistake. - -Connect to one of the ftp servers listed in - -http://sourceware.cygnus.com/cygwin/mirrors.html and -cd to the directory containing the latest release. - - -If you want the development tools and the programs necessary to -run the GNU configure mechanism, you should download the full binary -release called full.exe. If you only care -about the user tools listed above, download -usertools.exe instead. - -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: - - -C:\Cygnus\>copy /b xaa + xab + xac + ... + xak + xal full.exe -C:\Cygnus\>del xa*.* - - -A similar process can be used for the user tools. - -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. - -Next it will ask you to choose an install location. The default is -system-drive:\cygnus\cygwin-b20. -Feel free to choose another location if you would prefer. - -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. - -If you should ever want to uninstall the tools, you may do so -via the "Add/Remove Programs" control panel. - - 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 shell=C:\command.com /e:4096 /p to the file -C:\CONFIG.SYS and then rebooting should do the trick if -C: is your system drive letter. - -If you want to install the sources follow the -instructions in the next section, else go directly to - to complete your system setup. - - -Installing the source code - -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). - -Create the directory that will house the source code. -cd there. - -Connect to one of the ftp servers listed above and -cd to the directory containing the latest release. - - -The source code is split into two units: user tools and development -tools. If you want the user tools source code, cd into -the user-src-split subdirectory. Download the files -there. If you want the development tools sources, cd -into the dev-src-split subdirectory. Download the -files there. - -Back in the Windows command shell, for the user tools -source: - - -C:\Cygnus\> copy /b xba + xbb + xbc + xbd + xbe + xbf + xbg user-src.tar.bz2 -C:\Cygnus\> del xb*.* -C:\Cygnus\> bunzip2 user-src.tar.bz2 -C:\Cygnus\> tar xvf user-src.tar - - -For the development tools source: - - -C:\Cygnus\> copy /b xca + xcb + xcc + xcd + ... + xck + xcl dev-src.tar.bz2 -C:\Cygnus\> del xc*.* -C:\Cygnus\> bunzip2 dev-src.tar.bz2 -C:\Cygnus\> tar xvf dev-src.tar - - -Both will expand into a directory called -src. - -Note: if you want the sources corresponding to everything in the -full.exe binary installer, you will need to download and expand both -the user-src.tar.bz2 and -dev-src.tar.bz2 source archives! +Internet Setup +To install the Cygwin net release, go to http://cygwin.com/ and click on "Install Cygwin Now!". This will +download a GUI installer called setup.exe which can +be run to download a complete cygwin installation via the internet. +Follow the instructions on each screen to install Cygwin. -DOCTOOL-INSERT-setup-dir DOCTOOL-INSERT-setup-env DOCTOOL-INSERT-ntsec DOCTOOL-INSERT-setup-files diff --git a/winsup/doc/setup2.sgml b/winsup/doc/setup2.sgml index c3df06ec1..4b2ecf6ef 100644 --- a/winsup/doc/setup2.sgml +++ b/winsup/doc/setup2.sgml @@ -1,173 +1,22 @@ -Directory Structure - - -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 mount command. This section explains how -to properly organize the structure. - - 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 -c: or a directory such as -c:\progra~1\root. - - - -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 PATH, if this -happens simply exit and relaunch bash. Create the directory if -needed, then umount / the current root and -mount it in its new place. You also have to decide if -you want to use text or binary mode. - - - -Next, create the traditional main UNIX directories, with -the following command (in some shells it is necessary to issue -separate mkdir commands, each with a single -argument). - - - -/$ mkdir /tmp /bin /etc /var /usr - - - -Next we will initialize the content of these directories. - - - -You should make sure that you always have a valid -/tmp directory. If you want to avoid creating a -real /tmp, you can use the -mount utility to point /tmp to -another directory, such as c:\tmp, or create a -symbolic link /tmp to point to such a directory. - - - -The /bin directory should contain the shell -sh.exe. You have three choices. The first is to -copy this program from the Cygnus bin directory. -The second is to use mount to mount the Cygnus -bin directory to /bin (the -advantage of this approach is that your PATH will be -shorter inside bash). The third is to make /bin a -symbolic link to the Cygnus bin directory. - - - -Note that Cygwin comes with two shells: bash.exe and -sh.exe, which is based on ash. The -system is faster when ash is used as the -non-interactive shell. -The only functionality supported in ash is that -of the traditional sh. -In case of trouble with ash make -sh.exe point to bash.exe. - - - -We now turn to /etc. You may want to copy in it -the termcap file from the Cygnus -etc directory, although the defaults built into -the programs suffice for the normal console. You may also use -mount or create as symbolic link to the Cygnus -etc, just as for /bin -above. - - - Under Windows NT, if you want to create -/etc/passwd and /etc/group -(i.e. so that whoami works and -ls -l replaces the UID with a name) based on the accounts local to the machine, just do this: - - - -/$ cd /etc -/etc$ mkpasswd -l > /etc/passwd -/etc$ mkgroup -l > /etc/group - - -If you are logging in based on an NT network domain, and want to -also create entries in /etc/passwd and -/etc/group based on all the accounts in the -domain, then after creating local entries do this: - - - -/$ cd /etc -/etc$ mkpasswd -d >> /etc/passwd -/etc$ mkgroup -d >> /etc/group - - -Alternatively, to add only your account to the passwd file, -assuming your NT name is "my_ntusername", instead of the above -mkpasswd you should do: - - - -/$ cd /etc -/etc$ mkpasswd -d | grep my_ntusername >> /etc/passwd - - - - Future changes to your NT registry or network domain will NOT be reflected in -/etc/passwd or /etc/group 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. - - -The who command requires the -/var/run/utmp to exist. -Create it if you wish. -The system also logs information in /var/log/wtmp, -if it exists. - - - -The /usr directory is not used by the Cygwin -system but it is a standard place to install optional packages. - - - -You may also want to mount directories such as /a -and /d to refer to your local and network drives. - - - -You do not need to create /dev in order to set up -mounts for devices such as /dev/null as these -are already automatically simulated inside the Cygwin library. - - - - Environment Variables -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 -\cygnus\cygwin-b20/cygnus.bat and pointed to in -the Start Menu. You can edit it to your liking. - +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. -The CYGWIN variable is used to configure many global -settings for the Cygwin -runtime system. Initially you can leave CYGWIN unset -or set it to tty (e.g. to support job control with ^Z -etc...) using a syntax like this in the DOS shell, before launching bash. - +The CYGWIN variable is used to configure many global +settings for the Cygwin runtime system. Initially you can leave +CYGWIN unset or set it to tty (e.g. +to support job control with ^Z etc...) using a syntax like this in the +DOS shell, before launching bash. -C:\Cygnus\> set CYGWIN=tty notitle glob +C:\> set CYGWIN=tty notitle glob @@ -177,10 +26,9 @@ to run. This environment variable is converted from Windows format (e.g. C:\WinNT\system32;C:\WinNT) to UNIX format (e.g., /WinNT/system32:/WinNT) when a Cygwin process first starts. -Set it so that it contains at least the Cygnus -bin directory -C:\cygnus\cygwin-b20\H-i586-cygwin32\bin before -launching bash. +Set it so that it contains at least the x:\cygwin\bin +directory where "x:\cygwin is the "root" of your +cygwin installation if you wish to use cygwin tools outside of bash. @@ -191,33 +39,17 @@ when a Cygwin process first starts. Set it to point to your home directory before launching bash. - -make uses an environment variable -MAKE_MODE to decide if it uses -command.com or /bin/sh to -run command lines. If you are getting strange errors from -make about "/c not found", set -MAKE_MODE to UNIX at the command -prompt or in bash. - - - -C:\Cygnus\> set MAKE_MODE=UNIX - -/Cygnus$ export MAKE_MODE=UNIX - - The TERM environment variable specifies your terminal -type. You can set it to cygwin. +type. It is automatically set to cygwin if you have +not set it to something else. -The LD_LIBRARY_PATH environment variable is -used by the Cygwin function dlopen () 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 +The LD_LIBRARY_PATH environment variable is used by +the Cygwin function dlopen () 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 dlopen () call and do not need this variable. diff --git a/winsup/doc/textbinary.sgml b/winsup/doc/textbinary.sgml index cf6fc1b36..a58bd0231 100644 --- a/winsup/doc/textbinary.sgml +++ b/winsup/doc/textbinary.sgml @@ -127,7 +127,7 @@ In the second case we rely on the DOS shell to redirect in binary mode. 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. Text mode makes it much easier to mix files between Cygwin and -- cgit v1.2.3