diff options
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 |