From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 27 Dec 2008 15:44:38 +0000 (+0000)
Subject: (Terminal Type): New node.
X-Git-Tag: emacs-pretest-23.0.90~853
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=eba64e97a1b7db5148d4e6120dd591b7a0d07982;p=emacs.git

(Terminal Type): New node.
(Editing Types): Add it to the menu.
---

diff --git a/doc/lispref/objects.texi b/doc/lispref/objects.texi
index 350817f7c63..d4f1a3a6aad 100644
--- a/doc/lispref/objects.texi
+++ b/doc/lispref/objects.texi
@@ -1347,7 +1347,8 @@ editing.
 * Buffer Type::         The basic object of editing.
 * Marker Type::         A position in a buffer.
 * Window Type::         Buffers are displayed in windows.
-* Frame Type::		Windows subdivide frames.
+* Frame Type::          Windows subdivide frames.
+* Terminal Type::       A terminal device displays frames.
 * Window Configuration Type::   Recording the way a frame is subdivided.
 * Frame Configuration Type::    Recording the status of all frames.
 * Process Type::        A subprocess of Emacs running on the underlying OS.
@@ -1492,6 +1493,25 @@ uniquely).
 
   @xref{Frames}, for a description of the functions that work on frames.
 
+@node Terminal Type
+@subsection Terminal Type
+@cindex terminal type
+
+  A @dfn{terminal} is a device capable of displaying one or more
+Emacs frames (@pxref{Frame Type}).
+
+  Terminals have no read syntax.  They print in hash notation giving
+the terminal's ordinal number and its TTY device file name.
+
+@example
+@group
+(get-device-terminal nil)
+     @result{} #<terminal 1 on /dev/tty>
+@end group
+@end example
+
+@c FIXME: add an xref to where terminal-related primitives are described.
+
 @node Window Configuration Type
 @subsection Window Configuration Type
 @cindex window layout in a frame