procyberian/emacs
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Fix macOS drag n drop event documentation

Browse source 
* doc/emacs/macos.texi (Mac / GNUstep Customization): Remove
references to color panel.
(Mac / GNUstep Events): Remove ns-drag-file, and add ns-drag-n-drop.
This commit is contained in:
Alan Third 2018-04-21 14:32:50 +01:00
parent 5de608f3ed
commit 88d178ce94
1 changed files with 9 additions and 32 deletions
Download patch file Download diff file Expand all files Collapse all files

41
doc/emacs/macos.texi
View file

@ -107,30 +107,16 @@ Nextstep port. For example, they affect things such as the modifier
keys and the fullscreen behavior. To see all such options, use keys and the fullscreen behavior. To see all such options, use
@kbd{M-x customize-group @key{RET} ns @key{RET}}. @kbd{M-x customize-group @key{RET} ns @key{RET}}.
@subsection Font and Color Panels @subsection Font Panel
@findex ns-popup-font-panel @findex ns-popup-font-panel
The standard Mac / GNUstep font and color panels are accessible via The standard Mac / GNUstep font panel is accessible with @kbd{M-x
Lisp commands. The Font Panel may be accessed with @kbd{M-x ns-popup-font-panel} and will set the default font in the frame most
ns-popup-font-panel}. It will set the default font in the frame most
recently used or clicked on. recently used or clicked on.
@c To make the setting permanent, use @samp{Save Options} in the @c To make the setting permanent, use @samp{Save Options} in the
@c Options menu, or run @code{menu-bar-options-save}. @c Options menu, or run @code{menu-bar-options-save}.
@findex ns-popup-color-panel
You can bring up a color panel with @kbd{M-x ns-popup-color-panel} and
drag the color you want over the Emacs face you want to change. Normal
dragging will alter the foreground color. Shift dragging will alter the
background color. To discard the settings, create a new frame and
close the altered one.
@c To make the changes permanent select the "Save Options"
@c item in the "Options" menu, or run @code{menu-bar-options-save}.
Useful in this context is the listing of all faces obtained by
@kbd{M-x list-faces-display}.
@cindex Core Text, on macOS @cindex Core Text, on macOS
@cindex font backend, on macOS @cindex font backend, on macOS
In macOS, Emacs uses a Core Text based font backend In macOS, Emacs uses a Core Text based font backend
@ -180,21 +166,12 @@ particular file, but also a particular line or sequence of lines in
the file. Emacs handles this by visiting that file and highlighting the file. Emacs handles this by visiting that file and highlighting
the requested line (@code{ns-open-file-select-line}). the requested line (@code{ns-open-file-select-line}).
@item ns-drag-file @item ns-drag-n-drop
This event occurs when a user drags files from another application This event occurs when a user drags an object from another application
into an Emacs frame. The default behavior is to insert the contents into an Emacs frame. The default behavior is to open a file in the
of all the dragged files into the current buffer current window, or to insert text in the buffer it is dropped into.
(@code{ns-insert-files}). The list of dragged files is stored in the It may sometimes be necessary to use the @key{META} key in conjunction
variable @code{ns-input-file}. with dragging to force text insertion.
@item ns-drag-color
This event occurs when a user drags a color from the color well (or
some other source) into an Emacs frame. The default behavior is to
alter the foreground color of the area the color was dragged onto
(@code{ns-set-foreground-at-mouse}). If this event is issued with a
@key{Shift} modifier, Emacs changes the background color instead
(@code{ns-set-background-at-mouse}). The name of the dragged color is
stored in the variable @code{ns-input-color}.
@item ns-change-font @item ns-change-font
This event occurs when the user selects a font in a Nextstep font This event occurs when the user selects a font in a Nextstep font