aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorAlan Third2020-03-07 14:39:05 +0000
committerAlan Third2020-03-07 14:41:47 +0000
commit72f87f88739befce2adf202749b7d651a8ef1551 (patch)
tree9643e7391041e86186a428bd7df859079db0b04e /doc
parent5b19db98adcfccf432ac40ccdad831723a4c1c06 (diff)
downloademacs-72f87f88739befce2adf202749b7d651a8ef1551.tar.gz
emacs-72f87f88739befce2adf202749b7d651a8ef1551.zip
NS port documentation updates
* doc/emacs/macos.texi (Mac / GNUstep Customization): Document some more of the ns- variables and remove incorrect font back-end information. * etc/NEWS: Update the documentation status of macOS news entries.
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/macos.texi69
1 files changed, 58 insertions, 11 deletions
diff --git a/doc/emacs/macos.texi b/doc/emacs/macos.texi
index ae1b8d654f0..00daa8b35d3 100644
--- a/doc/emacs/macos.texi
+++ b/doc/emacs/macos.texi
@@ -143,6 +143,64 @@ The variables for right-hand keys, like @code{ns-right-alternate-modifier},
143may also be set to @code{left}, which means to use the same behavior as 143may also be set to @code{left}, which means to use the same behavior as
144the corresponding left-hand key. 144the corresponding left-hand key.
145 145
146@subsection Frame Variables
147
148@table @code
149@vindex ns-use-proxy-icon
150@item ns-use-proxy-icon
151This variable specifies whether to display the proxy icon in the
152titlebar.
153
154@vindex ns-confirm-quit
155@item ns-confirm-quit
156This variable specifies whether to display a graphical confirmation
157dialogue on quitting.
158
159@vindex ns-auto-hide-menu-bar
160@item ns-auto-hide-menu-bar
161This variable specifies whether the macOS menu bar is hidden when an
162Emacs frame is selected. If non-nil the menu bar is not shown unless
163the mouse pointer is moved near to the top of the screen.
164
165@vindex ns-use-native-fullscreen
166@item ns-use-native-fullscreen
167This variable controls whether to use native, or non-native
168fullscreen. Native fullscreen is only available on macOS 10.7 and
169above.
170@end table
171
172@subsection macOS Trackpad/Mousewheel Variables
173
174These variables only apply to macOS 10.7 (Lion) and above.
175
176@table @code
177@vindex ns-use-mwheel-acceleration
178@item ns-use-mwheel-acceleration
179This variable controls whether Emacs ignores the system mousewheel
180acceleration. When nil each `click' of the mousewheel will correspond
181exactly with one mousewheel event. When non-nil, the default, each
182`click' may correspond with more than one mousewheel event, depending
183on the user's input.
184
185@vindex ns-use-mwheel-momentum
186@item ns-use-mwheel-momentum
187This variable controls whether Emacs ignores the system `momentum'
188when scrolling using a trackpad. When non-nil, the default, scrolling
189rapidly may result in the buffer continuing to scroll for a short
190while after the user has lifted their fingers off the trackpad.
191
192@vindex ns-mwheel-line-height
193@item ns-mwheel-line-height
194This variable controls the sensitivity of scrolling with the trackpad.
195Apple trackpads scroll by pixels, not lines, so Emacs converts the
196system's pixel values into lines. When set to a number, this variable
197sets the number of pixels Emacs will consider as one line. When nil
198or a non-number the default line height is used.
199
200Setting a lower number makes the trackpad more sensitive, and a higher
201number makes the trackpad less sensitive.
202@end table
203
146@subsection Font Panel 204@subsection Font Panel
147 205
148@findex ns-popup-font-panel 206@findex ns-popup-font-panel
@@ -153,17 +211,6 @@ recently used or clicked on.
153@c To make the setting permanent, use @samp{Save Options} in the 211@c To make the setting permanent, use @samp{Save Options} in the
154@c Options menu, or run @code{menu-bar-options-save}. 212@c Options menu, or run @code{menu-bar-options-save}.
155 213
156@cindex Core Text, on macOS
157@cindex font backend, on macOS
158In macOS, Emacs uses a Core Text based font backend
159by default. If you prefer the older font style, enter the following
160at the command-line before starting Emacs:
161
162@example
163% defaults write org.gnu.Emacs FontBackend ns
164@end example
165
166
167@node Mac / GNUstep Events 214@node Mac / GNUstep Events
168@section Windowing System Events under macOS / GNUstep 215@section Windowing System Events under macOS / GNUstep
169@cindex events on macOS 216@cindex events on macOS