summaryrefslogtreecommitdiff
path: root/doc/emacs/maintaining.texi
Commit message (Collapse)AuthorAgeFilesLines
* Improve documentation of selection and navigation in *xref* buffersEli Zaretskii2024-04-231-17/+36
| | | | | | | | | | * doc/emacs/maintaining.texi (Looking Up Identifiers): More detailed description of 'xref-auto-jump-to-first-definition'. Improve indexing. Describe the use of 'next-error' and 'previous-error' in conjunction with the *xref* buffer. (Identifier Search): More detailed description of 'xref-auto-jump-to-first-xref'. Describe the use of 'next-error' and 'previous-error'.
* ; Tweak "(emacs)Bug Reference" formatting/wording.Basil L. Contovounesios2024-04-131-24/+27
|
* ; Add 2024 to copyright yearsPo Lu2024-01-021-1/+1
|
* ; Improve documentation of VC commandsEli Zaretskii2023-10-081-127/+177
| | | | | | | | | * doc/emacs/maintaining.texi (Basic VC Editing) (VC With A Merging VCS, VC With A Locking VCS, Advanced C-x v v) (Registering, Pulling / Pushing, Merging): Improve wording, accuracy, and indexing. * lisp/vc/vc.el (vc-next-action): Doc fix.
* ; Fix typo in maintaining.texi (bug#64279)Eshel Yaron2023-06-251-1/+1
| | | | * doc/emacs/maintaining.texi (Log Buffer): Fix a typo.
* ; Minor fixes in documentation of recently-changed VC commandsEli Zaretskii2023-05-261-3/+4
| | | | | | | | | | * lisp/vc/vc.el (vc-print-branch-log, vc-create-branch) (vc-create-tag, vc-retrieve-tag, vc-switch-branch): Doc fixes. * lisp/vc/vc-hooks.el (vc-menu-map): Minor wording change in :help text. * doc/emacs/maintaining.texi (VC Change Log, Creating Branches): Minor wording and markup changes.
* Add vc-create/switch/print-branch to menu and update documentation (bug#63690)Juri Linkov2023-05-251-1/+17
| | | | | | | | | | | | | * doc/emacs/maintaining.texi (VC Change Log): Add 'C-x v b l' (vc-print-branch-log). (Creating Branches): Add @kindex and @findex for vc-create-branch. (Switching Branches): Add @kindex and @findex for vc-switch-branch. * lisp/vc/vc-hooks.el (vc-menu-map): Add menu items for new commands vc-create-branch and vc-switch-branch, and also vc-print-branch-log. * lisp/vc/vc.el (vc-print-branch-log): Improve docstring.
* Fix the documentation of various aspects of adding Xref historyEli Zaretskii2023-03-171-5/+14
| | | | | | | | | | | | | | | | * lisp/progmodes/xref.el (xref-marker-ring-length) (xref-set-marker-ring-length): * lisp/progmodes/etags.el (tags-location-ring-length) (find-tag-marker-ring): Add doc strings saying the variables are unused. * etc/NEWS: Enhance the description of the change which made Xref marker stack unlimited in its length. * doc/emacs/maintaining.texi (Looking Up Identifiers): Add back text lost when xref forward history was added in bug#38797. Explain the difference between 'C-M-,' and 'M-.'. Improve wording (Bug#62229)
* Improve documentation of VC commands, including in DiredEli Zaretskii2023-02-231-14/+45
| | | | | | | | | | | | * doc/emacs/dired.texi (Operating on Files): * doc/emacs/maintaining.texi (VC Change Log, VC Directory Mode) (Version Control, Basic VC Editing): Document VC command invocation from Dired buffers. Improve documentation of vc-log commands. * lisp/dired-aux.el (dired-vc-next-action): * lisp/vc/vc.el (vc-print-log, vc-log-search, vc-log-mergebase) (vc-log-view-type, vc-print-root-log, vc-next-action): Doc fixes.
* * doc/emacs/maintaining.texi: More mentions of marked files in Dired.Juri Linkov2023-02-231-3/+5
| | | | | (Basic VC Editing, Old Revisions, VC Change Log): Add more mentions of ability to include the marked files to the VC fileset in Dired (bug#61712).
* * lisp/vc/vc-dir.el: Make keys ‘% m’ and ‘* %’ compatible with DiredJuri Linkov2023-01-181-1/+8
| | | | | | | | (vc-dir-mode-map): Replace ‘%’ for vc-dir-mark-by-regexp with ‘% m’ in regexp-map and ‘* %’ in mark-map (bug#60887). * doc/emacs/maintaining.texi (VC Directory Commands): Replace ‘%’ with ‘% m’ and ‘* %’. Mention vc-dir-mark-registered-files.
* ; Add 2023 to copyright years.Eli Zaretskii2023-01-011-1/+1
|
* ; Fix typosStefan Kangas2022-12-261-1/+1
| | | | (cherry picked from commit a5d39e11443fa30c8e8bc58254a1a59550dcd99e)
* Update project docs and NEWSDmitry Gutov2022-12-011-5/+5
| | | | | | * doc/emacs/maintaining.texi (Projects): Update the name. * etc/NEWS: Mention new option (bug#41572).
* New command 'project-list-buffers' bound to 'C-x p C-b' (bug#59153)Juri Linkov2022-11-151-0/+7
| | | | | | | | | | | | | | * doc/emacs/maintaining.texi (Project Buffer Commands): Add 'project-list-buffers'. * lisp/buff-menu.el (Buffer-menu-filter-predicate): New defvar-local. (list-buffers-noselect): Add new optional arg 'filter-predicate'. Set 'Buffer-menu-filter-predicate' to 'filter-predicate'. (list-buffers--refresh): Use 'Buffer-menu-filter-predicate'. * lisp/progmodes/project.el (project-prefix-map): Bind "\C-b" to 'project-list-buffers'. (project-list-buffers): New command.
* ; Fix quoting of non-nil in texinfo sourcesStefan Kangas2022-10-271-1/+1
|
* Improve and extend documentation of ElDocEli Zaretskii2022-10-211-0/+2
| | | | | | | | | | | | | | | | | | | | | * 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/+7
| | | | | * doc/emacs/maintaining.texi (Xref): * doc/emacs/programs.texi (Symbol Completion, Imenu): Mention Eglot.
* ; Fix last change.Eli Zaretskii2022-10-101-1/+1
|
* ; Clarify correct use of 'xref-query-replace-in-results'Eli Zaretskii2022-10-101-7/+12
| | | | | | | | | | * lisp/progmodes/xref.el (xref--query-replace-1): Improve the user-error message. (xref-query-replace-in-results): Clarify restrictions in the doc string. * doc/emacs/maintaining.texi (Xref Commands, Identifier Search): Clarify the correct usage of 'xref-query-replace-in-results'.
* In vc-git-log-incoming use the repository in the command "fetch" (bug#50340)Juri Linkov2022-10-021-4/+5
| | | | | | | | | | | | * lisp/vc/vc-git.el (vc-git-log-incoming): Use repository part from non-nil remote-location in the command "fetch". * lisp/vc/vc.el (vc-log-incoming, vc-log-outgoing): Mention in docstrings and prompts that REMOTE-LOCATION can be a remote branch name. * doc/emacs/maintaining.texi (VC Change Log): For commands vc-log-incoming and vc-log-outgoing, use the term "remote location" instead of "repository".
* Merge from origin/emacs-28Stefan Kangas2022-09-211-1/+8
|\ | | | | | | | | | | | | | | | | | | | | | | 478b786d5a ; * doc/lispref/windows.texi (Window Hooks): Fix a typo (b... 5085351645 * lisp/text-modes/tex-mode.el (tex-mode): Fix AUCTeX regre... ee6f8598ca Add vc-annotate-switches to manual 616dcf27e5 ; Fix typos in Lisp symbols 5405852541 Remove mention of non-existent `annotate-switches' 191505b8a3 Mention that src/macuvs.h sometimes needs committing 10373c4b68 ; More comment fixes in font.h (bug#57935) c2595b8dcc ; * src/font.h (struct font_driver): Comment fix. 97b928ce09 MacOS ld warning from native compilation (bug#57849)
| * Add vc-annotate-switches to manualRobert Pluim2022-09-201-1/+8
| | | | | | | | | | * doc/emacs/maintaining.texi (Old Revisions): Add description of `vc-annotate-switches' and `vc-BACKEND-annotate-switches'.
* | Document the recently added branch commands (bug#50344)Juri Linkov2022-09-121-9/+10
| | | | | | | | | | | | | | | | | | | | | | | | * doc/emacs/maintaining.texi (VC Directory Commands): Change the prefix key from "B" to "b". Replace vc-create-tag with vc-create-branch, and vc-retrieve-tag with vc-switch-branch. (Switching Branches): Mention vc-switch-branch bound to 'C-x v b s'. (Creating Branches): Mention vc-create-branch bound to 'C-x v b c'. * lisp/vc/vc-dir.el (vc-dir-mode-map): In branch keymap 'b' rebind "c" from vc-create-tag to vc-create-branch, and "s" from vc-retrieve-tag to vc-switch-branch.
* | Add new user option 'diff-add-log-use-relative-names'Philip Kaludercic2022-09-081-1/+5
| | | | | | | | | | | | | | | | * .dir-locals.el: Set new option to t * etc/NEWS: Mention new option. * lisp/vc/diff-mode.el (diff-add-log-use-relative-names): Add new option. (diff-add-log-current-defuns): Use new option. * doc/emacs/maintaining.texi (Log Buffer): Mention new option.
* | Merge from origin/emacs-28Stefan Kangas2022-09-021-24/+24
|\| | | | | | | | | 917da2641e Minor doc fix; improve sorting of VC backends 89695bce3e Clarify the doc string of 'set-face-attribute'
| * Minor doc fix; improve sorting of VC backendsStefan Kangas2022-09-011-24/+24
| | | | | | | | | | * doc/emacs/maintaining.texi (Version Control Systems): Minor doc fix; rearrange list to put git, cvs and subversion at the top.
* | Fix typo in previous maintaining.texi changeLars Ingebrigtsen2022-06-281-1/+1
| | | | | | | | * doc/emacs/maintaining.texi (Looking Up Identifiers): Fix typo.
* | Clarify Looking Up Identifiers in the manualLars Ingebrigtsen2022-06-281-2/+2
| | | | | | | | | | * doc/emacs/maintaining.texi (Looking Up Identifiers): Clarify the text about C-M-, (bug#56261).
* | Merge from origin/emacs-28Stefan Kangas2022-06-111-0/+7
|\| | | | | | | | | | | | | 0705705ebf Improve documentation of "etags -I" 0ad8cd40ce Merge branch 'emacs-28' of git.savannah.gnu.org:/srv/git/e... 22a832ad82 Mention the #f syntax from cl-prin1 3fd0854378 Fix file name quoting in tramp-smb.el (do not merge)
| * Improve documentation of "etags -I"Eli Zaretskii2022-06-101-0/+7
| | | | | | | | | | | | * doc/man/etags.1: * doc/emacs/maintaining.texi (Create Tags Table): Elaborate on the importance of the '-I' option to 'etags'. (Bug#45246)
* | Add new user option project-vc-include-untrackedJan Synáček2022-06-041-0/+3
| | | | | | | | | | * doc/emacs/maintaining.texi (Projects): Document it. * lisp/progmodes/project.el (project--vc-list-files): Use it.
* | Add new command 'vc-dir-mark-by-regexp'Lars Ingebrigtsen2022-05-111-0/+6
| | | | | | | | | | | | * doc/emacs/maintaining.texi (VC Directory Commands): Document it. * lisp/vc/vc-dir.el (vc-dir-mode-map): Bind it to `%'. (vc-dir-mark-by-regexp): New command (bug#16460).
* | Further log-view-file-next fix-upsLars Ingebrigtsen2022-05-061-9/+0
| | | | | | | | | | | | | | * doc/emacs/maintaining.texi (VC Change Log): Remove the entries for commands now removed from most VCs. * lisp/vc/log-view.el (log-view-mode-menu): Disable menu entries (bug#14531).
* | Document project-kill-buffers-display-buffer-listLars Ingebrigtsen2022-04-161-1/+4
| | | | | | | | | | | | | | | | * doc/emacs/maintaining.texi (Project Buffer Commands): Mention project-kill-buffers-display-buffer-list. * lisp/progmodes/project.el (project-kill-buffers): Link to project-kill-buffers-display-buffer-list.
* | Document prefix to project-find-fileLars Ingebrigtsen2022-04-161-1/+4
| | | | | | | | | | * doc/emacs/maintaining.texi (Project File Commands): Mention the prefix in the project-find-file command.
* | Merge from origin/emacs-28Stefan Kangas2022-03-251-12/+22
|\| | | | | | | d3d6f1c9bd Clarify the description of "selected tags table"
| * Clarify the description of "selected tags table"Eli Zaretskii2022-03-241-12/+22
| | | | | | | | | | | | * doc/emacs/maintaining.texi (Select Tags Table): Clarify the distinction between the "selected tags table" and the "current list of tags tables". (Bug#54543)
* | Fix @item in the Emacs manualJuri Linkov2022-01-141-1/+1
| | | | | | | | | | | | * doc/emacs/maintaining.texi (Identifier Search): Replace @itemx with @item. * doc/emacs/search.texi (Special Isearch): Remove @item.
* | Update docs of 'xref-query-replace-in-results'Eli Zaretskii2022-01-141-7/+11
| | | | | | | | | | * doc/emacs/maintaining.texi (Identifier Search): Update the documentation of 'xref-query-replace-in-results'.
* | Improve documentation of 'xref-find-references-and-replace'Eli Zaretskii2022-01-141-0/+9
| | | | | | | | | | | | | | * etc/NEWS: Clarify the 'xref-find-references-and-replace' entry. * doc/emacs/maintaining.texi (Identifier Search): Document 'xref-find-references-and-replace'.
* | 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
| |
* | Merge from origin/emacs-28Stefan Kangas2021-11-101-1/+1
|\| | | | | | | | | | | | | | | | | | | | | | | 8d81ab374d time-stamp: %F is "file name" not "pathname" + other doc beaa7e14f3 ; Fix typos in CONTRIBUTE, ELisp manual, ediff 747a1ae4ac * doc/misc/eww.texi (Advanced): Fix missed variable name e... 52fe2340b8 * doc/emacs/windows.texi (Window Convenience): Use @code f... 7d3a654e2a * doc/emacs/maintaining.texi (Basic VC Editing): Mention D... aeb19af4b5 ; * doc/emacs/building.texi (Lisp Libraries): Fix a typo. ... # Conflicts: # etc/NEWS
| * * doc/emacs/maintaining.texi (Basic VC Editing): Mention Dired buffer.Juri Linkov2021-11-091-1/+1
| | | | | | | | | | | | * doc/emacs/text.texi (Outline Mode): Replace S-TAB with with S-<TAB>. * etc/NEWS: Add some missing +++/--- and move some related items closer.
* | Rename `xref-pop-marker-stack` to `xref-go-back` (bug#38797)Mattias Engdegård2021-10-251-3/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | It is the natural name after the addition of `xref-go-forward`. The old name is retained as an alias. * lisp/progmodes/xref.el (xref-pop-marker-stack): Rename. (xref-go-forward, xref-quit-and-pop-marker-stack) (xref-find-definitions): * lisp/menu-bar.el (menu-bar-goto-menu): * lisp/progmodes/etags.el (find-tag-marker-ring, pop-tag-mark): * lisp/progmodes/prog-mode.el (prog-context-menu): * doc/emacs/maintaining.texi (Looking Up Identifiers): * etc/NEWS: Use the new name.
* | Add xref forward history (bug#38797)Mattias Engdegård2021-10-251-4/+9
|/ | | | | | | | | | | | | | | | | | | | | Make it possible to go forward as well as back in the Xref history. The new `xref-go-forward` is bound to `C-M-,`. * lisp/progmodes/etags.el (find-tag-marker-ring-length): Update. (tags-location-ring-length): New. (find-tag-marker-ring): Keep as dummy. (tags-location-ring, tags-reset-tags-tables): Use `tags-location-ring-length` instead of `xref-marker-ring-length`. * lisp/progmodes/xref.el (xref-marker-ring-length, xref-marker-ring) (xref-set-marker-ring-length): Make obsolete. (xref--history, xref-go-forward, xref-forward-history-empty-p): New. (xref-push-marker-stack, xref-pop-marker-stack) (xref-clear-marker-stack, xref-marker-stack-empty-p): Use `xref--history`. * lisp/menu-bar.el (menu-bar-goto-menu): Add Forward entry. * doc/emacs/maintaining.texi (Looking Up Identifiers): Document. * etc/NEWS: Announce.
* Add missing parentheses in the Emacs manualYan2021-10-141-2/+2
| | | | | | | * doc/emacs/maintaining.texi (Xref Commands): Add missing parentheses (bug#51195). Copyright-paperwork-exempt: yes
* ; Fix two typos where em dash was written as en dashStefan Kangas2021-10-081-1/+1
|
* Rename project-remove-known-project to project-forget-projectDmitry Gutov2021-09-211-3/+3
| | | | | | | | | | * doc/emacs/maintaining.texi (Managing Projects): Ditto. * etc/NEWS: Update accordingly. * lisp/progmodes/project.el (project-forget-project): Rename from 'project-remove-known-project', for consistency with 'project-remember-project' (discussed in bug#50297).