emacs-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Emacs-diffs] Changes to emacs/man/frames.texi


From: Richard M . Stallman
Subject: [Emacs-diffs] Changes to emacs/man/frames.texi
Date: Thu, 03 Feb 2005 02:29:04 -0500

Index: emacs/man/frames.texi
diff -c emacs/man/frames.texi:1.69 emacs/man/frames.texi:1.70
*** emacs/man/frames.texi:1.69  Sun Jan 30 11:14:20 2005
--- emacs/man/frames.texi       Thu Feb  3 07:29:03 2005
***************
*** 29,38 ****
  so that you can use many of the features described in this chapter.
  @xref{MS-DOS Input}, for more information.
  
- @cindex MS Windows
-   Emacs compiled for MS Windows mostly supports the same features as
- under X.
- 
  @menu
  * Mouse Commands::      Moving, cutting, and pasting, with the mouse.
  * Secondary Selection:: Cutting without altering point and mark.
--- 29,34 ----
***************
*** 64,70 ****
  
    The mouse commands for selecting and copying a region are mostly
  compatible with the @code{xterm} program.  You can use the same mouse
! commands for copying between Emacs and other X client programs.
  
  @kindex DELETE @r{(and mouse selection)}
    If you select a region with any of these mouse commands, and then
--- 60,68 ----
  
    The mouse commands for selecting and copying a region are mostly
  compatible with the @code{xterm} program.  You can use the same mouse
! commands for copying between Emacs and other window-based programs.
! Most of these commands also work in Emacs when you run it under an
! @code{xterm} terminal.
  
  @kindex DELETE @r{(and mouse selection)}
    If you select a region with any of these mouse commands, and then
***************
*** 188,195 ****
  system for X selections, use @kbd{C-x @key{RET} x} or @kbd{C-x
  @key{RET} X}.  @xref{Specify Coding}.
  
-   These cutting and pasting commands also work on MS-Windows.
- 
  @cindex primary selection
  @cindex cut buffer
  @cindex selection, primary
--- 186,191 ----
***************
*** 270,276 ****
  @cindex OpenWindows
  @cindex Gnome
  
!   As well as the primary and secondary selection types, X supports a
  @dfn{clipboard} selection type which is used by some applications,
  particularly under OpenWindows and Gnome.
  
--- 266,272 ----
  @cindex OpenWindows
  @cindex Gnome
  
!   Apart from the primary and secondary selection types, X supports a
  @dfn{clipboard} selection type which is used by some applications,
  particularly under OpenWindows and Gnome.
  
***************
*** 287,314 ****
  
  @node Mouse References
  @section Following References with the Mouse
  @kindex Mouse-2 @r{(selection)}
  
!   Some Emacs buffers display lists of various sorts.  These include
! lists of files, of buffers, of possible completions, of matches for
! a pattern, and so on.
! 
!   Since yanking text into these buffers is not very useful, most of them
! define @kbd{Mouse-2} specially, as a command to use or view the item you
! click on.
! 
!   For example, if you click @kbd{Mouse-2} on a file name in a Dired
! buffer, you visit that file.  If you click @kbd{Mouse-2} on an error
! message in the @samp{*Compilation*} buffer, you go to the source code
! for that error message.  If you click @kbd{Mouse-2} on a completion in
! the @samp{*Completions*} buffer, you choose that completion.
  
  @vindex mouse-highlight
!   You can usually tell when @kbd{Mouse-2} has this special sort of
! meaning because the sensitive text highlights when you move the mouse
! over it.  The variable @code{mouse-highlight} controls whether to do
! this highlighting always (even when such text appears where the mouse
! already is), never, or only immediately after you move the mouse.
  
  @node Menu Mouse Clicks
  @section Mouse Clicks for Menus
--- 283,324 ----
  
  @node Mouse References
  @section Following References with the Mouse
+ @kindex Mouse-1 @r{(selection)}
  @kindex Mouse-2 @r{(selection)}
  
