aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorGlenn Morris2020-06-26 07:50:38 -0700
committerGlenn Morris2020-06-26 07:50:38 -0700
commitffb89ed5f07491e33fc79d8b4be49d9deba2ad4a (patch)
treec2305304aca119da0e4d692aad5b964ef0ba2cf6 /doc
parent89c744c380b2aed28ebf2bd8f991461d60cff934 (diff)
parent5280e118c07d738321f61b3f2bc3cd27a5ac8dbc (diff)
downloademacs-ffb89ed5f07491e33fc79d8b4be49d9deba2ad4a.tar.gz
emacs-ffb89ed5f07491e33fc79d8b4be49d9deba2ad4a.zip
Merge from origin/emacs-27
5280e118c0 (origin/emacs-27) ; * src/xdisp.c (pos_visible_p): Fix las... bb1a9481c9 Fix posn-at-point at beginning of a display string 0c4b033670 Improve documentation of Info node movement commands 632b0119e1 Add Jansson dependency to Windows Build dbfcdab837 Unbreak 'reverse-region' c37de84845 Fix typos and markup in fill column indicator docs f61bff3ee9 ; * CONTRIBUTE: Clarify the preferences for patch formatting. 368e140660 Avoid crashes in 'defconst' 11e3413cff Fix text about Lisp archives in the Emacs FQ 4c81724675 Don't use 'cl' functions in ELisp manual's examples
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/display.texi33
-rw-r--r--doc/lispref/control.texi6
-rw-r--r--doc/misc/efaq.texi21
3 files changed, 33 insertions, 27 deletions
diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index 536f4cb5daa..a2ace00cbbc 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -1174,19 +1174,20 @@ right-to-left paragraphs.
1174@findex display-fill-column-indicator-mode 1174@findex display-fill-column-indicator-mode
1175@findex global-display-fill-column-indicator-mode 1175@findex global-display-fill-column-indicator-mode
1176 Emacs can add an indicator to display a fill column position. The 1176 Emacs can add an indicator to display a fill column position. The
1177fill column indicator is a useful functionality specially in 1177fill column indicator is a useful functionality especially in
1178prog-mode to indicate the position of an specific column. 1178@code{prog-mode} to indicate the position of a specific column.
1179 1179
1180 You can set the buffer-local variables @code{display-fill-column-indicator} 1180 You can set the buffer-local variables
1181and @code{display-fill-column-indicator-character} to activate the 1181@code{display-fill-column-indicator} and
1182indicator and controls how the indicator looks. 1182@code{display-fill-column-indicator-character} to activate the
1183indicator and control how it looks, respectively.
1183 1184
1184Alternatively you can type @w{@kbd{M-x display-fill-column-indicator-mode}} 1185Alternatively you can type @w{@kbd{M-x display-fill-column-indicator-mode}}
1185or @w{@kbd{M-x global-display-fill-column-indicator-mode}} which enables the 1186or @w{@kbd{M-x global-display-fill-column-indicator-mode}} which
1186indicator locally and globally respectively and also chooses the 1187enables the indicator locally or globally, respectively, and also
1187character to use if none is set already. It is possible to use the 1188chooses the character to use if none is already set. It is possible
1188first one to activate the indicator in a hook or the second one to 1189to use the first one to activate the indicator in a hook and the
1189enable it globally. 1190second one to enable it globally.
1190 1191
1191There are 2 buffer local variables and 1 face to customize this mode: 1192There are 2 buffer local variables and 1 face to customize this mode:
1192 1193
@@ -1203,20 +1204,20 @@ Any other value disables the indicator. The default value is @code{t}.
1203@item display-fill-column-indicator-character 1204@item display-fill-column-indicator-character
1204@vindex display-fill-column-indicator-character 1205@vindex display-fill-column-indicator-character
1205Specifies the character used for the indicator. This character can be 1206Specifies the character used for the indicator. This character can be
1206any valid char including unicode ones if the actual font supports 1207any valid character including Unicode ones if the font supports them.
1207them.
1208 1208
1209When the mode is enabled through the functions 1209When the mode is enabled through the functions
1210@code{display-fill-column-indicator-mode} or 1210@code{display-fill-column-indicator-mode} or
1211@code{global-display-fill-column-indicator-mode}, the initialization 1211@code{global-display-fill-column-indicator-mode}, the initialization
1212functions check if this variable is @code{non-nil}, otherwise the 1212functions check if this variable is non-@code{nil}, otherwise the
1213initialization tries to set it to U+2502 or @samp{|}. 1213initialization tries to set it to @code{U+2502} or @samp{|}.
1214 1214
1215@item fill-column-indicator 1215@item fill-column-indicator
1216@vindex fill-column-indicator 1216@vindex fill-column-indicator
1217Specifies the face used to display the indicator. It inherits its 1217Specifies the face used to display the indicator. It inherits its
1218default values from shadow but without background color. To change 1218default values from the face @code{shadow} but without background
1219the indicator color you need to set only the foreground color of this face. 1219color. To change the indicator color you need only set the foreground
1220color of this face.
1220@end table 1221@end table
1221 1222
1222@vindex indicate-buffer-boundaries 1223@vindex indicate-buffer-boundaries
diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi
index 01ae94ea7dd..d2419f415bf 100644
--- a/doc/lispref/control.texi
+++ b/doc/lispref/control.texi
@@ -959,8 +959,9 @@ For example, the following is invalid:
959 959
960@example 960@example
961@group 961@group
962(require 'cl-lib)
962(pcase (read-number "Enter an integer: ") 963(pcase (read-number "Enter an integer: ")
963 ((or (and (pred evenp) 964 ((or (and (pred cl-evenp)
964 e-num) ; @r{bind @code{e-num} to @var{expval}} 965 e-num) ; @r{bind @code{e-num} to @var{expval}}
965 o-num) ; @r{bind @code{o-num} to @var{expval}} 966 o-num) ; @r{bind @code{o-num} to @var{expval}}
966 (list e-num o-num))) 967 (list e-num o-num)))
@@ -984,9 +985,10 @@ Reworking the above example:
984 985
985@example 986@example
986@group 987@group
988(require 'cl-lib)
987(pcase (read-number "Enter an integer: ") 989(pcase (read-number "Enter an integer: ")
988 ((and num ; @r{line 1} 990 ((and num ; @r{line 1}
989 (or (and (pred evenp) ; @r{line 2} 991 (or (and (pred cl-evenp) ; @r{line 2}
990 (let spin 'even)) ; @r{line 3} 992 (let spin 'even)) ; @r{line 3}
991 (let spin 'odd))) ; @r{line 4} 993 (let spin 'odd))) ; @r{line 4}
992 (list spin num))) ; @r{line 5} 994 (list spin num))) ; @r{line 5}
diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi
index 8f7ed715b52..82467048a08 100644
--- a/doc/misc/efaq.texi
+++ b/doc/misc/efaq.texi
@@ -3477,15 +3477,18 @@ You can browse the resulting @file{*Packages*} buffer to see what is
3477available, and then Emacs can automatically download and install the 3477available, and then Emacs can automatically download and install the
3478packages that you select. @xref{Packages,,, emacs, The GNU Emacs Manual}. 3478packages that you select. @xref{Packages,,, emacs, The GNU Emacs Manual}.
3479 3479
3480There are other, non-GNU, Emacs Lisp package servers, including: 3480There are other Emacs Lisp package archives. To use additional
3481@uref{https://melpa.org, MELPA}; and 3481archives, you can customize the @code{package-archives} variable.
3482@uref{https://marmalade-repo.org, Marmalade}. To use additional 3482Those archives have no affiliation with GNU Emacs, and we do not
3483package servers, customize the @code{package-archives} variable. Be 3483monitor how they are maintained. They may pay close attention to
3484aware that installing a package can run arbitrary code, so only add 3484correctness and safety of the code, or they may give only cursory
3485sources that you trust. Also, packages hosted on non-GNU package 3485attention.
3486servers may encourage or require you to install and use non-free 3486
3487software; for example, MELPA is known to host some packages that do 3487Also, packages hosted on these other archives may encourage or require
3488this. 3488you to install and use other nonfree programs. Unless you can verify
3489that a package is free software, and that it functions without
3490installing any nonfree software, we recommend for your freedom's sake
3491that you stay away from it.
3489 3492
3490The @uref{https://lists.gnu.org/mailman/listinfo/gnu-emacs-sources, 3493The @uref{https://lists.gnu.org/mailman/listinfo/gnu-emacs-sources,
3491GNU Emacs sources mailing list}, which is gatewayed to the 3494GNU Emacs sources mailing list}, which is gatewayed to the