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

NS port documentation updates

Browse source 
* 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.
This commit is contained in:
Alan Third 2020-03-07 14:39:05 +00:00
parent 5b19db98ad
commit 72f87f8873
2 changed files with 62 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

69
doc/emacs/macos.texi
View file

@ -143,6 +143,64 @@ The variables for right-hand keys, like @code{ns-right-alternate-modifier},
may also be set to @code{left}, which means to use the same behavior as may also be set to @code{left}, which means to use the same behavior as
the corresponding left-hand key. the corresponding left-hand key.
@subsection Frame Variables
@table @code
@vindex ns-use-proxy-icon
@item ns-use-proxy-icon
This variable specifies whether to display the proxy icon in the
titlebar.
@vindex ns-confirm-quit
@item ns-confirm-quit
This variable specifies whether to display a graphical confirmation
dialogue on quitting.
@vindex ns-auto-hide-menu-bar
@item ns-auto-hide-menu-bar
This variable specifies whether the macOS menu bar is hidden when an
Emacs frame is selected. If non-nil the menu bar is not shown unless
the mouse pointer is moved near to the top of the screen.
@vindex ns-use-native-fullscreen
@item ns-use-native-fullscreen
This variable controls whether to use native, or non-native
fullscreen. Native fullscreen is only available on macOS 10.7 and
above.
@end table
@subsection macOS Trackpad/Mousewheel Variables
These variables only apply to macOS 10.7 (Lion) and above.
@table @code
@vindex ns-use-mwheel-acceleration
@item ns-use-mwheel-acceleration
This variable controls whether Emacs ignores the system mousewheel
acceleration. When nil each `click' of the mousewheel will correspond
exactly with one mousewheel event. When non-nil, the default, each
`click' may correspond with more than one mousewheel event, depending
on the user's input.
@vindex ns-use-mwheel-momentum
@item ns-use-mwheel-momentum
This variable controls whether Emacs ignores the system `momentum'
when scrolling using a trackpad. When non-nil, the default, scrolling
rapidly may result in the buffer continuing to scroll for a short
while after the user has lifted their fingers off the trackpad.
@vindex ns-mwheel-line-height
@item ns-mwheel-line-height
This variable controls the sensitivity of scrolling with the trackpad.
Apple trackpads scroll by pixels, not lines, so Emacs converts the
system's pixel values into lines. When set to a number, this variable
sets the number of pixels Emacs will consider as one line. When nil
or a non-number the default line height is used.
Setting a lower number makes the trackpad more sensitive, and a higher
number makes the trackpad less sensitive.
@end table
@subsection Font Panel @subsection Font Panel
@findex ns-popup-font-panel @findex ns-popup-font-panel
@ -153,17 +211,6 @@ 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}.
@cindex Core Text, on macOS
@cindex font backend, on macOS
In macOS, Emacs uses a Core Text based font backend
by default. If you prefer the older font style, enter the following
at the command-line before starting Emacs:
@example
% defaults write org.gnu.Emacs FontBackend ns
@end example
@node Mac / GNUstep Events @node Mac / GNUstep Events
@section Windowing System Events under macOS / GNUstep @section Windowing System Events under macOS / GNUstep
@cindex events on macOS @cindex events on macOS

4
etc/NEWS
View file

@ -3649,15 +3649,18 @@ signal 'user-error' if there is no buffer to switch to.
** Battery status is now supported in all Cygwin builds. ** Battery status is now supported in all Cygwin builds.
Previously it was supported only in the Cygwin-w32 build. Previously it was supported only in the Cygwin-w32 build.
---
** Emacs now handles key combinations involving the macOS "command" ** Emacs now handles key combinations involving the macOS "command"
and "option" modifier keys more correctly. and "option" modifier keys more correctly.
+++
** MacOS modifier key behavior is now more adjustable. ** MacOS modifier key behavior is now more adjustable.
The behavior of the macOS "Option", "Command", "Control" and The behavior of the macOS "Option", "Command", "Control" and
"Function" keys can now be specified separately for use with "Function" keys can now be specified separately for use with
ordinary keys, function keys and mouse clicks. This allows using them ordinary keys, function keys and mouse clicks. This allows using them
in their standard macOS way for composing characters. in their standard macOS way for composing characters.
+++
** The special handling of 'frame-title-format' on NS where setting it ** The special handling of 'frame-title-format' on NS where setting it
to t would enable the macOS proxy icon has been replaced with a to t would enable the macOS proxy icon has been replaced with a
separate variable, 'ns-use-proxy-icon'. 'frame-title-format' will now separate variable, 'ns-use-proxy-icon'. 'frame-title-format' will now
@ -3708,6 +3711,7 @@ modifier keys in line with Apples guidelines. This makes the drag and
drop behavior more consistent, as previously the sending application drop behavior more consistent, as previously the sending application
was able to 'set' modifiers without the knowledge of the user. was able to 'set' modifiers without the knowledge of the user.
---
** On NS multicolor font display is enabled again since it is also ** On NS multicolor font display is enabled again since it is also
implemented in Emacs on free operating systems via Cairo drawing. implemented in Emacs on free operating systems via Cairo drawing.