From a55e90e1ad11090bb9206292153b0da60e9dba94 Mon Sep 17 00:00:00 2001 From: corinna Date: Wed, 15 Jun 2011 11:41:26 +0000 Subject: [PATCH] * cygwinenv.sgml (using-cygwinenv): Move envcache, strip_title, title, tty, and upcaseenv options to list of obsolete options. * effectively.sgml (using-console): Remove section. * new-features.sgml (ov-new1.7.10): Document removed CYGWIN options. Document removed tty mode. --- winsup/doc/ChangeLog | 8 +++ winsup/doc/cygwinenv.sgml | 141 ++++++++++++++++++++----------------------- winsup/doc/effectively.sgml | 34 ----------- winsup/doc/new-features.sgml | 11 ++++ 4 files changed, 85 insertions(+), 109 deletions(-) diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index 80158c4106..a91e31233b 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,11 @@ +2011-06-15 Corinna Vinschen + + * cygwinenv.sgml (using-cygwinenv): Move envcache, strip_title, title, + tty, and upcaseenv options to list of obsolete options. + * effectively.sgml (using-console): Remove section. + * new-features.sgml (ov-new1.7.10): Document removed CYGWIN options. + Document removed tty mode. + 2011-05-25 Eric Blake * new-features.sgml (ov-new1.7.10): Document strerror changes. diff --git a/winsup/doc/cygwinenv.sgml b/winsup/doc/cygwinenv.sgml index bb4b669def..3b2caaece6 100644 --- a/winsup/doc/cygwinenv.sgml +++ b/winsup/doc/cygwinenv.sgml @@ -18,14 +18,6 @@ path name. Defaults to set. -(no)envcache - If set, environment variable -conversions (between Win32 and POSIX) are cached. Note that this may -cause problems if the mount table changes, as the cache is not invalidated -and may contain values that depend on the previous mount table -contents. Defaults to set. - - - (no)export - If set, the final values of these settings are re-exported to the environment as CYGWIN again. Defaults to off. @@ -44,14 +36,6 @@ There is no default set. -proc_retry:n - causes fork() and -exec*() to retry n times when a child process fails -due to certain windows-specific errors. These errors usually occur when -processes are being started while a user is logging off. - - - - (no)glob[:ignorecase] - if set, command line arguments containing UNIX-style file wildcard characters (brackets, question mark, asterisk, escaped with \) are expanded into lists of files that match @@ -63,69 +47,17 @@ If supplied, wildcard matching is case insensitive. The default is noi -(no)reset_com - if set, serial ports are reset -to 9600-8-N-1 with no flow control when used. This is done at open -time and when handles are inherited. Defaults to set. - - - -(no)strip_title - if set, strips the directory -part off the window title, if any. Default is not set. - - - -(no)title - if set, the title bar -reflects the name of the program currently running. Default is not -set. - - - -(no)tty - if set, Cygwin enables extra support -(i.e., termios) for UNIX-like ttys in the Windows console. -It is not compatible with some Windows programs. -Defaults to not set, in which case the tty is opened in text mode. -Note that this has been changed such that ^D works as -expected instead of ^Z, and is settable via stty. -This option must be specified before starting a Cygwin shell -and it cannot be changed in the shell. It should not be set when using -other terminals (i.e., mintty or xterm). +proc_retry:n - causes fork() and +exec*() to retry n times when a child process fails +due to certain windows-specific errors. These errors usually occur when +processes are being started while a user is logging off. -(no)upcaseenv - if set, Cygwin converts all -environment variables to all-uppercase, when a Cygwin process is started -from a non-Cygwin native Windows process. This was the default behavior in -releases prior to Cygwin 1.7. If not set, Cygwin does not change the case -of environment variables, except for a restricted set to maintain minimal -backward compatibility and for correct handling of certain essential -variables. The current list of always uppercased variables is: - - ALLUSERSPROFILE - COMMONPROGRAMFILES - COMPUTERNAME - COMSPEC - HOME - HOMEDRIVE - HOMEPATH - NUMBER_OF_PROCESSORS - OS - PATH - PATHEXT - PROCESSOR_ARCHITECTURE - PROCESSOR_IDENTIFIER - PROCESSOR_LEVEL - PROCESSOR_REVISION - PROGRAMFILES - SYSTEMDRIVE - SYSTEMROOT - TEMP - TERM - TMP - TMPDIR - WINDIR - -Defaults to not set. +(no)reset_com - if set, serial ports are reset +to 9600-8-N-1 with no flow control when used. This is done at open +time and when handles are inherited. Defaults to set. @@ -180,6 +112,12 @@ became superfluous. +(no)envcache - Originally, envcache +controlled caching of environment variable conversion between Win32 and +POSIX. The default setting works fine, the option was just useless. + + + forkchunk:[intval] - This option allowed to influence the fork() function in the way the memory of the parent process gets copied to the child process. This functionality was @@ -216,6 +154,16 @@ documentation in . +(no)strip_title - Removed because setting the Window title +can be controlled by the application via Escape sequences. + + + +(no)title - Removed because setting the Window title +can be controlled by the application via Escape sequences. + + + (no)transparent_exe - This option has been removed because the behaviour it switched on is now the standard behaviour in Cygwin. @@ -228,6 +176,49 @@ it's behaviour has been getting worse with each new OS version. This complicates its usage so the option has been removed for now. + +(no)tty - If set, Cygwin enabled extra support +(i.e., termios) for UNIX-like ttys in the Windows console. This option +has been removed because it can be easily replaced by using a terminal +like mintty, and it does not work well with some +Windows programs. + + + +(no)upcaseenv - This option could be used to convert +all environment variables to uppercase. This was the default behavior in +releases prior to Cygwin 1.7. Since keeping the case of environment +variables intact is POSIXly correct, Cygwin now does not change the case +of environment variables, except for a restricted set to maintain minimal +backward compatibility. The current list of always uppercased variables is: + + + ALLUSERSPROFILE + COMMONPROGRAMFILES + COMPUTERNAME + COMSPEC + HOME + HOMEDRIVE + HOMEPATH + NUMBER_OF_PROCESSORS + OS + PATH + PATHEXT + PROCESSOR_ARCHITECTURE + PROCESSOR_IDENTIFIER + PROCESSOR_LEVEL + PROCESSOR_REVISION + PROGRAMFILES + SYSTEMDRIVE + SYSTEMROOT + TEMP + TERM + TMP + TMPDIR + WINDIR + + + diff --git a/winsup/doc/effectively.sgml b/winsup/doc/effectively.sgml index 6f55266daf..41a97f8b58 100644 --- a/winsup/doc/effectively.sgml +++ b/winsup/doc/effectively.sgml @@ -63,40 +63,6 @@ preferable to use cygpath in shell scripts. - Console Programs - -Another issue is receiving output from or giving input to console-based -Windows programs. Unfortunately, interacting with Windows console -applications is not a simple matter of using a translation utility. Windows -console applications are designed to run under -cmd.exe, and some do not deal gracefully with other -situations. Cygwin can receive console input only if it -is also running in a console window since Windows does not provide -any way to attach to the backend of the console device. Another -traditional Unix input/output method, ptys (pseudo-terminals), is -supported by Cygwin but not entirely by Windows. The basic problem is -that a Cygwin pty is a pipe and some Windows applications do not like -having their input or output redirected to pipes. - - - -To help deal with these issues, Cygwin supports customizable levels of -Windows versus Unix compatibility behavior. To be most compatible with -Windows programs, use a DOS prompt, running only the occasional Cygwin -command or script. Next would be to run bash within -a default DOS box. To make Cygwin more Unix compatible in this case, -set CYGWIN=tty (see ). -Alternatively, the optional mintty package -provides a terminal emulator similar to such X11 programs as -xterm (it is not necessary to set -CYGWIN=tty with mintty nor is it -necessary to be running /Cygwin/X). Using -mintty.exe provides the most Unix-like environment, -but expect some compatibility problems with Windows programs. - - - - Cygwin and Windows Networking Many popular Cygwin packages, such as ncftp, diff --git a/winsup/doc/new-features.sgml b/winsup/doc/new-features.sgml index 1c8143306b..715ae192eb 100644 --- a/winsup/doc/new-features.sgml +++ b/winsup/doc/new-features.sgml @@ -9,6 +9,17 @@ Drop support for Windows NT4. +The CYGWIN environment variable options "envcache", "strip_title", "title", +"tty", and "upcaseenv" have been removed. + + + +The CYGWIN=tty mode using pipes to communicate with the console in a pseudo +tty-like mode has been removed. Either just use the normal Windows console +as is, or use a terminal application like mintty. + + + The passwd command now allows an administrator to use the -R command for other user accounts: passwd -R username. -- 2.11.0