aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/macos.texi41
-rw-r--r--doc/lispref/display.texi4
-rw-r--r--doc/lispref/text.texi14
-rw-r--r--doc/misc/efaq.texi77
4 files changed, 96 insertions, 40 deletions
diff --git a/doc/emacs/macos.texi b/doc/emacs/macos.texi
index ef2e9448902..cfb63fe1d8c 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 172window under the mouse, or to insert text at point of the window under
187(@code{ns-insert-files}). The list of dragged files is stored in the 173the mouse. It may sometimes be necessary to use the @key{META} key in
188variable @code{ns-input-file}. 174conjunction with 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
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 02dc830e0ab..13a25af02c8 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -7235,8 +7235,8 @@ Characters of Unicode General Category [Cf], such as @samp{U+200E}
7235images, such as @samp{U+00AD} (Soft Hyphen). 7235images, such as @samp{U+00AD} (Soft Hyphen).
7236 7236
7237@item no-font 7237@item no-font
7238Characters for there is no suitable font, or which cannot be encoded 7238Characters for which there is no suitable font, or which cannot be
7239by the terminal's coding system. 7239encoded by the terminal's coding system.
7240@end table 7240@end table
7241 7241
7242@c FIXME: this can also be 'acronym', but that's not currently 7242@c FIXME: this can also be 'acronym', but that's not currently
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index 8cb6cf6242a..da09b4ae1c6 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -1143,7 +1143,7 @@ If @var{n} is zero, indicating a request for the latest kill,
1143@code{current-kill} calls the value of 1143@code{current-kill} calls the value of
1144@code{interprogram-paste-function} (documented below) before 1144@code{interprogram-paste-function} (documented below) before
1145consulting the kill ring. If that value is a function and calling it 1145consulting the kill ring. If that value is a function and calling it
1146returns a string or a list of several string, @code{current-kill} 1146returns a string or a list of several strings, @code{current-kill}
1147pushes the strings onto the kill ring and returns the first string. 1147pushes the strings onto the kill ring and returns the first string.
1148It also sets the yanking pointer to point to the kill-ring entry of 1148It also sets the yanking pointer to point to the kill-ring entry of
1149the first string returned by @code{interprogram-paste-function}, 1149the first string returned by @code{interprogram-paste-function},
@@ -1156,8 +1156,10 @@ move the yanking pointer.
1156@defun kill-new string &optional replace 1156@defun kill-new string &optional replace
1157This function pushes the text @var{string} onto the kill ring and 1157This function pushes the text @var{string} onto the kill ring and
1158makes the yanking pointer point to it. It discards the oldest entry 1158makes the yanking pointer point to it. It discards the oldest entry
1159if appropriate. It also invokes the value of 1159if appropriate. It also invokes the values of
1160@code{interprogram-cut-function} (see below). 1160@code{interprogram-paste-function} (subject to
1161the user option @code{save-interprogram-paste-before-kill})
1162and @code{interprogram-cut-function} (see below).
1161 1163
1162If @var{replace} is non-@code{nil}, then @code{kill-new} replaces the 1164If @var{replace} is non-@code{nil}, then @code{kill-new} replaces the
1163first element of the kill ring with @var{string}, rather than pushing 1165first element of the kill ring with @var{string}, rather than pushing
@@ -1169,8 +1171,10 @@ This function appends the text @var{string} to the first entry in the
1169kill ring and makes the yanking pointer point to the combined entry. 1171kill ring and makes the yanking pointer point to the combined entry.
1170Normally @var{string} goes at the end of the entry, but if 1172Normally @var{string} goes at the end of the entry, but if
1171@var{before-p} is non-@code{nil}, it goes at the beginning. This 1173@var{before-p} is non-@code{nil}, it goes at the beginning. This
1172function also invokes the value of @code{interprogram-cut-function} 1174function calls @code{kill-new} as a subroutine, thus causing the
1173(see below). 1175values of @code{interprogram-cut-function} and possibly
1176@code{interprogram-paste-function} (see below) to be invoked by
1177extension.
1174@end defun 1178@end defun
1175 1179
1176@defvar interprogram-paste-function 1180@defvar interprogram-paste-function
diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
index b2cf006285d..96ca4657284 100644
--- a/doc/misc/efaq.texi
+++ b/doc/misc/efaq.texi
@@ -930,6 +930,7 @@ status of its latest version.
930@menu 930@menu
931* Origin of the term Emacs:: 931* Origin of the term Emacs::
932* Latest version of Emacs:: 932* Latest version of Emacs::
933* New in Emacs 26::
933* New in Emacs 25:: 934* New in Emacs 25::
934* New in Emacs 24:: 935* New in Emacs 24::
935* New in Emacs 23:: 936* New in Emacs 23::
@@ -979,7 +980,7 @@ conventions}).
979Emacs @value{EMACSVER} is the current version as of this writing. A version 980Emacs @value{EMACSVER} is the current version as of this writing. A version
980number with two components (e.g., @samp{24.5}) indicates a released 981number with two components (e.g., @samp{24.5}) indicates a released
981version; three components indicate a development 982version; three components indicate a development
982version (e.g., @samp{26.0.50} is what will eventually become @samp{26.1}). 983version (e.g., @samp{27.0.50} is what will eventually become @samp{27.1}).
983 984
984Emacs is under active development, hosted at 985Emacs is under active development, hosted at
985@uref{https://savannah.gnu.org/projects/emacs/, Savannah}. 986@uref{https://savannah.gnu.org/projects/emacs/, Savannah}.
@@ -998,6 +999,80 @@ Emacs, type @kbd{C-h C-n} (@kbd{M-x view-emacs-news}). As of Emacs 22,
998you can give this command a prefix argument to read about which features 999you can give this command a prefix argument to read about which features
999were new in older versions. 1000were new in older versions.
1000 1001
1002@node New in Emacs 26
1003@section What is different about Emacs 26?
1004@cindex Differences between Emacs 25 and Emacs 26
1005@cindex Emacs 26, new features in
1006
1007@itemize
1008@cindex threads
1009@item
1010Emacs now provides a limited form of concurrency with Lisp threads.
1011
1012@cindex systemd support
1013@item
1014Emacs now supports @code{systemd}. The new command-line option
1015@option{--fg-daemon} is part of this support, it causes Emacs to run
1016in the foreground instead of forking, as under @option{--daemon}.
1017
1018@item
1019Emacs now supports 24-bit true color on text terminals which provide
1020that feature. @xref{Colors on a TTY}.
1021
1022@cindex double-buffering
1023@item
1024Emacs on X now supports double-buffering, which eliminates display
1025flickering in most situations.
1026
1027@item
1028You can now scroll the Emacs display horizontally using the mouse or
1029touchpad.
1030
1031@cindex line number display
1032@item
1033Emacs display now includes an optional feature for display of line
1034numbers via the @code{display-line-numbers-mode} command. This
1035feature is much faster than the equivalent display offered by packages
1036such as @code{linum}, and also provides many optional features like
1037relative line numbers.
1038
1039@cindex horizontal scrolling of current line
1040@item
1041The automatic horizontal scrolling of the window display when lines
1042are truncated can now optionally be enabled only for the current line,
1043the line where Emacs shows the cursor. Under this mode, all the other
1044window lines are not scrolled to show characters outside of the
1045viewport.
1046
1047@item
1048Letter-case conversions now honor special cases in Turkish and Greek
1049scripts.
1050
1051@cindex Enchant support
1052@item
1053Support for Enchant is now part of the Emacs spell-checking commands.
1054
1055@item
1056Tramp now supports Google Drive filesystems.
1057
1058@item
1059Emacs can now be built while omitting the details of the machine on
1060which it was built, thus making it easier to produce reproducible
1061builds.
1062
1063@item
1064Security vulnerability related to Enriched Text mode is removed.
1065Enriched mode previously allowed saving @code{display} properties as
1066part of text; those properties support evaluating arbitrary Lisp code,
1067which opens a vulnerability for Emacs users receiving Enriched Text
1068from external sources. Execution of arbitrary Lisp forms in
1069@code{display} properties decoded by Enriched Text mode is now
1070disabled by default.
1071@end itemize
1072
1073Consult the Emacs @file{NEWS} file (@kbd{C-h n}) for the full list of
1074changes in Emacs 26.
1075
1001@node New in Emacs 25 1076@node New in Emacs 25
1002@section What is different about Emacs 25? 1077@section What is different about Emacs 25?
1003@cindex Differences between Emacs 24 and Emacs 25 1078@cindex Differences between Emacs 24 and Emacs 25