comparison man/frames.texi @ 89909:68c22ea6027c

Sync to HEAD

89908:ee1402f7b568

* Multiple Displays::   How one Emacs job can talk to several displays.
* Special Buffer Frames::  You can make certain buffers have their own frames.
* Frame Parameters::    Changing the colors and other modes of frames.
* Scroll Bars::	        How to enable and disable scroll bars; how to use them.
* Wheeled Mice::        Using mouse wheels for scrolling.
* Menu Bars::	        Enabling and disabling the menu bar.
* Tool Bars::           Enabling and disabling the tool bar.
* Dialog Boxes::        Controlling use of dialog boxes.
* Tooltips::            Showing "tooltips", AKA "balloon help" for active text.
* Mouse Avoidance::     Moving the mouse pointer out of the way.

@kindex DELETE @r{(and mouse selection)}
  If you select a region with any of these mouse commands, and then
immediately afterward type the @key{DELETE} function key, it deletes the
region that you selected.  The @key{BACKSPACE} function key and the
ASCII character @key{DEL} do not do this; if you type any other key
in between the mouse command and @key{DELETE}, it does not do this.

@findex mouse-set-region
@findex mouse-set-point
@findex mouse-yank-at-click

@vindex mouse-wheel-scroll-amount
  The variables @code{mouse-wheel-follow-mouse} and
@code{mouse-wheel-scroll-amount} determine where and by how much
buffers are scrolled.

@node Menu Bars
@section Menu Bars
@cindex Menu Bar mode
@cindex mode, Menu Bar

invoke the command to begin with.

  You can customize the option @code{use-dialog-box} to suppress the
use of dialog boxes.  This also controls whether to use file selection
windows (but those are not supported on all platforms).

@node Tooltips
@section Tooltips (or ``Balloon Help'')

@cindex balloon help

mouse---only single clicks are supported.  The normal @code{xterm} mouse
functionality is still available by holding down the @kbd{SHIFT} key
when you press the mouse button.  The Linux console supports this
mode if it has support for the mouse enabled, e.g.@: using the
@command{gpm} daemon.

89909:68c22ea6027c

* Multiple Displays::   How one Emacs job can talk to several displays.
* Special Buffer Frames::  You can make certain buffers have their own frames.
* Frame Parameters::    Changing the colors and other modes of frames.
* Scroll Bars::	        How to enable and disable scroll bars; how to use them.
* Wheeled Mice::        Using mouse wheels for scrolling.
* Drag and drop::       Using drag and drop to open files and insert text.
* Menu Bars::	        Enabling and disabling the menu bar.
* Tool Bars::           Enabling and disabling the tool bar.
* Dialog Boxes::        Controlling use of dialog boxes.
* Tooltips::            Showing "tooltips", AKA "balloon help" for active text.
* Mouse Avoidance::     Moving the mouse pointer out of the way.

@kindex DELETE @r{(and mouse selection)}
  If you select a region with any of these mouse commands, and then
immediately afterward type the @key{DELETE} function key, it deletes the
region that you selected.  The @key{BACKSPACE} function key and the
@acronym{ASCII} character @key{DEL} do not do this; if you type any other key
in between the mouse command and @key{DELETE}, it does not do this.

@findex mouse-set-region
@findex mouse-set-point
@findex mouse-yank-at-click

@vindex mouse-wheel-scroll-amount
  The variables @code{mouse-wheel-follow-mouse} and
@code{mouse-wheel-scroll-amount} determine where and by how much
buffers are scrolled.

@node Drag and drop
@section Drag and drop in Emacs.

@cindex drag and drop
  Emacs supports drag and drop so that dropping of files and text is handeled.
Currently supported drag and drop protocols are XDND, Motif and the old
KDE 1.x protocol.  There is no drag support yet. 
When text is dropped on Emacs, Emacs inserts the text where it is dropped.
When a file is dragged from a file manager to Emacs, Emacs opens that file.
As a special case, if a file is dropped on a dired buffer the file is
copied or moved (depends on exactly how it is dragged and the application
it was dragged from) to the directory the dired buffer is displaying.

@vindex x-dnd-open-file-other-window
  A file is normally opened in the window it is dropped on, but if you
prefer the file to be opened in a new window you can customize the variable
@code{x-dnd-open-file-other-window}.

@vindex x-dnd-types-alist
  If you want to change the way Emacs handles drop of different types
or add a new type, you shall customize @code{x-dnd-types-alist}.  This
requires detailed knowledge of what types other applications use
for drag and drop.

@vindex x-dnd-protocol-alist
  When an URL is dropped on Emacs it may be a file, but it may also be
another URL type (ftp, http, etc.).  Emacs first checks
@code{x-dnd-protocol-alist} to determine what to do with the URL.  If there
is no match there and if @code{browse-url-browser-function} is an alist,
Emacs looks for a match there.  If no match is found the text for the URL
is inserted.  If you want to alter Emacs behaviour you can customize these
variables.


@node Menu Bars
@section Menu Bars
@cindex Menu Bar mode
@cindex mode, Menu Bar

invoke the command to begin with.

  You can customize the option @code{use-dialog-box} to suppress the
use of dialog boxes.  This also controls whether to use file selection
windows (but those are not supported on all platforms).

@vindex use-file-dialog
  A file selection window is a special kind of dialog box for asking for
file names.

  You can customize the option @code{use-file-dialog} to suppress the
use of file selection windows even if you still want other kinds
of dialogs.  This option has no effect if you have supressed all dialog
boxes with the option @code{use-dialog-box}.


@node Tooltips
@section Tooltips (or ``Balloon Help'')

@cindex balloon help

mouse---only single clicks are supported.  The normal @code{xterm} mouse
functionality is still available by holding down the @kbd{SHIFT} key
when you press the mouse button.  The Linux console supports this
mode if it has support for the mouse enabled, e.g.@: using the
@command{gpm} daemon.

@ignore
   arch-tag: 7dcf3a31-a43b-45d4-a900-445b10d77e49
@end ignore