Commit a08a07e3 authored by Chong Yidong's avatar Chong Yidong

Update Frames chapter of Lisp manager. Document clipboard manager.

* doc/emacs/killing.texi (Clipboard): Document clipboard manager.

* doc/lispref/windows.texi (Basic Windows, Coordinates and Windows)
(Coordinates and Windows):
* display.texi (Refresh Screen, Line Height, Face Attributes)
(Overlay Arrow, Beeping, Glyphless Chars): Likewise.

* doc/lispref/frames.texi (Frames): Remove little-used "terminal frame" and
"window frame" terminology.
(Frame Parameters, Font and Color Parameters, Initial Parameters)
(Size and Position, Visibility of Frames): Callers changed.
(Frames): Clarify which terminals in framep are graphical.
(Initial Parameters): --geometry is not the only option which adds
to initial-frame-alist.
(Position Parameters): Note that icon-left and icon-top are for
old window managers only.
(Size Parameters): Sizes are in characters even on graphical
displays.
(Management Parameters): Note that window-id and outer-window-id
can't really be changed, and that auto-raise isn't always obeyed.
(Cursor Parameters): Document cursor-type explicitly.
(Size and Position): The aliases set-screen-height and
set-screen-width have been deleted.
(Visibility of Frames): Mention "minimization".

