Commit a08a07e3 authored by Chong Yidong's avatar Chong Yidong
Browse files

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 ...@@ -197,7 +197,7 @@ elisp.texi
errors.texi rgm errors.texi rgm
eval.texi cyd eval.texi cyd
files.texi cyd files.texi cyd
frames.texi frames.texi cyd
functions.texi cyd functions.texi cyd
hash.texi cyd hash.texi cyd
help.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> 2012-02-29 Glenn Morris <rgm@gnu.org>
* ack.texi (Acknowledgments): Use @Tex{} in more places. * ack.texi (Acknowledgments): Use @Tex{} in more places.
......
...@@ -490,6 +490,17 @@ new yank to the clipboard. ...@@ -490,6 +490,17 @@ new yank to the clipboard.
To prevent kill and yank commands from accessing the clipboard, To prevent kill and yank commands from accessing the clipboard,
change the variable @code{x-select-enable-clipboard} to @code{nil}. 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 @vindex x-select-enable-primary
@findex clipboard-kill-region @findex clipboard-kill-region
@findex clipboard-kill-ring-save @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> 2012-03-04 Glenn Morris <rgm@gnu.org>
* abbrevs.texi: Small copyedits throughout. * abbrevs.texi: Small copyedits throughout.
......
...@@ -93,9 +93,9 @@ are always drawn using the X core font driver. ...@@ -93,9 +93,9 @@ are always drawn using the X core font driver.
@item @item
Display terminals are no longer represented using a ``terminal'' data Display terminals are no longer represented using a ``terminal'' data
type; this is not necessary, because we have removed the ability to type; this is not necessary, because we have removed the ability to
display on graphical and text-only terminals simultaneously. For the display on graphical and text terminals simultaneously. For the same
same reason, the @code{window-system} variable is no longer reason, the @code{window-system} variable is no longer frame-local,
frame-local, and the @code{window-system} function has been removed. and the @code{window-system} function has been removed.
@item @item
The functions @code{list-system-processes} and The functions @code{list-system-processes} and
......
...@@ -62,7 +62,7 @@ you call these functions when input is available, they don't redisplay ...@@ -62,7 +62,7 @@ you call these functions when input is available, they don't redisplay
immediately, but the requested redisplay does happen immediately, but the requested redisplay does happen
eventually---after all the input has been processed. 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 refreshes the screen. Some terminal emulators record separate
contents for display-oriented programs such as Emacs and for ordinary contents for display-oriented programs such as Emacs and for ordinary
sequential display. If you are using such a terminal, you might want 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 ...@@ -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 numeric height value specifies the line spacing, rather than the line
height. height.
On text-only terminals, the line spacing cannot be altered. On text terminals, the line spacing cannot be altered.
@node Faces @node Faces
@section Faces @section Faces
...@@ -2058,7 +2058,7 @@ floating point and function values are not allowed. ...@@ -2058,7 +2058,7 @@ floating point and function values are not allowed.
Font weight---one of the symbols (from densest to faintest) Font weight---one of the symbols (from densest to faintest)
@code{ultra-bold}, @code{extra-bold}, @code{bold}, @code{semi-bold}, @code{ultra-bold}, @code{extra-bold}, @code{bold}, @code{semi-bold},
@code{normal}, @code{semi-light}, @code{light}, @code{extra-light}, or @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 variable-brightness text, any weight greater than normal is displayed
as extra bright, and any weight less than normal is displayed as as extra bright, and any weight less than normal is displayed as
half-bright. half-bright.
...@@ -2066,8 +2066,8 @@ half-bright. ...@@ -2066,8 +2066,8 @@ half-bright.
@item :slant @item :slant
Font slant---one of the symbols @code{italic}, @code{oblique}, Font slant---one of the symbols @code{italic}, @code{oblique},
@code{normal}, @code{reverse-italic}, or @code{reverse-oblique}. On @code{normal}, @code{reverse-italic}, or @code{reverse-oblique}. On
text-only terminals that support variable-brightness text, slanted text terminals that support variable-brightness text, slanted text is
text is displayed as half-bright. displayed as half-bright.
@item :foreground @item :foreground
Foreground color, a string. The value can be a system-defined color Foreground color, a string. The value can be a system-defined color
...@@ -3649,9 +3649,9 @@ this list. ...@@ -3649,9 +3649,9 @@ this list.
Each variable on this list can have properties Each variable on this list can have properties
@code{overlay-arrow-string} and @code{overlay-arrow-bitmap} that @code{overlay-arrow-string} and @code{overlay-arrow-bitmap} that
specify an overlay arrow string (for text-only terminals) or fringe specify an overlay arrow string (for text terminals) or fringe bitmap
bitmap (for graphical terminals) to display at the corresponding (for graphical terminals) to display at the corresponding overlay
overlay arrow position. If either property is not set, the default arrow position. If either property is not set, the default
@code{overlay-arrow-string} or @code{overlay-arrow} fringe indicator @code{overlay-arrow-string} or @code{overlay-arrow} fringe indicator
is used. is used.
...@@ -6043,8 +6043,8 @@ This is a synonym for @code{ding}. ...@@ -6043,8 +6043,8 @@ This is a synonym for @code{ding}.
@defopt visible-bell @defopt visible-bell
This variable determines whether Emacs should flash the screen to This variable determines whether Emacs should flash the screen to
represent a bell. Non-@code{nil} means yes, @code{nil} means no. This represent a bell. Non-@code{nil} means yes, @code{nil} means no.
is effective on graphical displays, and on text-only terminals This is effective on graphical displays, and on text terminals
provided the terminal's Termcap entry defines the visible bell provided the terminal's Termcap entry defines the visible bell
capability (@samp{vb}). capability (@samp{vb}).
@end defopt @end defopt
...@@ -6340,7 +6340,7 @@ such changes affect all of Emacs display. ...@@ -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 they appear in a buffer, but in some special way (e.g. as a box
containing a hexadecimal code). These include characters that cannot containing a hexadecimal code). These include characters that cannot
be displayed with any available font (on a graphical display), or that 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. terminal). Specific characters can also be defined to be glyphless.
@defvar glyphless-char-display @defvar glyphless-char-display
...@@ -6355,7 +6355,7 @@ Don't display the character. ...@@ -6355,7 +6355,7 @@ Don't display the character.
@item @code{thin-space} @item @code{thin-space}
Display a thin space, 1-pixel wide on graphical displays, or 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} @item @code{empty-box}
Display an empty box. Display an empty box.
...@@ -6374,7 +6374,7 @@ Except for @code{zero-width}, these methods display using the ...@@ -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} An entry can also be a cons cell @code{(@var{graphical}
. @var{text})}, where @var{graphical} and @var{text} are the display . @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 The char-table has one extra slot, which determines how to display any
character that cannot be displayed with any available font, or cannot character that cannot be displayed with any available font, or cannot
......
...@@ -972,7 +972,7 @@ Frames ...@@ -972,7 +972,7 @@ Frames
* Window System Selections::Transferring text to and from other X clients. * Window System Selections::Transferring text to and from other X clients.
* Drag and Drop:: Internals of Drag-and-Drop implementation. * Drag and Drop:: Internals of Drag-and-Drop implementation.
* Color Names:: Getting the definitions of color names. * 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. * Resources:: Getting resource values from the server.
* Display Feature Testing:: Determining the features of a terminal. * Display Feature Testing:: Determining the features of a terminal.
......
This diff is collapsed.
...@@ -101,8 +101,8 @@ even earlier than this.) ...@@ -101,8 +101,8 @@ even earlier than this.)
It runs the normal hook @code{before-init-hook}. It runs the normal hook @code{before-init-hook}.
@item @item
It initializes the window frame and faces, if appropriate, and turns It initializes the initial frame's faces, and turns on the menu bar
on the menu bar and tool bar, if the initial frame needs them. and tool bar if needed.
@item @item
It loads the library @file{site-start}, if it exists. This is not 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 ...@@ -144,7 +144,7 @@ If the buffer @samp{*scratch*} exists and is still in Fundamental mode
@code{initial-major-mode}. @code{initial-major-mode}.
@item @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 Lisp library, which is specified by the variable
@code{term-file-prefix} (@pxref{Terminal-Specific}). This is not done @code{term-file-prefix} (@pxref{Terminal-Specific}). This is not done
in @code{--batch} mode, nor if @code{term-file-prefix} is @code{nil}. in @code{--batch} mode, nor if @code{term-file-prefix} is @code{nil}.
...@@ -600,7 +600,7 @@ directly does not run this hook. ...@@ -600,7 +600,7 @@ directly does not run this hook.
@subsection Suspending Emacs @subsection Suspending Emacs
@cindex 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 means stopping Emacs temporarily and returning control to its superior
process, which is usually the shell. This allows you to resume process, which is usually the shell. This allows you to resume
editing later in the same Emacs process, with the same buffers, the 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 ...@@ -740,10 +740,10 @@ terminal object, a frame (meaning the terminal for that frame), or
@deffn Command suspend-frame @deffn Command suspend-frame
This command @dfn{suspends} a frame. For GUI frames, it calls This command @dfn{suspends} a frame. For GUI frames, it calls
@code{iconify-frame} (@pxref{Visibility of Frames}); for text-only @code{iconify-frame} (@pxref{Visibility of Frames}); for frames on
frames, it calls either @code{suspend-emacs} or @code{suspend-tty}, text terminals, it calls either @code{suspend-emacs} or
depending on whether the frame is displayed on the controlling @code{suspend-tty}, depending on whether the frame is displayed on the
terminal device or not. controlling terminal device or not.
@end deffn @end deffn
@node System Environment @node System Environment
......
...@@ -994,7 +994,7 @@ Frames ...@@ -994,7 +994,7 @@ Frames
* Window System Selections::Transferring text to and from other X clients. * Window System Selections::Transferring text to and from other X clients.
* Drag and Drop:: Internals of Drag-and-Drop implementation. * Drag and Drop:: Internals of Drag-and-Drop implementation.
* Color Names:: Getting the definitions of color names. * 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. * Resources:: Getting resource values from the server.
* Display Feature Testing:: Determining the features of a terminal. * Display Feature Testing:: Determining the features of a terminal.
......
...@@ -993,7 +993,7 @@ Frames ...@@ -993,7 +993,7 @@ Frames
* Window System Selections::Transferring text to and from other X clients. * Window System Selections::Transferring text to and from other X clients.
* Drag and Drop:: Internals of Drag-and-Drop implementation. * Drag and Drop:: Internals of Drag-and-Drop implementation.
* Color Names:: Getting the definitions of color names. * 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. * Resources:: Getting resource values from the server.
* Display Feature Testing:: Determining the features of a terminal. * Display Feature Testing:: Determining the features of a terminal.
......
...@@ -68,7 +68,7 @@ window, and the contents of the selected message in another window. ...@@ -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 graphical desktop environments and window systems, such as the X
Window System. When Emacs is run on X, each of its graphical 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). 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. terminal screen.
@cindex tiled windows @cindex tiled windows
...@@ -2964,8 +2964,8 @@ the bottommost row. ...@@ -2964,8 +2964,8 @@ the bottommost row.
Note that these are the actual outer edges of the window, including Note that these are the actual outer edges of the window, including
any header line, mode line, scroll bar, fringes, and display margins. 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, On a text terminal, if the window has a neighbor on its right, its
its right edge includes the separator line between the window and its right edge includes the separator line between the window and its
neighbor. neighbor.
@end defun @end defun
...@@ -3046,8 +3046,8 @@ argument because it always uses the frame that @var{window} is on. ...@@ -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 The following functions return window positions in pixels, rather
than character units. Though mostly useful on graphical displays, than character units. Though mostly useful on graphical displays,
they can also be called on text-only terminals, where the screen area they can also be called on text terminals, where the screen area of
of each text character is taken to be ``one pixel''. each text character is taken to be ``one pixel''.
@defun window-pixel-edges &optional window @defun window-pixel-edges &optional window
This function returns a list of pixel coordinates for the edges of This function returns a list of pixel coordinates for the edges of
......
...@@ -542,7 +542,6 @@ point motion, do not alter the primary selection. ...@@ -542,7 +542,6 @@ point motion, do not alter the primary selection.
*** mouse-2 is now bound to `mouse-yank-primary'. *** mouse-2 is now bound to `mouse-yank-primary'.
This pastes from the primary selection, ignoring the kill-ring. This pastes from the primary selection, ignoring the kill-ring.
Previously, mouse-2 was bound to `mouse-yank-at-click'. Previously, mouse-2 was bound to `mouse-yank-at-click'.
+++ +++
*** `x-select-enable-clipboard' now defaults to t on all platforms. *** `x-select-enable-clipboard' now defaults to t on all platforms.
+++ +++
...@@ -569,7 +568,7 @@ between applications. ...@@ -569,7 +568,7 @@ between applications.
+++ +++
*** Support for X cut buffers has been removed. *** Support for X cut buffers has been removed.
+++
*** X clipboard managers are now supported. *** X clipboard managers are now supported.
To inhibit this, change `x-select-enable-clipboard-manager' to nil. To inhibit this, change `x-select-enable-clipboard-manager' to nil.
...@@ -1118,7 +1117,9 @@ x-make-font-unitalic (make-face-unitalic), ...@@ -1118,7 +1117,9 @@ x-make-font-unitalic (make-face-unitalic),
mldrag-drag-mode-line (mouse-drag-mode-line), mldrag-drag-mode-line (mouse-drag-mode-line),
mldrag-drag-vertical-line (mouse-drag-vertical-line), mldrag-drag-vertical-line (mouse-drag-vertical-line),
iswitchb-default-keybindings (iswitchb-mode), char-bytes (== 1), 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 ** 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