[Emacs-diffs] emacs/doc/lispref frames.texi

[Eli Zaretskii]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Eli Zaretskii <eliz>    08/12/27 18:56:53

Modified files:
        doc/lispref    : frames.texi 

Log message:
        (Multiple Terminals, Low-level Terminal)
        (Terminal Parameters, Frames on Other TTY devices): New sections.
        (Frames): Add an xref to "Multiple Terminals".

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/frames.texi?cvsroot=emacs&r1=1.17&r2=1.18

Patches:
Index: frames.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/frames.texi,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -b -r1.17 -r1.18
--- frames.texi 21 Nov 2008 10:18:09 -0000      1.17
+++ frames.texi 27 Dec 2008 18:56:53 -0000      1.18
@@ -26,7 +26,7 @@
 terminal screen, of course.  You can create additional frames, either
 text-only or GUI, on other terminals from the same Emacs session.
 (This comes in handy when you connect to the same session from several
-remote locations.)  @c FIXME: Add an xref to multi-tty doc.
+remote locations.)  @xref{Multiple Terminals}.
 
 @cindex window frame
   When Emacs communicates directly with a supported window system, such
@@ -77,6 +77,7 @@
 * Text Terminal Colors::        Defining colors for text-only terminals.
 * Resources::                  Getting resource values from the server.
 * Display Feature Testing::     Determining the features of a terminal.
+* Multiple Terminals::          Displaying on several different devices.
 @end menu
 
   @xref{Display}, for information about the related topic of
@@ -2241,6 +2242,109 @@
 width and height of an X Window frame, measured in pixels.
 @end ignore
 
address@hidden Multiple Terminals
address@hidden Multiple Terminals
address@hidden multiple terminals
address@hidden multi-tty
+
+  A @dfn{terminal} is a display device capable of displaying one or
+more Emacs frames.  On GNU and Unix systems, Emacs supports any number
+of different terminals in one session, and can mix GUI and text-only
+frames in the same session.
+
+  Emacs represents each terminal on which it displays frames as a
+special @dfn{terminal object} data type, see @ref{Terminal Type}.  The
+terminal object has a unique integer identifier and the following
+attributes:
+
address@hidden @bullet
address@hidden
+The name of the device used by the terminal (e.g., @file{/dev/tty}).
+
address@hidden
+The terminal and keyboard coding systems (@pxref{Terminal I/O
+Encoding}) used on the terminal.
+
address@hidden
+The type of frames (@pxref{Frames}) the terminal is displaying.
+
address@hidden
+A list of the terminal parameters (@pxref{Terminal Parameters}).
address@hidden itemize
+
address@hidden This is still under construction.
+
address@hidden frame-terminal
address@hidden defun
+
address@hidden get-device-terminal device
address@hidden defun
+
address@hidden terminal-list
address@hidden defun
+
address@hidden
+* Low-level Terminal::          Low-level manipulation of terminal objects.
+* Terminal Parameters::         Parameters common for all frames on terminal.
+* Frames on Other TTY devices:: Creating frames on other terminal devices.
address@hidden menu
+
address@hidden Low-level Terminal
address@hidden Low-level Access to Terminals
+
+  This subsection describes low-level primitives for accessing and
+manipulating Emacs terminal objects.  There's no primitive for
+creating terminal objects; Emacs creates them as needed when you call
+one of the primitives, such as @code{make-frame-on-tty} (@pxref{Frames
+on Other TTY devices}), that start displaying on a new terminal.
+
address@hidden suspend-tty &optional tty
address@hidden defun
+
address@hidden resume-tty &optional tty
address@hidden defun
+
address@hidden terminal-live-p object
address@hidden defun
+
address@hidden terminal-name &optional terminal
address@hidden defun
+
address@hidden delete-terminal &optional terminal force
address@hidden defun
+
address@hidden Terminal Parameters
address@hidden Terminal Parameters
address@hidden terminal parameters
+
+  This subsection describes how to read and change the parameter
+values of a terminal.
+
address@hidden terminal-parameters &optional terminal
address@hidden defun
+
address@hidden terminal-parameter terminal parameter
address@hidden defun
+
address@hidden set-terminal-parameter terminal parameter value
address@hidden defun
+
address@hidden environment &optional frame
address@hidden defun
+
address@hidden initial-environment
address@hidden defvar
+
address@hidden Frames on Other TTY devices
address@hidden Frames on Other TTY devices
+
+  This subsection documents functions related to displaying Emacs
+frames on a terminal device other than the current one.
+
address@hidden make-frame-on-tty tty type &optional parameters
address@hidden defun
+
+
 @ignore
    arch-tag: 94977df6-3dca-4730-b57b-c6329e9282ba
 @end ignore