summaryrefslogtreecommitdiff
path: root/doc/emacs/programs.texi
Commit message (Collapse)AuthorAgeFilesLines
* ; Add 2024 to copyright yearsPo Lu2024-01-021-1/+1
|
* Fix documentation of comment-dwim (bug#64104)Eli Zaretskii2023-06-171-8/+11
| | | | | | | * lisp/newcomment.el (comment-dwim): Doc fix. * doc/emacs/programs.texi (Comment Commands): More accurate description of what 'M-;' does when there's no active region.
* Minor improvements in c-ts-mode and docsEli Zaretskii2023-02-151-5/+8
| | | | | | | * lisp/progmodes/c-ts-mode.el (c-ts-base-mode-map): Add a binding for comment-region. * doc/emacs/programs.texi (C Indent): Mention "C-u TAB".
* Document tree-sitter features in the user manualEli Zaretskii2023-01-291-10/+32
| | | | | | | | | | | | | | | * lisp/progmodes/c-ts-mode.el (c-ts-mode-map): Bind "C-c .", for consistency with CC mode. * lisp/treesit.el (treesit-font-lock-level): Doc fix. * doc/emacs/programs.texi (C Indent, Custom C Indent): Document the indentation features of 'c-ts-mode'. (Moving by Defuns): Document 'treesit-defun-tactic'. * doc/emacs/files.texi (Visiting): Document 'treesit-max-buffer-size'. * doc/emacs/display.texi (Traditional Font Lock) (Parser-based Font Lock): New subsections. * doc/emacs/emacs.texi (Top): Update top-level menu.
* ; Add 2023 to copyright years.Eli Zaretskii2023-01-011-1/+1
|
* Mention 'tree-sitter' in user manual and NEWSEli Zaretskii2022-12-151-1/+12
| | | | | | | * doc/emacs/programs.texi (Program Modes): Mention tree-sitter and the modes supported by it. * etc/NEWS: Mention tree-sitter in the Installation Changes section.
* ; Don't mention Makefiles twice in `(emacs) Program Modes`Stefan Kangas2022-11-261-2/+2
| | | | | * doc/emacs/programs.texi (Program Modes): Don't mention Makefiles twice. (Bug#59610)
* ; * doc/emacs/programs.texi (Program Modes): Improve indexing.Stefan Kangas2022-11-261-0/+5
|
* Mention new programming language support in manualStefan Kangas2022-11-261-6/+6
| | | | | * doc/emacs/programs.texi (Program Modes): Mention newly added support for C#, TypeScript and JSON.
* ; Fix some typosMichael Heerdegen2022-11-261-1/+1
| | | | | * doc/emacs/programs.texi (Programming Language Doc): * lisp/wid-edit.el (lazy): Fix typos.
* ; * doc/emacs/programs.texi (Programming Language Doc): Fix typos.Eli Zaretskii2022-10-211-2/+2
|
* Improve and extend documentation of ElDocEli Zaretskii2022-10-211-34/+113
| | | | | | | | | | | | | | | | | | | | | * lisp/emacs-lisp/eldoc.el (eldoc-documentation-strategy) (eldoc-documentation-enthusiast) (eldoc-documentation-compose-eagerly) (eldoc-documentation-compose, eldoc-documentation-default) (eldoc-minibuffer-message, eldoc-idle-delay) (eldoc-print-after-edit) (eldoc-echo-area-display-truncation-message) (eldoc-echo-area-use-multiline-p) (eldoc-echo-area-prefer-doc-buffer): Doc string fixes. * doc/emacs/emacs.texi (Top): * doc/emacs/programs.texi (Documentation, Programming Language Doc): Rename "Lisp Doc" to "Programming Language Doc", including in parent menus. All references changed. (Programming Language Doc): Formerly "Lisp Doc". Rewrite to not be specific to Emacs Lisp. Improve markup and wording. Document more commands and variables. * doc/emacs/maintaining.texi (Maintaining): Improve indexing.
* Mention Eglot in the Emacs user manualEli Zaretskii2022-10-201-0/+14
| | | | | * doc/emacs/maintaining.texi (Xref): * doc/emacs/programs.texi (Symbol Completion, Imenu): Mention Eglot.
* Merge from origin/emacs-28Stefan Kangas2022-10-161-15/+26
|\ | | | | | | | | | | | | | | | | | | | | 067361f3a2 ; Improve documentation of 'C-M-i' fdb6f7cf26 ; Fix documentation of 'comp-enable-subr-trampolines' be30369e01 ; Avoid incorrect indentation in an @example. 4bd3dd505e Document how to control where the *.eln files are written b7d7c2d9e9 Add cross-reference to alternative syntaxes for Unicode # Conflicts: # doc/emacs/custom.texi
| * ; Improve documentation of 'C-M-i'Eli Zaretskii2022-10-161-15/+26
| | | | | | | | | | * doc/emacs/programs.texi (Symbol Completion): Remove redundant text, rephrase, and improve indexing and markup.
* | Merge from origin/emacs-28Stefan Kangas2022-10-081-3/+2
|\| | | | | | | cfb1e21844 Update name of hs-mouse-toggle-hiding in Emacs manual
| * Update name of hs-mouse-toggle-hiding in Emacs manualLars Ingebrigtsen2022-10-071-3/+2
| | | | | | | | | | * doc/emacs/programs.texi (Hideshow): Update the name of hs-mouse-toggle-hiding (bug#58331).
* | Merge from origin/emacs-28Stefan Kangas2022-10-071-5/+5
|\| | | | | | | | | 5f8849425c Fix typo in `(emacs) Lisp Doc' f0a06364fb Fix references to 'default-indent-new-line'
| * Fix typo in `(emacs) Lisp Doc'Stefan Kangas2022-10-061-2/+2
| | | | | | | | | | * doc/emacs/programs.texi (Lisp Doc): Fix reference to 'eldoc-echo-area-display-truncation-message'. (Bug#58324)
| * Fix references to 'default-indent-new-line'Stefan Kangas2022-10-061-3/+3
| | | | | | | | | | | | * doc/emacs/programs.texi (Comment Commands) (Multi-Line Comments): Fix references to 'default-indent-new-line'. (Bug#58325)
* | Merge from origin/emacs-28Stefan Kangas2022-10-041-3/+3
|\| | | | | | | | | | | | | | | | | | | 992611b10a Fix documentation of 'TAB' in cc-mode 08e485a2a5 Fix 'org-export-dispatch' command name in manual e5a49f44ff * src/emacs.c (load_pdump): Fix use of xpalloc. 7ff5207624 Avoid assertion violation in 'xpalloc' # Conflicts: # src/emacs.c
| * Fix documentation of 'TAB' in cc-modeStefan Kangas2022-10-031-3/+3
| | | | | | | | | | * doc/emacs/programs.texi (C Indent): Fix documentation of 'TAB' in cc-mode. (Bug#58258)
* | Default show-paren-mode to off in special-mode buffersLars Ingebrigtsen2022-09-021-4/+10
| | | | | | | | | | | | | | | | | | | | | | * doc/emacs/programs.texi (Matching): Mention the new user option. * doc/misc/efaq.texi (Matching parentheses): Adjust text to the current state of affairs. * lisp/paren.el (show-paren-function): New user option (bug#50894). (show-paren-mode): Mention it. (show-paren-function): Use it.
* | Enable keys M-down, M-up, M-RET for in-buffer completionJuri Linkov2022-05-221-3/+7
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * lisp/minibuffer.el (completion-in-region-mode-map): Add keybindings M-<up> for minibuffer-previous-completion, M-<down> for minibuffer-next-completion, M-RET for minibuffer-choose-completion. (completion-in-region-mode): Set buffer-local 'minibuffer-completion-auto-choose' to nil. (minibuffer-next-completion): Get the value of 'minibuffer-completion-auto-choose' from the minibuffer. (minibuffer-previous-completion): Simplify by delegating to 'minibuffer-next-completion'. * doc/emacs/programs.texi (Symbol Completion): Add description of keys M-down, M-up, M-RET. https://lists.gnu.org/archive/html/emacs-devel/2022-05/msg00916.html
* | Make imenu-flush-cache into a functionLars Ingebrigtsen2022-05-131-5/+0
| | | | | | | | | | | | | | * doc/emacs/programs.texi (Imenu): Remove documentation. * lisp/imenu.el (imenu-flush-cache): Make into a function, since this isn't supposed to be used interactively.
* | ; Improve documentation of 'imenu-flush-cache'Eli Zaretskii2022-05-121-4/+9
| | | | | | | | | | | | | | | | * etc/NEWS: Expand the description of 'imenu-flush-cache'. * doc/emacs/programs.texi (Imenu): Document 'imenu-flush-cache'. * lisp/imenu.el (imenu-flush-cache): Doc fix. (Bug#20589)
* | Bind 'imenu' to 'M-g i' globallySean Whitton2022-04-211-2/+2
| | | | | | | | | | | | | | | | | | | | | | Another candidate was 'M-s i'. Discussion on emacs-devel has led me to conclude that most people will find 'M-g i' more intuitive and thus easier to memorize. * lisp/bindings.el (goto-map): Bind 'imenu' to 'M-g i' globally. * etc/NEWS: Document the change. * doc/emacs/programs.texi (Imenu): * lisp/progmodes/cperl-mode.el: Replace 'M-x imenu' with 'M-g i'.
* | Merge from origin/emacs-28Eli Zaretskii2022-01-011-1/+1
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 836be7a112 ; * etc/refcards/ru-refcard.tex: Update Copyright year. 86cbc6ee4a * lisp/net/tramp-sh.el: Adapt copyright year ebe8772f65 ; Minor fixes related to copyright years 23c1ee6989 ; * test/manual/etags/ETAGS.good_N: Adjust to copyright ye... 8d3fc7ec89 * src/xfaces.c (face_for_font): Make 'hash' be uintptr_t. 19dcb237b5 ; Add 2022 to copyright years. # Conflicts: # etc/NEWS # etc/refcards/ru-refcard.tex # lib/cdefs.h # lisp/erc/erc-dcc.el # lisp/erc/erc-imenu.el # lisp/erc/erc-replace.el # lisp/image-dired.el # lisp/progmodes/xref.el # m4/alloca.m4 # m4/byteswap.m4 # m4/errno_h.m4 # m4/getopt.m4 # m4/gnulib-common.m4 # m4/inttypes.m4 # m4/stddef_h.m4 # m4/stdint.m4 # m4/sys_socket_h.m4
| * ; Add 2022 to copyright years.Eli Zaretskii2022-01-011-1/+1
| |
* | Audit the Emacs manual for keymap-*-related changesLars Ingebrigtsen2021-11-301-1/+1
| | | | | | | | | | | | | | | | * doc/emacs/programs.texi (Other C Commands): * doc/emacs/msdos-xtra.texi (MS-DOS Keyboard): * doc/emacs/custom.texi (Init Examples): * doc/emacs/abbrevs.texi (Editing Abbrevs): Change some examples to use keymap-* functions.
* | New option show-paren-context-when-offscreenDaniel Martín2021-10-181-0/+9
|/ | | | | | | | | | | | | | | | | * lisp/simple.el (blink-paren-open-paren-line-string): Extract functionality that shows the open paren line in the echo area into its own function, to reuse it from paren.el. (blink-matching-open): Use blink-paren-open-paren-line-string. * lisp/paren.el (show-paren-context-when-offscreen): New option show-paren-context-when-offscreen. (show-paren-function): Implement it using blink-paren-open-paren-line-string. * lisp/emacs-lisp/eldoc.el (eldoc-display-message-no-interference-p): Make sure the feature works well with eldoc. * test/lisp/paren-tests.el (paren-tests-open-paren-line): Test blink-paren-open-paren-line-string. * doc/emacs/programs.texi (Matching): Update the documentation. * etc/NEWS: And announce the new feature.
* Document the new paren-space indentation ruleLars Ingebrigtsen2021-09-251-0/+17
| | | | | * doc/emacs/programs.texi (Lisp Indent): Mention the new paren-space indentation rule.
* Stop imenu indexing after a certain number of secondsLars Ingebrigtsen2021-09-171-1/+3
| | | | | | | * doc/emacs/programs.texi (Imenu): Document it. * lisp/imenu.el (imenu-max-index-time): New user option. (imenu-default-create-index-function, imenu--generic-function): Use it (bug#18696).
* Improve documentation of Show Paren modeEli Zaretskii2021-09-111-13/+17
| | | | | * doc/emacs/programs.texi (Matching): Improve wording and indexing. (Bug#29381)
* New minor mode 'show-paren-local-mode'Dmitry Gutov2021-09-111-1/+2
| | | | | | | | | * lisp/paren.el (show-paren--delete-overlays): New function, extracted from show-paren-mode. (show-paren-local-mode): New minor mode. (show-paren-mode): Update docstring to mention it (bug#29381). * doc/emacs/programs.texi (Matching): Update show-paren-mode section.
* Tweak the comment-start-skip example in the manualLars Ingebrigtsen2021-08-211-6/+6
| | | | | * doc/emacs/programs.texi (Options for Comments): Tweak the example regexp for comment-start-skip (bug#15006).
* Update copyright year to 2021Paul Eggert2021-01-011-1/+1
| | | | Run "TZ=UTC0 admin/update-copyright".
* Allow disabling the verbose eldoc truncation messageLars Ingebrigtsen2020-09-211-0/+6
| | | | | | | | * doc/emacs/programs.texi (Lisp Doc): Document it. * lisp/emacs-lisp/eldoc.el (eldoc-display-truncation-message): New variable (bug#43543). (eldoc--handle-docs): Use it.
* Merge from origin/emacs-27Glenn Morris2020-07-111-4/+4
|\ | | | | | | | | | | | | | | | | | | | | | | | | | | c04b92104c Add commentary in gtkutil.c 6290850dac Consistently stylize eldoc as ElDoc in prose 136e931189 Improve documentation of "C-u C-x =" 1f52771fd3 Mention floating rounding issues c892ae65b4 Repair global-auto-revert-ignore-modes (bug#42271) 3a446a02fb ; * src/xdisp.c (decode_mode_spec): Fix commentary. 79f381b4a6 One more improvement of left/right-fringe display spec docs 1279bdb072 Another clarification of left/right-fringe display spec # Conflicts: # doc/emacs/programs.texi
| * Consistently stylize eldoc as ElDoc in proseBasil L. Contovounesios2020-07-101-4/+4
| | | | | | | | | | | | | | | | | | | | | | | | * doc/emacs/custom.texi (Specifying File Variables): * doc/emacs/modes.texi (Major Modes): * doc/emacs/programs.texi (Lisp Doc): * etc/NEWS.22: * etc/NEWS.23: * lisp/progmodes/python.el: (python-eldoc-function): * test/lisp/progmodes/python-tests.el: Consistently capitalize eldoc as ElDoc rather than Eldoc.
* | Better handle asynchronous Eldoc sourcesJoão Távora2020-07-081-4/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This is a backward compatible redesign of significant parts of the eldoc.el library. Previously, Eldoc clients (major/minor modes setting its documentation gathering variables) needed to directly call eldoc-message, an internal function, to display the docstring to the user. When more asynchronous sources are involved, this is hard to do or even breaks down. Now, an Eldoc backend may return any non-nil, non-string value and call a callback afterwards. This restores power to Eldoc over how (and crucially also when) to display the docstrings to the user. Among other things, this fixes so called "doc blinking", or the very short-lived display of a lower priority Eldoc message. This would happen if a particular producer of documentation finishes shortly before a higher priority one, like in the LSP engine Eglot as reported by Andrii Kolomoiets <andreyk.mad@gmail.com> and Dmitry Gutov <dgutov@yandex.ru>. Gathering docstrings is now delegated to the variable eldoc-documentation-strategy, which is the new name for the now-obsolete eldoc-documentation-function, and still accepts the so-called "old protocol". Examples of the new strategies enabled are codified in functions such as eldoc-documentation-enthusiast, eldoc-documentation-compose-eagerly, along with the existing eldoc-documentation-compose and eldoc-documentation-default. The work of displaying and formatting docstrings is shifted almost fully to Eldoc itself and is delegated to the internal function eldoc--handle-docs. Among other improvements, it handles most of eldoc-echo-area-use-multiline-p and outputs documentation to a temporary *eldoc* buffer. The manual and NEWS are updated to mention the new Eldoc features. * lisp/emacs-lisp/eldoc.el (eldoc-documentation-functions): Overhaul docstring. (eldoc-documentation-compose, eldoc-documentation-default): Handle non-nil, non-string values of elements of eldoc-documentation-functions. Use eldoc--handle-multiline. (eldoc-print-current-symbol-info): Honour non-nil, non-string values returned by eldoc-documentation-callback. (eldoc--make-callback): Now also a function. (eldoc-documentation-default, eldoc-documentation-compose): Tweak docstring. (eldoc-documentation-enthusiast, eldoc-documentation-compose-eagerly): New functions. (eldoc-echo-area-use-multiline-p): Add new semantics. (eldoc--handle-docs): Handle some of eldoc-echo-area-use-multiline-p. (eldoc-doc-buffer): New command. (eldoc-prefer-doc-buffer): New defcustom. (eldoc--enthusiasm-curbing-timer): New variable. (eldoc-documentation-strategy): Rename from eldoc-documentation-function. (eldoc--supported-p): Use eldoc-documentation-strategy (eldoc-highlight-function-argument) (eldoc-argument-case, global-eldoc-mode) (turn-on-eldoc-mode): Mention eldoc-documentation-strategy. (eldoc-message-function): Mention eldoc--message. (eldoc-message): Made obsolete. (eldoc--message): New helper. * lisp/hexl.el (hexl-print-current-point-info): Adjust to new eldoc-documentation-functions protocol. * lisp/progmodes/cfengine.el (cfengine3-documentation-function): Adjust to new eldoc-documentation-functions protocol. * lisp/progmodes/elisp-mode.el (elisp-eldoc-documentation-function): Adjust to new eldoc-documentation-functions protocol. * lisp/progmodes/octave.el (octave-eldoc-function): Adjust to new eldoc-documentation-functions protocol. * lisp/progmodes/python.el (python-eldoc-function): Adjust to new eldoc-documentation-functions protocol. (eldoc-print-current-symbol-info): Rework with cl-labels. * doc/emacs/programs.texi (Lisp Doc): Mention eldoc-documentation-strategy. * doc/lispref/modes.texi (Major Mode Conventions): Mention eldoc-documentation-functions. * etc/NEWS: Mention eldoc-documentation-strategy.
* | Expose ElDoc functions in a hook (Bug#28257)Mark Oteiza2020-02-251-3/+21
|/ | | | | | | | | | | | | | | | | | | | | | * lisp/emacs-lisp/eldoc.el: Update commentary. (eldoc--eval-expression-setup): Use new hook. (eldoc--supported-p): Accomodate new hook. (eldoc-documentation-functions): New hook. (eldoc-documentation-default, eldoc-documentation-compose): New functions. (eldoc-documentation-function): Use 'eldoc-documentation-default' as new default value. Update documentation and custom attributes. (eldoc-print-current-symbol-info): Accomodate possible null value for 'eldoc-documentation-function'. * etc/NEWS: Mention them. * doc/emacs/programs.texi (Emacs Lisp Documentation Lookup): Mention new hook and changes to 'eldoc-documentation-function'. * lisp/hexl.el (hexl-mode, hexl-revert-buffer-function): * lisp/ielm.el (inferior-emacs-lisp-mode): * lisp/progmodes/cfengine.el (cfengine3-mode): * lisp/progmodes/elisp-mode.el (emacs-lisp-mode): * lisp/progmodes/octave.el (octave-mode): * lisp/progmodes/python.el (python-mode): Use new hook.
* Update copyright year to 2020Paul Eggert2020-01-011-1/+1
| | | | Run "TZ=UTC0 admin/update-copyright $(git ls-files)".
* Merge from origin/emacs-26Glenn Morris2019-06-151-5/+6
|\ | | | | | | | | | | | | | | | | f53ce87 ; ChangeLog.3 update eca2677 Fix description of 'display-buffer-in-previous-window' again ... 7be50cd Consistently use @minus{} for negative arguments # Conflicts: # ChangeLog.3
| * Consistently use @minus{} for negative argumentsEli Zaretskii2019-06-111-5/+6
| | | | | | | | | | | | | | | | | | | | | | * doc/emacs/mark.texi (Marking Objects): * doc/misc/gnus.texi (Selecting a Group): * doc/emacs/programs.texi (Comment Commands): * doc/emacs/killing.texi (Deletion): * doc/emacs/display.texi (Recentering): * doc/lispref/display.texi (Face Attributes): * doc/lispref/searching.texi (String Search, Regexp Search): Make the markup of "-N" use @minus{} uniformly. (Bug#35885)
* | Merge from origin/emacs-26Glenn Morris2019-05-221-1/+4
|\| | | | | | | | | | | | | | | | | | | b0da915 (origin/emacs-26, emacs-26) Fix a typo in ELisp manual 400907b Add option to disable help completion autoloading (Bug#28607) 122ba16 Don't segfault on force-window-update of deleted window 015b12e Fix typo in ELisp manual eadf044 Remove repeated function call in picture.el 1228a90 ; Fix mm-destroy-parts docstring typo 6cfd68d Fix Hideshow key binding typo in Emacs manual
| * Fix Hideshow key binding typo in Emacs manualBasil L. Contovounesios2019-05-191-1/+4
| | | | | | | | | | * doc/emacs/programs.texi (Hideshow): Add missing function and key index entries. Fix hs-toggle-hiding binding typo. (bug#35798)
* | Merge from origin/emacs-26Paul Eggert2018-12-311-1/+1
|\| | | | | | | | | | | 2fcf2df Fix copyright years by hand 26bed8b Update copyright year to 2019 2814292 Fix value of default frame height. (Bug#33921)
| * Update copyright year to 2019Paul Eggert2019-01-011-1/+1
| | | | | | | | Run 'TZ=UTC0 admin/update-copyright $(git ls-files)'.
* | Merge from origin/emacs-26Glenn Morris2018-09-151-0/+4
|\| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | e133b63 (origin/emacs-26) Avoid adverse side effects of fixing bug#21824 cc8f334 Document changes called out in NEWS 20ecc52 ; * etc/NEWS: Document recent change in 'thing-at-point'. 1fc5283 ; INSTALL: Fix a typo in the last commit. 24f240d Tiny doc updates re yum/dnf etc 41c2d25 Remove unused variable 1e3b3fa Fix (thing-at-point 'list) regression (Bug#31772) 219893a Clarify meaning of '*' 41cdda2 * etc/PROBLEMS: Document Ubuntu 16.04 issue. 1c22f03 Increase default value for imenu-auto-rescan-maxout ee84389 Improve recent change to ELisp manual ff374e4 * doc/lispref/display.texi (SVG Images): Improve wording. 3a0caf6 * doc/lispref/display.texi (SVG Images): Fix a typo. (Bug#32... Conflicts: doc/lispref/lists.texi etc/NEWS
generated by cgit v1.2.3 (git 2.39.1) at 2025-04-05 17:57:00 +0000