!   Some read-only Emacs buffers include references you can follow, or
! commands you can activate.  These include names of files, of buffers,
! of possible completions, of matches for a pattern, as well as the
! buttons in Help buffers and customization buffers.  You can follow the
! reference or activate the command by moving point to it and typing
! @key{RET}.  You can also do this with the mouse, using either
! @kbd{Mouse-1} or @kbd{Mouse-2}.
! 
!   Since yanking text into a read-only buffer is not allowed, these
! buffers generally define @kbd{Mouse-2} to follow a reference or
! activate a command.  For example, if you click @kbd{Mouse-2} on a file
! name in a Dired buffer, you visit that file.  If you click
! @kbd{Mouse-2} on an error message in the @samp{*Compilation*} buffer,
! you go to the source code for that error message.  If you click
! @kbd{Mouse-2} on a completion in the @samp{*Completions*} buffer, you
! choose that completion.
! 
! @vindex mouse-1-click-follows-link
!   However, most applications use @kbd{Mouse-1} to do this sort of
! thing, so Emacs implements this too.  If you click @kbd{Mouse-1}
! quickly on a reference or button, it follows or activates.  If you
! click slowly, it moves point as usual.  Dragging, meaning moving the
! mouse while it is held down, also has its usual behavior of setting
! the region.  The variable @code{mouse-1-click-follows-link} controls
! whether @kbd{Mouse-1} has this behavior.
  
  @vindex mouse-highlight
!   You can usually tell when @kbd{Mouse-1} and @kbd{Mouse-2} have this
! special sort of meaning because the sensitive text highlights when you
! move the mouse over it.  The variable @code{mouse-highlight} controls
! whether to do this highlighting always (even when such text appears
! where the mouse already is), never, or only immediately after you move
! the mouse.
  
  @node Menu Mouse Clicks
  @section Mouse Clicks for Menus
***************
*** 331,346 ****
  
  @item C-Mouse-3
  @kindex C-Mouse-3
! This menu is mode-specific.  For most modes if Menu-bar mode is on, this
! menu has the same items as all the mode-specific menu-bar menus put
! together.  Some modes may specify a different menu for this
  address@hidden systems use @kbd{Mouse-3} for a mode-specific
  menu.  We took a survey of users, and found they preferred to keep
! @kbd{Mouse-3} for selecting and killing regions.  Hence the decision to
! use @kbd{C-Mouse-3} for this menu.}  If Menu-bar mode is off, this menu
! contains all the items which would be present in the menu bar---not just
! the mode-specific ones---so that you can access them without having to
! display the menu bar.
  
  @item S-Mouse-1
  This menu is for specifying the frame's principal font.
--- 341,357 ----
  
  @item C-Mouse-3
  @kindex C-Mouse-3
! This menu is mode-specific.  For most modes if Menu-bar mode is on,
! this menu has the same items as all the mode-specific menu-bar menus
! put together.  Some modes may specify a different menu for this
  address@hidden systems use @kbd{Mouse-3} for a mode-specific
  menu.  We took a survey of users, and found they preferred to keep
