summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* Remove the optional KEEP-ORDER argument to regexp-optMattias Engdegård2020-02-131-6/+3
| | | | | | | | | | | | | This argument was added for the 'or' clause in rx, but it turned out to be a bad idea (bug#37659), and there seems to be little other use for it. * lisp/emacs-lisp/regexp-opt.el (regexp-opt): Remove KEEP-ORDER. * doc/lispref/searching.texi (Regexp Functions): * etc/NEWS: Remove it from the documentation. * test/lisp/emacs-lisp/regexp-opt-tests.el (regexp-opt-test--match-all) (regexp-opt-test--check-perm, regexp-opt-test--explain-perm) (regexp-opt-keep-order, regexp-opt-longest-match): Simplify test.
* doc/misc/org.texi: Fix @dircategoryBastien2020-02-131-1/+1
| | | | * doc/misc/org.texi: Fix @dircategory.
* Fix display of minibuffer prompt in ido.elEli Zaretskii2020-02-122-3/+16
| | | | | | | | | | | | | | | | | | * lisp/minibuffer.el (minibuffer--message-overlay-pos): New function. (set-minibuffer-message): Use it to determine where to show the overlay with the temporary message. * lisp/ido.el (ido-exhibit): Revert "Render Ido suggestions using an overlay"; this restores the original code which inserted the match-status information into the minibuffer, instead of displaying it in an overlay with an after-string. Put the special 'minibuffer-message' text property at the beginning of the inserted text. (Bug#39379) * etc/NEWS: * doc/lispref/display.texi (Displaying Messages): * doc/lispref/text.texi (Special Properties): Document the 'minibuffer-message' text property and its effect.
* rx: Use longest match for all-string 'or' forms (bug#37659)Mattias Engdegård2020-02-121-1/+4
| | | | | | | | | | | | | | | | | Revert to the Emacs 26 semantics that always gave the longest match for rx 'or' forms with only string arguments. This guarantee was never well documented, but it is useful and people likely have come to rely on it. For example, prior to this change, (rx (or ">" ">=")) matched ">" even if the text contained ">=". * lisp/emacs-lisp/rx.el (rx--translate-or): Don't tell regexp-opt to preserve the matching order. * doc/lispref/searching.texi (Rx Constructs): Document the longest-match guarantee for all-string 'or' forms. * test/lisp/emacs-lisp/rx-tests.el (rx-or): Update test.
* Correct "different than" to "different from" where appropriateAlan Mackenzie2020-02-095-7/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | (doc/emacs/screen.texi) (doc/lispintro/emacs-lisp-intro.texi) (doc/misc/calc.texi) (doc/misc/gnus.texi) (doc/misc/sc.texi) (lisp/align.el) (lisp/allout-widgets.el) (lisp/allout.el) (lisp/emacs-lisp/gv.el) (lisp/font-lock.el) (lisp/gnus/mm-util.el) (lisp/mail/feedmail.el) (lisp/mail/sendmail.el) (lisp/mail/supercite.el) (lisp/org/org-attach.el) (lisp/progmodes/cc-langs.el) (lisp/progmodes/idlw-shell.el) (lisp/ps-print.el) (lisp/simple.el) (src/cmds.c) (src/editfns.c) (src/frame.h) (src/regex-emacs.c) (src/xfaces.c): Replace "different than" by "different from".
* More accurate documentation of 'package-menu-hide-package'Eli Zaretskii2020-02-081-2/+5
| | | | | | | | | | * doc/emacs/package.texi (Package Menu): Improve the description of the 'H' command. * lisp/emacs-lisp/package.el (package-menu-mode-menu): More accurate wording of the help-echo string. (package-menu-hide-package): Make the doc string more accurate. (Bug#39436)
* Clarify lexvar restrictions for add-to-ordered-list, add-to-historyMattias Engdegård2020-02-022-0/+2
| | | | | | | | | * lisp/subr.el (add-to-ordered-list, add-to-history): * doc/lispref/lists.texi (List Variables): * doc/lispref/minibuf.texi (Minibuffer History): Note in the doc string and manual that the variable arguments to add-to-ordered-list and add-to-history cannot refer to a lexical variable (bug#39373).
* Clarify add-to-list documentation (bug#39373)Mattias Engdegård2020-02-011-2/+6
| | | | | | | | | While add-to-list often works with lexical variables, this is a hack that isn't always effective; better tell the user not to try. * doc/lispref/lists.texi (List Variables): Add a note about lexical variables to the add-to-list description. Fix the equivalent code. * lisp/subr.el (add-to-list): Amend doc string.
* Update documentation for mh-show-mode-hookStephen Gildea2020-02-011-3/+3
| | | | | | * lisp/mh-e/mh-e.el, doc/misc/mh-e.texi (mh-show-mode-hook): Now that the fix for MH-E bug #470 calls mh-show-mode-hook earlier, update the documentation to no longer say that the message contents are available.
* Example goto-addr hook: MH-E already uses goto-addressStephen Gildea2020-02-011-3/+2
| | | | | | * lisp/net/goto-addr.el, doc/emacs/misc.texi: Do not use MH-E as the example of how to add a hook to goto-address, because MH-E calls goto-address internally.
* Finish the documentation for c-noise-macro-{,with-parens-}names.Alan Mackenzie2020-01-271-10/+12
| | | | | | | | | | | The doc strings and pertinent CC Mode manual page failed to mention that these variables could also be regular expressions. Amend them. * lisp/progmodes/cc-vars.el (c-noise-macro-names) (c-noise-macro-with-parens-names): Amend the doc strings. * doc/misc/cc-mode.texi (Noise Macros): Amend the descriptions of the two variables.
* Moderate recommendation to escape '(' in doc stringsMattias Engdegård2020-01-261-12/+15
| | | | | | | | | | Thanks to 57e2ca5c50 and related changes, opening brackets at the leftmost column inside doc strings are no longer mistaken for the start of a defun. * doc/lispref/tips.texi (Documentation Tips): Clarify recommendation and move it down the list. * etc/NEWS: Announce.
* * doc/lispref/streams.texi (Output Functions): Improve indexing.Stefan Kangas2020-01-251-0/+1
|
* Improve doc of eq on bignums etc.Paul Eggert2020-01-242-17/+19
| | | | | | * doc/lispref/numbers.texi (Integer Basics): * doc/lispref/objects.texi (Integer Type, Equality Predicates): Be clearer about eq vs eql vs = on bignums, floats, and strings.
* * doc/emacs/files.texi (Auto Save Files): Improve indexing (bug#39259).Eli Zaretskii2020-01-241-0/+1
|
* Fix inaccurate wording in the Emacs manualEli Zaretskii2020-01-242-7/+9
| | | | | | * doc/emacs/custom.texi (Modifier Keys): * doc/emacs/basic.texi (Inserting Text): Fix minor inaccuracies in describing the 'Alt' modifier. (Bug#39254)
* Prefer saying "Info manual" to "info page" in docsStefan Kangas2020-01-234-4/+4
| | | | | | | | | | | | | Pointed out by Eli Zaretskii in: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=39215#14 * doc/emacs/Makefile.in: * doc/lispintro/Makefile.in: * doc/lispref/Makefile.in: * doc/misc/Makefile.in: * lisp/dired-x.el (top-level): * lisp/gnus/gnus-sum.el (gnus-summary-mode): * lisp/progmodes/cperl-mode.el (cperl-info-page): Doc fix; prefer saying "Info manual" over "info page".
* * doc/misc/tramp.texi (Bug Reports): Encourage use of "emacs -Q".Michael Albinus2020-01-221-1/+5
|
* Correct statement about ftcr and recommend HarfBuzzRobert Pluim2020-01-211-11/+11
| | | | | | * doc/lispref/frames.texi (Font and Color Parameters): Correct statement about availability of ftcr in the presence of HarfBuzz. Recommend HarfBuzz.
* Small fixes in documentation.Juri Linkov2020-01-212-5/+5
| | | | | | | * doc/emacs/dired.texi (Operating on Files): Fix name of dired-vc-rename-file. * doc/emacs/fixit.texi (Undo): Update new values of undo limits doubled in bug#31104.
* Improve explanation of available font backends under XRobert Pluim2020-01-201-8/+11
| | | | | | * frames.texi (Font and Color Parameters): Clarify that you can't have HarfBuzz and non-HarfBuzz at the same time for xft and cairo font backends.
* Fix shell-command-dont-erase-buffer featureTino Calancha2020-01-191-6/+8
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * lisp/simple.el (shell-command-dont-erase-buffer): The default, nil, is backward compatible, i.e. it erases the buffer only if the output buffer is not the current one; the new value 'erase always erases the output buffer. Update docstring. (shell-command-save-pos-or-erase): Add optional arg output-to-current-buffer. Rename it so that it's not internal. All callers updated. (shell-command-set-point-after-cmd): Rename it so that it's not internal. All callers updated. Adjust it to cover a side case. (shell-command): Adjust logic to match the specification (Bug#39067). Enable the feature when the output buffer is the current one. (shell-command-on-region): Little tweak to follow `shell-command-dont-erase-buffer' specification. * test/lisp/simple-tests.el (with-shell-command-dont-erase-buffer): Add helper macro. (simple-tests-shell-command-39067) (simple-tests-shell-command-dont-erase-buffer): Add tests. * doc/emacs/misc.texi (Single Shell): Update manual. * etc/NEWS (Single shell commands): Announce the change.
* Remove reference to Emacs 19 from FAQStefan Kangas2020-01-191-2/+2
| | | | | * doc/misc/efaq.texi (Emacs ignores X resources): Remove reference to Emacs 19.
* Remove some doc references to old Emacs versionsStefan Kangas2020-01-181-24/+6
| | | | | | | | * doc/misc/efaq.texi (Horizontal scrolling): Remove section only relevant to Emacs 21 or older. (Repeating commands, Editing MS-DOS files): * lisp/progmodes/gdb-mi.el: * lisp/woman.el: Doc fix - remove some references to Emacs 20 and older.
* ; spelling fixesPaul Eggert2020-01-173-3/+3
|
* ; Minor edit in anti.texiRobert Pluim2020-01-171-1/+1
|
* ; Fix recent markup changeRobert Pluim2020-01-171-1/+1
| | | | * doc/emacs/custom.texi (Find Init): Fix variable markup.
* Document feature requests in the Emacs manualStefan Kangas2020-01-161-0/+11
| | | | | * doc/emacs/trouble.texi (Contributing): Document how to send feature requests. (Bug20697)
* Make emacs prefer an existing ~/.emacs.d to an existing XDG locationRobert Pluim2020-01-161-17/+28
| | | | | | | | | | | | | | | * doc/emacs/custom.texi (Find Init): Update description of how Emacs finds its init file directory and the interaction with $XDG_CONFIG_HOME (Early Init File): Correct XDG location of early-init.el * etc/NEWS: Update description to make it clear the ~/.emacs.d is preferred, even if the XDG location exists. * lisp/startup.el: Prefer ~/.emacs.d even if the XDG location exists. * lib-src/emacsclient.c (open_config): Prefer home directory the XDG location.
* Add new node "Package Statuses" to manualStefan Kangas2020-01-152-14/+63
| | | | | | * doc/emacs/emacs.texi (Top): * doc/emacs/package.texi (Package Menu): New node "Package Statuses". (Bug#29420)
* Always use lexical-binding in lisp-interaction-mode (bug#38835)Mattias Engdegård2020-01-131-0/+3
| | | | | | | | | | * lisp/progmodes/elisp-mode.el (lisp-interaction-mode): Set lexical-binding. * lisp/startup.el (command-line, startup--get-buffer-create-scratch): Don't set lexical-binding here. * doc/lispref/variables.texi: * etc/NEWS: Make it clear that lisp-interaction-mode uses lexical-binding.
* ; * doc/lispref/anti.texi (Antinews): Fix typo.Michael Albinus2020-01-111-1/+1
|
* Update Acknowledgments sectionsEli Zaretskii2020-01-112-7/+33
| | | | | * doc/emacs/ack.texi (Acknowledgments): * doc/emacs/emacs.texi (Acknowledgments): Update for Emacs 27.
* Update Antinews in ELisp manualEli Zaretskii2020-01-112-218/+126
| | | | | | * doc/lispref/anti.texi (Antinews): Rewrite for Emacs 27. * doc/lispref/elisp.texi (Top): Update the top-level menu item for Antinews.
* ; Move the description of define-inline to a different node in functions.texiRichard Stallman2020-01-111-96/+100
|
* Improve wording in the ELisp manualRichard Stallman2020-01-111-2/+15
| | | | | * doc/lispref/modes.texi (Setting Hooks): Improve and clarify wording. (Bug#38818)
* ; Minor spelling fixesRobert Pluim2020-01-101-7/+8
| | | | * doc/emacs/anti.texi (Antinews): Minor spelling fixes.
* Update Antinews in the Emacs manualEli Zaretskii2020-01-102-108/+96
| | | | | | * doc/emacs/anti.texi (Antinews): Rewrite for Emacs 27. * doc/emacs/emacs.texi (Top): Update the "Antiniews" item of the top-level menu.
* Change Tramp version to 2.4.3.27.1Michael Albinus2020-01-031-1/+1
| | | | | | | * doc/misc/trampver.texi: * lisp/net/trampver.el: Change version to "2.4.3.27.1". (customize-package-emacs-version-alist): Add Tramp version integrated in Emacs 27.1.
* Revert "Raise default max-specpdl-size value"Mattias Engdegård2020-01-011-1/+1
| | | | This reverts commit bb9402e6e9c12938aee31b81e25511eb1f6335d2.
* Raise default max-specpdl-size valueMattias Engdegård2020-01-011-1/+1
| | | | | | | | | Occasionally, loading cl-generic.el from source requires max_specpdl_size > 1600 when bootstrapping, and thus fails. In any case we are very close to the limit. * src/eval.c (init_eval_once): Raise max_specpdl_size to 1800. * doc/lispref/variables.texi (Local Variables): Update docs.
* Fix copyright years by handPaul Eggert2020-01-011-1/+1
| | | | These are dates that admin/update-copyright did not update.
* Update copyright year to 2020Paul Eggert2020-01-01195-201/+208
| | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* Fixes for makeinfo 4.13Glenn Morris2019-12-292-4/+3
| | | | | | * doc/lispref/customize.texi (Variable Definitions): Fix xref. * doc/lispref/internals.texi (Writing Emacs Primitives) (Module Values): Follow xref with comma.
* Sync with Tramp 2.4.3Michael Albinus2019-12-291-1/+1
| | | | | | | | | | | | * doc/misc/trampver.texi: * lisp/net/trampver.el: Change version to "2.4.3". * lisp/net/tramp.el: Bump version. (tramp-handle-shell-command): The temp file for error-buffer is remote. * test/lisp/net/tramp-tests.el (tramp-test30-make-process): Simplify buffer generation. (tramp-test32-shell-command): Extend test.
* Rearrange NEWS, add missing documentationEli Zaretskii2019-12-2812-25/+123
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * etc/NEWS: Rearrange and mark entries whether documented or not. * doc/lispref/streams.texi (Output Variables): Document the new default of 'print-quoted'. * doc/lispref/keymaps.texi (Functions for Key Lookup): Document that KEYMAP arg to 'lookup-key' can also be a list. * doc/lispref/customize.texi (Variable Definitions): Document the :local keyword of 'defcustom'. * doc/lispref/numbers.texi (Float Basics): Document changes in 'logb'. * doc/lispref/hooks.texi (Standard Hooks): Document 'comint-password-function'. * doc/emacs/display.texi (Text Scale): Document text-size adjustment using the mouse wheel. * doc/emacs/frames.texi (Mouse Commands): Document image scaling with the mouse wheel. * doc/emacs/windows.texi (Window Convenience): Document 'global-tab-line-mode'. * doc/emacs/search.texi (Repeat Isearch, Symbol Search) (Isearch Yank): Document the new support for numeric arguments in Isearch commands. (Special Isearch): Document 'M-s M->' and 'M-s M-<'. (Search Customizations): Document 'isearch-lazy-count'. Improve indexing. (Not Exiting Isearch): Document the new value of 'isearch-allow-scroll'. * doc/emacs/maintaining.texi (Xref Commands): Document the new 'g' key binding. * doc/emacs/package.texi (Package Installation): Document changes in 'package-check-signature'. * doc/emacs/maintaining.texi (VC Change Log): Document 'vc-log-search'. * doc/emacs/dired.texi (Operating on Files): Document 'dired-vc-rename'.
* Fix documentation of define-obsolete-* functionsEli Zaretskii2019-12-281-3/+3
| | | | | | | | | | | * doc/lispref/functions.texi (Obsolete Functions): Make documentation of functions that obsolete symbols match the advertised calling conventions. * lisp/emacs-lisp/byte-run.el (define-obsolete-function-alias) (define-obsolete-variable-alias, define-obsolete-face-alias): State in the doc strings that WHEN is a mandatory argument, to be consistent with the advertised calling convention. (Bug#38675)
* Minor improvements of buffer documentationEli Zaretskii2019-12-271-0/+4
| | | | | | * doc/emacs/buffers.texi (Buffers): Say that buffers are killed when no longer needed. Suggested by Jean-Christophe Helary <jean.christophe.helary@traduction-libre.org>.
* * doc/emacs/buffers.texi (Kill Buffer): Improve indexing.Eli Zaretskii2019-12-261-0/+2
|
* Document some restrictions for module functions.Philipp Stephani2019-12-261-0/+16
| | | | | * doc/lispref/internals.texi (Module Functions): Document some restrictions for module functions.
View Lorry Controller Status