aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlan Third2018-04-21 14:32:50 +0100
committerAlan Third2018-04-21 14:35:02 +0100
commit88d178ce9411c2c50498ef131e4a3f374a0618fc (patch)
tree256af2931f54a5f85de093154ee47a0da8d18864
parent5de608f3edb54b4f8d9774e159d0fa99484d3ac8 (diff)
downloademacs-88d178ce9411c2c50498ef131e4a3f374a0618fc.tar.gz
emacs-88d178ce9411c2c50498ef131e4a3f374a0618fc.zip
Fix macOS drag n drop event documentation
* 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.
-rw-r--r--doc/emacs/macos.texi41
1 files changed, 9 insertions, 32 deletions
diff --git a/doc/emacs/macos.texi b/doc/emacs/macos.texi
index ef2e9448902..6a713271abc 100644
--- a/doc/emacs/macos.texi
+++ b/doc/emacs/macos.texi
@@ -107,30 +107,16 @@ Nextstep port. For example, they affect things such as the modifier
107keys and the fullscreen behavior. To see all such options, use 107keys and the fullscreen behavior. To see all such options, use
108@kbd{M-x customize-group @key{RET} ns @key{RET}}. 108@kbd{M-x customize-group @key{RET} ns @key{RET}}.
109 109
110@subsection Font and Color Panels 110@subsection Font Panel
111 111
112@findex ns-popup-font-panel 112@findex ns-popup-font-panel
113The standard Mac / GNUstep font and color panels are accessible via 113The standard Mac / GNUstep font panel is accessible with @kbd{M-x
114Lisp commands. The Font Panel may be accessed with @kbd{M-x 114ns-popup-font-panel} and will set the default font in the frame most
115ns-popup-font-panel}. It will set the default font in the frame most
116recently used or clicked on. 115recently used or clicked on.
117 116
118@c To make the setting permanent, use @samp{Save Options} in the 117@c To make the setting permanent, use @samp{Save Options} in the
119@c Options menu, or run @code{menu-bar-options-save}. 118@c Options menu, or run @code{menu-bar-options-save}.
120 119
121@findex ns-popup-color-panel
122You can bring up a color panel with @kbd{M-x ns-popup-color-panel} and
123drag the color you want over the Emacs face you want to change. Normal
124dragging will alter the foreground color. Shift dragging will alter the
125background color. To discard the settings, create a new frame and
126close the altered one.
127
128@c To make the changes permanent select the "Save Options"
129@c item in the "Options" menu, or run @code{menu-bar-options-save}.
130
131Useful in this context is the listing of all faces obtained by
132@kbd{M-x list-faces-display}.
133
134@cindex Core Text, on macOS 120@cindex Core Text, on macOS
135@cindex font backend, on macOS 121@cindex font backend, on macOS
136In macOS, Emacs uses a Core Text based font backend 122In 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
180the file. Emacs handles this by visiting that file and highlighting 166the file. Emacs handles this by visiting that file and highlighting
181the requested line (@code{ns-open-file-select-line}). 167the requested line (@code{ns-open-file-select-line}).
182 168
183@item ns-drag-file 169@item ns-drag-n-drop
184This event occurs when a user drags files from another application 170This event occurs when a user drags an object from another application
185into an Emacs frame. The default behavior is to insert the contents 171into an Emacs frame. The default behavior is to open a file in the
186of all the dragged files into the current buffer 172current window, or to insert text in the buffer it is dropped into.
187(@code{ns-insert-files}). The list of dragged files is stored in the 173It may sometimes be necessary to use the @key{META} key in conjunction
188variable @code{ns-input-file}. 174with dragging to force text insertion.
189
190@item ns-drag-color
191This event occurs when a user drags a color from the color well (or
192some other source) into an Emacs frame. The default behavior is to
193alter the foreground color of the area the color was dragged onto
194(@code{ns-set-foreground-at-mouse}). If this event is issued with a
195@key{Shift} modifier, Emacs changes the background color instead
196(@code{ns-set-background-at-mouse}). The name of the dragged color is
197stored in the variable @code{ns-input-color}.
198 175
199@item ns-change-font 176@item ns-change-font
200This event occurs when the user selects a font in a Nextstep font 177This event occurs when the user selects a font in a Nextstep font