* 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.

4 files changed, 85 insertions, 109 deletions

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index 80158c410..a91e31233 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,11 @@
+2011-06-15  Corinna Vinschen  <corinna@vinschen.de>
+
+	* 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  <eblake@redhat.com>
 
 	* new-features.sgml (ov-new1.7.10): Document strerror changes.
diff --git a/winsup/doc/cygwinenv.sgml b/winsup/doc/cygwinenv.sgml
index bb4b669de..3b2caaece 100644
--- a/winsup/doc/cygwinenv.sgml
+++ b/winsup/doc/cygwinenv.sgml
@@ -18,14 +18,6 @@ path name.  Defaults to set.</para>
 </listitem>
 
 <listitem>
-<para><envar>(no)envcache</envar> - 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.</para>
-</listitem>
-
-<listitem>
 <para><envar>(no)export</envar> - If set, the final values of these
 settings are re-exported to the environment as <envar>CYGWIN</envar> again.
 Defaults to off.</para>
@@ -44,14 +36,6 @@ There is no default set.
 </listitem>
 
 <listitem>
-<para><envar>proc_retry:n</envar> - causes <function>fork()</function> and
-<function>exec*()</function> 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.
-</para>
-</listitem>
-
-<listitem>
 <para><envar>(no)glob[:ignorecase]</envar> - 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 <literal>noi
 </listitem>
 
 <listitem>
-<para><envar>(no)reset_com</envar> - 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.</para>
-</listitem>
-
-<listitem>
-<para><envar>(no)strip_title</envar> - if set, strips the directory
-part off the window title, if any.  Default is not set.</para>
-</listitem>
-
-<listitem>
-<para><envar>(no)title</envar> - if set, the title bar
-reflects the name of the program currently running.  Default is not
-set.</para>
-</listitem>
-
-<listitem>
-<para><envar>(no)tty</envar> - 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 <command>stty</command>.
-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). 
+<para><envar>proc_retry:n</envar> - causes <function>fork()</function> and
+<function>exec*()</function> 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.
 </para>
 </listitem>
 
 <listitem>
-<para><envar>(no)upcaseenv</envar> - 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:</para>
-<screen>
-  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
-</screen>
-<para>Defaults to not set.</para>
+<para><envar>(no)reset_com</envar> - 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.</para>
 </listitem>
 
 <listitem>
@@ -180,6 +112,12 @@ became superfluous.</para>
 </listitem>
 
 <listitem>
+<para><envar>(no)envcache</envar> - Originally, <envar>envcache</envar>
+controlled caching of environment variable conversion between Win32 and
+POSIX.  The default setting works fine, the option was just useless.</para>
+</listitem>
+
+<listitem>
 <para><envar>forkchunk:[intval]</envar> - This option allowed to influence
 the <function>fork()</function> 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 <xref linkend="mount-table"></xref>.</para>
 </listitem>
 
 <listitem>
+<para><envar>(no)strip_title</envar> - Removed because setting the Window title
+can be controlled by the application via Escape sequences.</para>
+</listitem>
+
+<listitem>
+<para><envar>(no)title</envar> - Removed because setting the Window title
+can be controlled by the application via Escape sequences.</para>
+</listitem>
+
+<listitem>
 <para><envar>(no)transparent_exe</envar> - This option has been removed
 because the behaviour it switched on is now the standard behaviour in
 Cygwin.</para>
@@ -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.</para>
 </listitem>
 
+<listitem>
+<para><envar>(no)tty</envar> - 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 <command>mintty</command>, and it does not work well with some
+Windows programs.</para>
+</listitem>
+
+<listitem>
+<para><envar>(no)upcaseenv</envar> - 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:
+</para>
+<screen>
+  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
+</screen>
+</listitem>
+
 </itemizedlist>
 
 </sect2>
diff --git a/winsup/doc/effectively.sgml b/winsup/doc/effectively.sgml
index 6f55266da..41a97f8b5 100644
--- a/winsup/doc/effectively.sgml
+++ b/winsup/doc/effectively.sgml
@@ -63,40 +63,6 @@ preferable to use <command>cygpath</command> in shell scripts.
 
 </sect2>
 
-<sect2 id="using-console"> <title>Console Programs</title>
-<para>
-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 
-<command>cmd.exe</command>, 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.  
-</para>
-
-<para>
-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 <command>bash</command> within 
-a default DOS box. To make Cygwin more Unix compatible in this case, 
-set <envar>CYGWIN=tty</envar> (see <xref linkend="using-cygwinenv"></xref>).
-Alternatively, the optional <systemitem>mintty</systemitem> package
-provides a terminal emulator similar to such X11 programs as
-<command>xterm</command> (it is not necessary to set
-<envar>CYGWIN=tty</envar> with <command>mintty</command> nor is it
-necessary to be running <systemitem>/Cygwin/X</systemitem>).  Using
-<command>mintty.exe</command> provides the most Unix-like environment,
-but expect some compatibility problems with Windows programs.
-</para>
-
-</sect2>
-
 <sect2 id="using-net"> <title>Cygwin and Windows Networking</title>
 <para>
 Many popular Cygwin packages, such as <systemitem>ncftp</systemitem>, 
diff --git a/winsup/doc/new-features.sgml b/winsup/doc/new-features.sgml
index 1c8143306..715ae192e 100644
--- a/winsup/doc/new-features.sgml
+++ b/winsup/doc/new-features.sgml
@@ -9,6 +9,17 @@ Drop support for Windows NT4.
 </para></listitem>
 
 <listitem><para>
+The CYGWIN environment variable options "envcache", "strip_title", "title",
+"tty", and "upcaseenv" have been removed.
+</para></listitem>
+
+<listitem><para>
+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 <command>mintty</command>.
+</para></listitem>
+
+<listitem><para>
 The passwd command now allows an administrator to use the -R command for
 other user accounts:  passwd -R username.
 </para></listitem>