[Emacs-diffs] /srv/bzr/emacs/emacs-24 r110807: * misc.texi (Terminal emulator): Document Term mode faces.

[Chong Yidong]

------------------------------------------------------------
revno: 110807
committer: Chong Yidong <address@hidden>
branch nick: emacs-24
timestamp: Thu 2012-11-08 05:04:52 +0800
message:
  * misc.texi (Terminal emulator): Document Term mode faces.
modified:
  doc/emacs/ChangeLog
  doc/emacs/misc.texi
  etc/NEWS

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2012-11-07 20:43:38 +0000
+++ b/doc/emacs/ChangeLog       2012-11-07 21:04:52 +0000
@@ -1,5 +1,7 @@
 2012-11-07  Chong Yidong  <address@hidden>
 
+       * misc.texi (Terminal emulator): Document Term mode faces.
+
        * mini.texi (Basic Minibuffer): New node.  Document
        minibuffer-electric-default-mode.
 

=== modified file 'doc/emacs/misc.texi'
--- a/doc/emacs/misc.texi       2012-09-30 09:18:38 +0000
+++ b/doc/emacs/misc.texi       2012-11-07 21:04:52 +0000
@@ -1186,30 +1186,39 @@
 @subsection Emacs Terminal Emulator
 @findex term
 
-  To run a subshell in a terminal emulator, use @kbd{M-x term}.  This
-creates (or reuses) a buffer named @file{*terminal*}, and runs a
+  To run a subshell in a text terminal emulator, use @kbd{M-x term}.
+This creates (or reuses) a buffer named @file{*terminal*}, and runs a
 subshell with input coming from your keyboard, and output going to
 that buffer.
 
address@hidden line mode @r{(terminal emulator)}
address@hidden char mode @r{(terminal emulator)}
   The terminal emulator uses Term mode, which has two input modes.  In
-line mode, Term basically acts like Shell mode (@pxref{Shell Mode}).
-
-  In char mode, each character is sent directly to the subshell, as
-``terminal input''.  Any ``echoing'' of your input is the
-responsibility of the subshell.  The sole exception is the terminal
-escape character, which by default is @kbd{C-c} (@pxref{Term Mode}).
-Any ``terminal output'' from the subshell goes into the buffer,
-advancing point.
address@hidden mode}, Term basically acts like Shell mode (@pxref{Shell
+Mode}).  In @dfn{char mode}, each character is sent directly to the
+subshell, as terminal input; the sole exception is the terminal escape
+character, which by default is @kbd{C-c} (@pxref{Term Mode}).  Any
+echoing of your input is the responsibility of the subshell; any
+terminal output from the subshell goes into the buffer, advancing
+point.
 
   Some programs (such as Emacs itself) need to control the appearance
-on the terminal screen in detail.  They do this by sending special
-control codes.  The exact control codes needed vary from terminal to
-terminal, but nowadays most terminals and terminal emulators
-(including @code{xterm}) understand the ANSI-standard (VT100-style)
-escape sequences.  Term mode recognizes these escape sequences, and
-handles each one appropriately, changing the buffer so that the
-appearance of the window matches what it would be on a real terminal.
-You can actually run Emacs inside an Emacs Term window.
+of the terminal screen in detail.  They do this by emitting special
+control codes.  Term mode recognizes and handles ANSI-standard
+VT100-style escape sequences, which are accepted by most modern
+terminals, including @command{xterm}.  (Hence, you can actually run
+Emacs inside an Emacs Term window.)
+
+  The @code{term-face} face specifies the default appearance of text
+in the terminal emulator (the default is the same appearance as the
address@hidden face).  When terminal control codes are used to change
+the appearance of text, these are represented in the terminal emulator
+by the faces @code{term-color-black}, @code{term-color-red},
address@hidden, @code{term-color-yellow}
address@hidden, @code{term-color-magenta},
address@hidden, @code{term-color-white},
address@hidden, and @code{term-color-bold}.
address@hidden
 
   You can also Term mode to communicate with a device connected to a
 serial port.  @xref{Serial Terminal}.
@@ -1224,6 +1233,9 @@
 directory is.  This is done automatically by @code{bash} version 1.15
 and later.
 
+
+
+
 @node Term Mode
 @subsection Term Mode
 @cindex Term mode

=== modified file 'etc/NEWS'
--- a/etc/NEWS  2012-11-07 20:43:38 +0000
+++ b/etc/NEWS  2012-11-07 21:04:52 +0000
@@ -583,7 +583,7 @@
 at point, or the Nth column if a numeric prefix argument is given.
 
 ** Term
-
++++
 The variables `term-default-fg-color' and `term-default-bg-color' are
 now deprecated in favor of the `term-face' face, that you can
 customize.  Also, it is now possible to customize how are displayed the