diff options
| author | Glenn Morris | 2020-06-26 07:50:38 -0700 |
|---|---|---|
| committer | Glenn Morris | 2020-06-26 07:50:38 -0700 |
| commit | ffb89ed5f07491e33fc79d8b4be49d9deba2ad4a (patch) | |
| tree | c2305304aca119da0e4d692aad5b964ef0ba2cf6 /doc | |
| parent | 89c744c380b2aed28ebf2bd8f991461d60cff934 (diff) | |
| parent | 5280e118c07d738321f61b3f2bc3cd27a5ac8dbc (diff) | |
| download | emacs-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.texi | 33 | ||||
| -rw-r--r-- | doc/lispref/control.texi | 6 | ||||
| -rw-r--r-- | doc/misc/efaq.texi | 21 |
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 |
| 1177 | fill column indicator is a useful functionality specially in | 1177 | fill column indicator is a useful functionality especially in |
| 1178 | prog-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 |
| 1181 | and @code{display-fill-column-indicator-character} to activate the | 1181 | @code{display-fill-column-indicator} and |
| 1182 | indicator and controls how the indicator looks. | 1182 | @code{display-fill-column-indicator-character} to activate the |
| 1183 | indicator and control how it looks, respectively. | ||
| 1183 | 1184 | ||
| 1184 | Alternatively you can type @w{@kbd{M-x display-fill-column-indicator-mode}} | 1185 | Alternatively you can type @w{@kbd{M-x display-fill-column-indicator-mode}} |
| 1185 | or @w{@kbd{M-x global-display-fill-column-indicator-mode}} which enables the | 1186 | or @w{@kbd{M-x global-display-fill-column-indicator-mode}} which |
| 1186 | indicator locally and globally respectively and also chooses the | 1187 | enables the indicator locally or globally, respectively, and also |
| 1187 | character to use if none is set already. It is possible to use the | 1188 | chooses the character to use if none is already set. It is possible |
| 1188 | first one to activate the indicator in a hook or the second one to | 1189 | to use the first one to activate the indicator in a hook and the |
| 1189 | enable it globally. | 1190 | second one to enable it globally. |
| 1190 | 1191 | ||
| 1191 | There are 2 buffer local variables and 1 face to customize this mode: | 1192 | There 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 |
| 1205 | Specifies the character used for the indicator. This character can be | 1206 | Specifies the character used for the indicator. This character can be |
| 1206 | any valid char including unicode ones if the actual font supports | 1207 | any valid character including Unicode ones if the font supports them. |
| 1207 | them. | ||
| 1208 | 1208 | ||
| 1209 | When the mode is enabled through the functions | 1209 | When 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 |
| 1212 | functions check if this variable is @code{non-nil}, otherwise the | 1212 | functions check if this variable is non-@code{nil}, otherwise the |
| 1213 | initialization tries to set it to U+2502 or @samp{|}. | 1213 | initialization 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 |
| 1217 | Specifies the face used to display the indicator. It inherits its | 1217 | Specifies the face used to display the indicator. It inherits its |
| 1218 | default values from shadow but without background color. To change | 1218 | default values from the face @code{shadow} but without background |
| 1219 | the indicator color you need to set only the foreground color of this face. | 1219 | color. To change the indicator color you need only set the foreground |
| 1220 | color 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 | |||
| 3477 | available, and then Emacs can automatically download and install the | 3477 | available, and then Emacs can automatically download and install the |
| 3478 | packages that you select. @xref{Packages,,, emacs, The GNU Emacs Manual}. | 3478 | packages that you select. @xref{Packages,,, emacs, The GNU Emacs Manual}. |
| 3479 | 3479 | ||
| 3480 | There are other, non-GNU, Emacs Lisp package servers, including: | 3480 | There are other Emacs Lisp package archives. To use additional |
| 3481 | @uref{https://melpa.org, MELPA}; and | 3481 | archives, you can customize the @code{package-archives} variable. |
| 3482 | @uref{https://marmalade-repo.org, Marmalade}. To use additional | 3482 | Those archives have no affiliation with GNU Emacs, and we do not |
| 3483 | package servers, customize the @code{package-archives} variable. Be | 3483 | monitor how they are maintained. They may pay close attention to |
| 3484 | aware that installing a package can run arbitrary code, so only add | 3484 | correctness and safety of the code, or they may give only cursory |
| 3485 | sources that you trust. Also, packages hosted on non-GNU package | 3485 | attention. |
| 3486 | servers may encourage or require you to install and use non-free | 3486 | |
| 3487 | software; for example, MELPA is known to host some packages that do | 3487 | Also, packages hosted on these other archives may encourage or require |
| 3488 | this. | 3488 | you to install and use other nonfree programs. Unless you can verify |
| 3489 | that a package is free software, and that it functions without | ||
| 3490 | installing any nonfree software, we recommend for your freedom's sake | ||
| 3491 | that you stay away from it. | ||
| 3489 | 3492 | ||
| 3490 | The @uref{https://lists.gnu.org/mailman/listinfo/gnu-emacs-sources, | 3493 | The @uref{https://lists.gnu.org/mailman/listinfo/gnu-emacs-sources, |
| 3491 | GNU Emacs sources mailing list}, which is gatewayed to the | 3494 | GNU Emacs sources mailing list}, which is gatewayed to the |