diff options
| author | Alan Third | 2020-03-07 14:39:05 +0000 |
|---|---|---|
| committer | Alan Third | 2020-03-07 14:41:47 +0000 |
| commit | 72f87f88739befce2adf202749b7d651a8ef1551 (patch) | |
| tree | 9643e7391041e86186a428bd7df859079db0b04e /doc | |
| parent | 5b19db98adcfccf432ac40ccdad831723a4c1c06 (diff) | |
| download | emacs-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.texi | 69 |
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}, | |||
| 143 | may also be set to @code{left}, which means to use the same behavior as | 143 | may also be set to @code{left}, which means to use the same behavior as |
| 144 | the corresponding left-hand key. | 144 | the 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 | ||
| 151 | This variable specifies whether to display the proxy icon in the | ||
| 152 | titlebar. | ||
| 153 | |||
| 154 | @vindex ns-confirm-quit | ||
| 155 | @item ns-confirm-quit | ||
| 156 | This variable specifies whether to display a graphical confirmation | ||
| 157 | dialogue on quitting. | ||
| 158 | |||
| 159 | @vindex ns-auto-hide-menu-bar | ||
| 160 | @item ns-auto-hide-menu-bar | ||
| 161 | This variable specifies whether the macOS menu bar is hidden when an | ||
| 162 | Emacs frame is selected. If non-nil the menu bar is not shown unless | ||
| 163 | the mouse pointer is moved near to the top of the screen. | ||
| 164 | |||
| 165 | @vindex ns-use-native-fullscreen | ||
| 166 | @item ns-use-native-fullscreen | ||
| 167 | This variable controls whether to use native, or non-native | ||
| 168 | fullscreen. Native fullscreen is only available on macOS 10.7 and | ||
| 169 | above. | ||
| 170 | @end table | ||
| 171 | |||
| 172 | @subsection macOS Trackpad/Mousewheel Variables | ||
| 173 | |||
| 174 | These 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 | ||
| 179 | This variable controls whether Emacs ignores the system mousewheel | ||
| 180 | acceleration. When nil each `click' of the mousewheel will correspond | ||
| 181 | exactly with one mousewheel event. When non-nil, the default, each | ||
| 182 | `click' may correspond with more than one mousewheel event, depending | ||
| 183 | on the user's input. | ||
| 184 | |||
| 185 | @vindex ns-use-mwheel-momentum | ||
| 186 | @item ns-use-mwheel-momentum | ||
| 187 | This variable controls whether Emacs ignores the system `momentum' | ||
| 188 | when scrolling using a trackpad. When non-nil, the default, scrolling | ||
| 189 | rapidly may result in the buffer continuing to scroll for a short | ||
| 190 | while after the user has lifted their fingers off the trackpad. | ||
| 191 | |||
| 192 | @vindex ns-mwheel-line-height | ||
| 193 | @item ns-mwheel-line-height | ||
| 194 | This variable controls the sensitivity of scrolling with the trackpad. | ||
| 195 | Apple trackpads scroll by pixels, not lines, so Emacs converts the | ||
| 196 | system's pixel values into lines. When set to a number, this variable | ||
| 197 | sets the number of pixels Emacs will consider as one line. When nil | ||
| 198 | or a non-number the default line height is used. | ||
| 199 | |||
| 200 | Setting a lower number makes the trackpad more sensitive, and a higher | ||
| 201 | number 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 | ||
| 158 | In macOS, Emacs uses a Core Text based font backend | ||
| 159 | by default. If you prefer the older font style, enter the following | ||
| 160 | at 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 |