* doc/lispref/os.texi (Startup Summary): Minor clarifications.
(Startup Summary, Suspending Emacs): Standardize on "text
terminal" terminology.
parent ea16568d
......@@ -197,7 +197,7 @@ elisp.texi
errors.texi rgm
eval.texi cyd
files.texi cyd
frames.texi
frames.texi cyd
functions.texi cyd
hash.texi cyd
help.texi cyd
......
2012-03-04 Chong Yidong <cyd@gnu.org>
* killing.texi (Clipboard): Document clipboard manager.
2012-02-29 Glenn Morris <rgm@gnu.org>
* ack.texi (Acknowledgments): Use @Tex{} in more places.
......
......@@ -490,6 +490,17 @@ new yank to the clipboard.
To prevent kill and yank commands from accessing the clipboard,
change the variable @code{x-select-enable-clipboard} to @code{nil}.
@cindex clipboard manager
@vindex x-select-enable-clipboard-manager
Many X desktop environments support a feature called the
@dfn{clipboard manager}. If you exit Emacs while it is the current
``owner'' of the clipboard data, and there is a clipboard manager
running, Emacs transfers the clipboard data to the clipboard manager
so that it is not lost. In some circumstances, this may cause a delay
when exiting Emacs; if you wish to prevent Emacs from transferring
data to the clipboard manager, change the variable
@code{x-select-enable-clipboard-manager} to @code{nil}.
@vindex x-select-enable-primary
@findex clipboard-kill-region
@findex clipboard-kill-ring-save
......
2012-03-04 Chong Yidong <cyd@gnu.org>
* frames.texi (Frames): Remove little-used "terminal frame" and
"window frame" terminology.
(Frame Parameters, Font and Color Parameters, Initial Parameters)
(Size and Position, Visibility of Frames): Callers changed.
(Frames): Clarify which terminals in framep are graphical.
(Initial Parameters): --geometry is not the only option which adds
to initial-frame-alist.
(Position Parameters): Note that icon-left and icon-top are for
old window managers only.
(Size Parameters): Sizes are in characters even on graphical
displays.
(Management Parameters): Note that window-id and outer-window-id
can't really be changed, and that auto-raise isn't always obeyed.
(Cursor Parameters): Document cursor-type explicitly.
(Size and Position): The aliases set-screen-height and
set-screen-width have been deleted.
(Visibility of Frames): Mention "minimization".
* os.texi (Startup Summary): Minor clarifications.
(Startup Summary, Suspending Emacs): Standardize on "text
terminal" terminology.
* windows.texi (Basic Windows, Coordinates and Windows)
(Coordinates and Windows):
* display.texi (Refresh Screen, Line Height, Face Attributes)
(Overlay Arrow, Beeping, Glyphless Chars): Likewise.
2012-03-04 Glenn Morris <rgm@gnu.org>
* abbrevs.texi: Small copyedits throughout.
......
......@@ -93,9 +93,9 @@ are always drawn using the X core font driver.
@item
Display terminals are no longer represented using a ``terminal'' data
type; this is not necessary, because we have removed the ability to
display on graphical and text-only terminals simultaneously. For the
same reason, the @code{window-system} variable is no longer
frame-local, and the @code{window-system} function has been removed.
display on graphical and text terminals simultaneously. For the same
reason, the @code{window-system} variable is no longer frame-local,
and the @code{window-system} function has been removed.
@item
The functions @code{list-system-processes} and
......
......@@ -62,7 +62,7 @@ you call these functions when input is available, they don't redisplay
immediately, but the requested redisplay does happen
eventually---after all the input has been processed.
On text-only terminals, suspending and resuming Emacs normally also
On text terminals, suspending and resuming Emacs normally also
refreshes the screen. Some terminal emulators record separate
contents for display-oriented programs such as Emacs and for ordinary
sequential display. If you are using such a terminal, you might want
......@@ -1809,7 +1809,7 @@ into a Lisp value as described above. However, in this case the
numeric height value specifies the line spacing, rather than the line
height.
On text-only terminals, the line spacing cannot be altered.
On text terminals, the line spacing cannot be altered.
@node Faces
@section Faces
......@@ -2058,7 +2058,7 @@ floating point and function values are not allowed.
Font weight---one of the symbols (from densest to faintest)
@code{ultra-bold}, @code{extra-bold}, @code{bold}, @code{semi-bold},
@code{normal}, @code{semi-light}, @code{light}, @code{extra-light}, or
@code{ultra-light}. On text-only terminals that support
@code{ultra-light}. On text terminals which support
variable-brightness text, any weight greater than normal is displayed
as extra bright, and any weight less than normal is displayed as
half-bright.
......@@ -2066,8 +2066,8 @@ half-bright.
@item :slant
Font slant---one of the symbols @code{italic}, @code{oblique},
@code{normal}, @code{reverse-italic}, or @code{reverse-oblique}. On
text-only terminals that support variable-brightness text, slanted
text is displayed as half-bright.
text terminals that support variable-brightness text, slanted text is
displayed as half-bright.
@item :foreground
Foreground color, a string. The value can be a system-defined color
......@@ -3649,9 +3649,9 @@ this list.
Each variable on this list can have properties
@code{overlay-arrow-string} and @code{overlay-arrow-bitmap} that
specify an overlay arrow string (for text-only terminals) or fringe
bitmap (for graphical terminals) to display at the corresponding
overlay arrow position. If either property is not set, the default
specify an overlay arrow string (for text terminals) or fringe bitmap
(for graphical terminals) to display at the corresponding overlay
arrow position. If either property is not set, the default
@code{overlay-arrow-string} or @code{overlay-arrow} fringe indicator
is used.
......@@ -6043,8 +6043,8 @@ This is a synonym for @code{ding}.
@defopt visible-bell
This variable determines whether Emacs should flash the screen to
represent a bell. Non-@code{nil} means yes, @code{nil} means no. This
is effective on graphical displays, and on text-only terminals
represent a bell. Non-@code{nil} means yes, @code{nil} means no.
This is effective on graphical displays, and on text terminals
provided the terminal's Termcap entry defines the visible bell
capability (@samp{vb}).
@end defopt
......@@ -6340,7 +6340,7 @@ such changes affect all of Emacs display.
they appear in a buffer, but in some special way (e.g. as a box
containing a hexadecimal code). These include characters that cannot
be displayed with any available font (on a graphical display), or that
cannot be encoded by the terminal's coding system (on a text-only
cannot be encoded by the terminal's coding system (on a text
terminal). Specific characters can also be defined to be glyphless.
@defvar glyphless-char-display
......@@ -6355,7 +6355,7 @@ Don't display the character.
@item @code{thin-space}
Display a thin space, 1-pixel wide on graphical displays, or
1-character wide on text-only terminals.
1-character wide on text terminals.
@item @code{empty-box}
Display an empty box.
......@@ -6374,7 +6374,7 @@ Except for @code{zero-width}, these methods display using the
An entry can also be a cons cell @code{(@var{graphical}
. @var{text})}, where @var{graphical} and @var{text} are the display
methods on graphical displays and text-only terminals respectively.
methods on graphical displays and text terminals respectively.
The char-table has one extra slot, which determines how to display any
character that cannot be displayed with any available font, or cannot
......
......@@ -972,7 +972,7 @@ Frames
* Window System Selections::Transferring text to and from other X clients.
* Drag and Drop:: Internals of Drag-and-Drop implementation.
* Color Names:: Getting the definitions of color names.
* Text Terminal Colors:: Defining colors for text-only terminals.
* Text Terminal Colors:: Defining colors for text terminals.
* Resources:: Getting resource values from the server.
* Display Feature Testing:: Determining the features of a terminal.
......
This diff is collapsed.
......@@ -101,8 +101,8 @@ even earlier than this.)
It runs the normal hook @code{before-init-hook}.
@item
It initializes the window frame and faces, if appropriate, and turns
on the menu bar and tool bar, if the initial frame needs them.
It initializes the initial frame's faces, and turns on the menu bar
and tool bar if needed.
@item
It loads the library @file{site-start}, if it exists. This is not
......@@ -144,7 +144,7 @@ If the buffer @samp{*scratch*} exists and is still in Fundamental mode
@code{initial-major-mode}.
@item
If started on a text-only terminal, it loads the terminal-specific
If started on a text terminal, it loads the terminal-specific
Lisp library, which is specified by the variable
@code{term-file-prefix} (@pxref{Terminal-Specific}). This is not done
in @code{--batch} mode, nor if @code{term-file-prefix} is @code{nil}.
......@@ -600,7 +600,7 @@ directly does not run this hook.
@subsection Suspending Emacs
@cindex suspending Emacs
On text-only terminals, it is possible to @dfn{suspend Emacs}, which
On text terminals, it is possible to @dfn{suspend Emacs}, which
means stopping Emacs temporarily and returning control to its superior
process, which is usually the shell. This allows you to resume
editing later in the same Emacs process, with the same buffers, the
......@@ -740,10 +740,10 @@ terminal object, a frame (meaning the terminal for that frame), or
@deffn Command suspend-frame
This command @dfn{suspends} a frame. For GUI frames, it calls
@code{iconify-frame} (@pxref{Visibility of Frames}); for text-only
frames, it calls either @code{suspend-emacs} or @code{suspend-tty},
depending on whether the frame is displayed on the controlling
terminal device or not.
@code{iconify-frame} (@pxref{Visibility of Frames}); for frames on
text terminals, it calls either @code{suspend-emacs} or
@code{suspend-tty}, depending on whether the frame is displayed on the
controlling terminal device or not.
@end deffn
@node System Environment
......
......@@ -994,7 +994,7 @@ Frames
* Window System Selections::Transferring text to and from other X clients.
* Drag and Drop:: Internals of Drag-and-Drop implementation.
* Color Names:: Getting the definitions of color names.
* Text Terminal Colors:: Defining colors for text-only terminals.
* Text Terminal Colors:: Defining colors for text terminals.
* Resources:: Getting resource values from the server.
* Display Feature Testing:: Determining the features of a terminal.
......
......@@ -993,7 +993,7 @@ Frames
* Window System Selections::Transferring text to and from other X clients.
* Drag and Drop:: Internals of Drag-and-Drop implementation.
* Color Names:: Getting the definitions of color names.
* Text Terminal Colors:: Defining colors for text-only terminals.
* Text Terminal Colors:: Defining colors for text terminals.
* Resources:: Getting resource values from the server.
* Display Feature Testing:: Determining the features of a terminal.
......
......@@ -68,7 +68,7 @@ window, and the contents of the selected message in another window.
graphical desktop environments and window systems, such as the X
Window System. When Emacs is run on X, each of its graphical X
windows is an Emacs frame (containing one or more Emacs windows).
When Emacs is run on a text-only terminal, the frame fills the entire
When Emacs is run on a text terminal, the frame fills the entire
terminal screen.
@cindex tiled windows
......@@ -2964,8 +2964,8 @@ the bottommost row.
Note that these are the actual outer edges of the window, including
any header line, mode line, scroll bar, fringes, and display margins.
On a text-only terminal, if the window has a neighbor on its right,
its right edge includes the separator line between the window and its
On a text terminal, if the window has a neighbor on its right, its
right edge includes the separator line between the window and its
neighbor.
@end defun
......@@ -3046,8 +3046,8 @@ argument because it always uses the frame that @var{window} is on.
The following functions return window positions in pixels, rather
than character units. Though mostly useful on graphical displays,
they can also be called on text-only terminals, where the screen area
of each text character is taken to be ``one pixel''.
they can also be called on text terminals, where the screen area of
each text character is taken to be ``one pixel''.
@defun window-pixel-edges &optional window
This function returns a list of pixel coordinates for the edges of
......
......@@ -542,7 +542,6 @@ point motion, do not alter the primary selection.
*** mouse-2 is now bound to `mouse-yank-primary'.
This pastes from the primary selection, ignoring the kill-ring.
Previously, mouse-2 was bound to `mouse-yank-at-click'.
+++
*** `x-select-enable-clipboard' now defaults to t on all platforms.
+++
......@@ -569,7 +568,7 @@ between applications.
+++
*** Support for X cut buffers has been removed.
+++
*** X clipboard managers are now supported.
To inhibit this, change `x-select-enable-clipboard-manager' to nil.
......@@ -1118,7 +1117,9 @@ x-make-font-unitalic (make-face-unitalic),
mldrag-drag-mode-line (mouse-drag-mode-line),
mldrag-drag-vertical-line (mouse-drag-vertical-line),
iswitchb-default-keybindings (iswitchb-mode), char-bytes (== 1),
isearch-return-char (isearch-printing-char), make-local-hook (not needed)
isearch-return-char (isearch-printing-char), make-local-hook (not needed),
set-screen-height (set-frame-height), set-screen-width (set-frame-width)
+++
** The following obsolete (mostly since at least 21.1) variables and varaliases
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment