diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index 65786f774..a9a80afe2 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,8 @@ +2009-12-02 Ken Brown + + * setup2.sgml (setup-env): Clarify that Windows environment gets + copied over. Add paragraph about TMP, TEMP, and TMPDIR. + 2009-11-18 Corinna Vinschen * overview2.sgml (ov-hi-files): Remove reference to root directory when diff --git a/winsup/doc/setup2.sgml b/winsup/doc/setup2.sgml index 99558f44f..51fc0d3c2 100644 --- a/winsup/doc/setup2.sgml +++ b/winsup/doc/setup2.sgml @@ -4,7 +4,9 @@ You may wish to specify settings of several important environment variables that affect Cygwin's operation. Some of these settings need to be in effect prior to launching the initial Cygwin session (before -starting your bash shell, for instance), and are, consequentially, best +starting your bash shell, for instance). They should therefore be set +in the Windows environment; all Windows environment variables are +imported when Cygwin starts. Such settings can be placed in a .bat file. An initial file is named Cygwin.bat and is created in the Cygwin root directory that you specified during setup. Note that the "Cygwin" option of the Start Menu points to Cygwin.bat. Edit @@ -66,6 +68,34 @@ first starts. Most Cygwin applications do not make use of the dlopen () call and do not need this variable. + +In addition to PATH, HOME, +and LD_LIBRARY_PATH, there are three other environment +variables which, if they exist in the Windows environment, are +converted to UNIX format: TMPDIR, TMP, +and TEMP. The first is not set by default in the +Windows environment but the other two are, and they point to the +default Windows temporary directory. If set, these variables will be +used by some Cygwin applications, possibly with unexpected results. +You may therefore want to unset them by adding the following two lines +to your ~/.bashrc file: + + +unset TMP +unset TEMP + + +This is done in the default ~/.bashrc file. +Alternatively, you could set TMP +and TEMP to point to /tmp or to +any other temporary directory of your choice. For example: + + +export TMP=/tmp +export TEMP=/tmp + + + Changing Cygwin's Maximum Memory