! @kbd{Mouse-3} for selecting and killing regions.  Hence the decision
! to use @kbd{C-Mouse-3} for this menu.  To use @kbd{Mouse-3} instead,
! do @code{(global-set-key [mouse-3] 'mouse-popup-menubar-stuff)}.}  If
! Menu-bar mode is off, this menu contains all the items which would be
! present in the menu bar---not just the mode-specific ones---so that
! you can access them without having to display the menu bar.
  
  @item S-Mouse-1
  This menu is for specifying the frame's principal font.
***************
*** 357,365 ****
  @table @kbd
  @item Mouse-1
  @kindex Mouse-1 @r{(mode line)}
! @kbd{Mouse-1} on a mode line selects the window above.  By dragging
! @kbd{Mouse-1} on the mode line, you can move it, thus changing the
! height of the windows above and below.
  
  @item Mouse-2
  @kindex Mouse-2 @r{(mode line)}
--- 368,376 ----
  @table @kbd
  @item Mouse-1
  @kindex Mouse-1 @r{(mode line)}
! @kbd{Mouse-1} on a mode line selects the window it belongs to.  By
! dragging @kbd{Mouse-1} on the mode line, you can move it, thus
! changing the height of the windows above and below.
  
  @item Mouse-2
  @kindex Mouse-2 @r{(mode line)}
***************
*** 367,375 ****
  
  @item Mouse-3
  @kindex Mouse-3 @r{(mode line)}
! @kbd{Mouse-3} on a mode line deletes the window above.  If the frame has
! only one window, it buries the current buffer instead and switches to
! another buffer.
  
  @item C-Mouse-2
  @kindex C-mouse-2 @r{(mode line)}
--- 378,386 ----
  
  @item Mouse-3
  @kindex Mouse-3 @r{(mode line)}
! @kbd{Mouse-3} on a mode line deletes the window it belongs to.  If the
! frame has only one window, it buries the current buffer instead, and
! switches to another buffer.
  
  @item C-Mouse-2
  @kindex C-mouse-2 @r{(mode line)}
***************
*** 798,816 ****
  @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 handled.
- 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-test-function
  @vindex x-dnd-known-types
    When a user drags something from another application over Emacs, that other
--- 809,832 ----
  @code{mouse-wheel-scroll-amount} determine where and by how much
  buffers are scrolled.
  
! @node Drag and Drop
! @section Drag and Drop
  @cindex drag and drop
  
+   Emacs supports @cindex{drag and drop} using the mouse.  For
+ instance, dropping text onto an Emacs frame inserts the text where it
+ is dropped.  Dropping a file onto an Emacs frame visits that file.  As
+ a special case, dropping the file on a Dired buffer moves or copies
+ the file (according to the conventions of the application it came
+ from) into the directory displayed in that buffer.
+ 
+ @vindex x-dnd-open-file-other-window
+   Dropping a file normally visits it in the window you drop it on.  If
+ you prefer to visit the file in a new window in such cases, customize
+ the variable @code{x-dnd-open-file-other-window}.
+ 
+ @ignore
+ @c ??? To Lisp manual
  @vindex x-dnd-test-function
  @vindex x-dnd-known-types
    When a user drags something from another application over Emacs, that other
***************
*** 822,847 ****
  @code{x-dnd-known-types} if you want Emacs to accept or reject drops based
  on some other criteria.
  
- @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
--- 838,861 ----
  @code{x-dnd-known-types} if you want Emacs to accept or reject drops based
  on some other criteria.
  
  @vindex x-dnd-types-alist
    If you want to change the way Emacs handles drop of different types
! or add a new type, 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 behavior,
! you can customize these variables.
! @end ignore
  
+   The drag and drop protocols XDND, Motif and the
+ old KDE 1.x protocol are currently supported.
  
  @node Menu Bars
  @section Menu Bars
***************
*** 873,892 ****
  @cindex mode, Tool Bar
  @cindex icons, toolbar
  
! The @dfn{tool bar} is a line (or multiple lines) of icons at the top
! of the Emacs window.  You can click on these icons with the mouse
! to do various jobs.
  
! The global tool bar contains general commands.  Some major modes
  define their own tool bars to replace it.  A few ``special'' modes
  that are not designed for ordinary editing remove some items from the
  global tool bar.
  
! Tool bars work only on a graphical display.  The tool bar uses colored
  XPM icons if Emacs was built with XPM support.  Otherwise, the tool
  bar uses monochrome icons (PBM or XBM format).
  
! You can turn display of tool bars on or off with @kbd{M-x
  tool-bar-mode}.
  
  @node Dialog Boxes
--- 887,906 ----
  @cindex mode, Tool Bar
  @cindex icons, toolbar
  
!   The @dfn{tool bar} is a line (or lines) of icons at the top of the
! Emacs window, just below the menu bar.  You can click on these icons
! with the mouse to do various jobs.
  
!   The global tool bar contains general commands.  Some major modes
  define their own tool bars to replace it.  A few ``special'' modes
  that are not designed for ordinary editing remove some items from the
  global tool bar.
  
!   Tool bars work only on a graphical display.  The tool bar uses colored
  XPM icons if Emacs was built with XPM support.  Otherwise, the tool
  bar uses monochrome icons (PBM or XBM format).
  
!   You can turn display of tool bars on or off with @kbd{M-x
  tool-bar-mode}.
  
  @node Dialog Boxes




reply via email to

[Prev in Thread] Current Thread [Next in Thread]