summaryrefslogtreecommitdiff
path: root/doc/misc
Commit message (Collapse)AuthorAgeFilesLines
* Update to Transient v0.4.0Jonas Bernoulli2023-05-111-2/+2
| | | | Or strictly speaking v0.4.0-1-g428576a4.)
* Eglot: re-rename eglot-upgrade to eglot-upgrade-eglotJoão Távora2023-05-051-2/+2
| | | | | | | | | | | * doc/misc/eglot.texi (Getting the latest version): Mention eglot-upgrade-eglot. * etc/EGLOT-NEWS: Mention eglot-upgrade-eglot. * lisp/progmodes/eglot.el (eglot-upgrade-eglot): Rename from eglot-update. (eglot-update): New compatibility alias.
* Rename eglot-update to eglot-upgradeDmitry Gutov2023-05-041-1/+1
| | | | | | | | | * doc/misc/eglot.texi (Getting the latest version): Update the reference. * lisp/progmodes/eglot.el (eglot-upgrade): Rename from 'eglot-update', as discussed on emacs-devel, in line with 'package-upgrade'.
* Fix eglot.texiEli Zaretskii2023-04-281-12/+21
| | | | | | * doc/misc/eglot.texi (Troubleshooting Eglot): Add missing @menu. (Performance, Getting the latest version): Improve wording and indexing, add cross-references.
* Eglot: explain how to update Eglot in manual (bug#62720)João Távora2023-04-281-1/+31
| | | | | | * lisp/progmodes/eglot.el (eglot-update): New command. * doc/misc/eglot.texi (Troubleshooting): Rework.
* Explain ERC 5.5 regressions in new version 5.5.0.29.1F. Jason Park2023-04-261-1/+1
| | | | | | | | | | | | | | | | | | | | * doc/misc/erc.texi: Bump version to 5.5.0.29.1. * etc/ERC-NEWS: Don't hype bugged option `erc-reconnect-display'. * lisp/erc/erc-dcc.el (erc-dcc-do-GET-command): Add comment explaining parsing bug in ERC 5.5 (bug#62444). * lisp/erc/erc-networks.el (erc-networks-on-MOTD-end): Mention known /MOTD bug in error notice so people don't waste energy reporting it (bug#62151). * lisp/erc/erc.el: Change Version header to 5.5.0.29.1. Don't bother updating the `customize-package-emacs-version-alist' entry because no option defaults are affected. (erc-version): Change version to 5.5.0.29.1. (erc-reconnect-display, erc-query-on-unjoined-chan-privmsg): Add warning to doc strings and `custom-set' functions. It's believed that these bugs degrade the user experience significantly enough to warrant such mentions (bug#62833). (erc-query): Fix erroneous redirect string in deprecation spec. Do not merge to master.
* * doc/misc/erc.texi: Elaborate on upgrading via ELPA.F. Jason Park2023-04-261-0/+20
|
* Update to Org 9.6.4-2-g0f6ae7Kyle Meyer2023-04-161-2/+3
|
* ; * doc/misc/calc.texi (Rewrites Tutorial): Fix a typo (bug#62658).Eli Zaretskii2023-04-081-1/+1
|
* ; Minor addition to the Emacs FAQEli Zaretskii2023-04-081-5/+15
| | | | | | * doc/misc/efaq.texi (Fullscreen mode on MS-Windows): Tell how to avoid the initial screen changing size on display without using the Registry. Suggested by David Hedlund <public@beloved.name>.
* * doc/misc/tramp.texi (Remote shell setup): Clarify use of ssh RemoteCommand.Michael Albinus2023-03-291-5/+6
|
* Update to Transient v0.3.7-218-g3dbb22aJonas Bernoulli2023-03-261-0/+14
|
* Adapt Tramp manualMichael Albinus2023-03-241-9/+21
| | | | | | * doc/misc/tramp.texi (Default Method): OpenSSH for MS Windows can be used. (Ssh setup): Extend for MS Windows and ssh.
* ; Minor copyedits to Eglot manualJoão Távora2023-03-231-14/+14
| | | | * doc/misc/eglot.texi (Troubleshooting Eglot): Minor fixes.
* ; Minor fixes in recent Eglot changesEli Zaretskii2023-03-181-1/+1
| | | | | | | * doc/misc/eglot.texi (Project-specific configuration): Fix whitespace. * lisp/progmodes/eglot.el (eglot-diagnostics-map): Doc fix.
* ; * doc/misc/eglot.texi (Eglot Commands): Improve indexing.Eli Zaretskii2023-03-181-1/+3
|
* ; Again correct node reference casing in doc/misc/eglot.texiJoão Távora2023-03-181-1/+1
| | | | | | | | Emacs's info-generating Texinfo incantation seems to be case insensitive, but others -- like Eglot's HTML manual generation -- is case sensitive. * doc/misc/eglot.texi (Eglot Features): Fix.
* Merge confusing duplicate sections on commands in Eglot manualJoão Távora2023-03-181-55/+35
| | | | | | | Also describe eglot-diagnostics-map. * doc/misc/eglot.texi (Eglot Features): Don't describe commands here. (Eglot Commands): Describe commands here.
* ; Prefer "language server" to "LSP server" in Eglot manualJoão Távora2023-03-181-15/+17
| | | | | | * eglot.texi (Quick Start, Customizing Eglot) (Project-specific configuration) (Troubleshooting Eglot): LSP server -> language server.
* ; Correct last commit, downcase node referenceJoão Távora2023-03-171-1/+1
| | | | * doc/misc/eglot.texi (Troubleshooting Eglot): Downcase node reference
* Enhance section about troubleshooting in Eglot manual.João Távora2023-03-171-28/+78
| | | | * doc/misc/eglot.texi (Troubleshooting Eglot): Parially rewrite.
* ; Add WebDAV entry to index in Tramp manualStefan Kangas2023-03-161-0/+1
| | | | * doc/misc/tramp.texi (GVFS-based methods): Improve indexing.
* Refer to EWW instead of w3 and w3mStefan Kangas2023-03-161-4/+3
| | | | | * doc/misc/idlwave.texi (Help with HTML Documentation): Refer to EWW instead of w3 and w3m.
* ; Tweak doc/misc/eglot.texiJoão Távora2023-03-151-5/+6
| | | | | * doc/misc/eglot.texi (Advanced server configuration): Minor tweaks.
* Document how to construct JSONRPC arrays in Eglot manualMichael Eliachevitch2023-03-151-7/+12
| | | | | | | | | | | | Many language server configuration options are of the JSON array datatype, for example argument lists for executables, but there wasn't any example of that in the Eglot manual. * doc/misc/eglot.texi (User-specific configuration) (User-specific configuration): Tweaks. (JSONRPC objects in Elisp): Mention JSON arrays. Tweak example. Copyright-paperwork-exempt: Yes
* Update Eglot's manual about eglot-workspace-configurationJoão Távora2023-03-131-47/+67
| | | | | | | | | | | | | | There is a possible use for a global setting eglot-workspace-configuration, which is to (ab)use it to set user-specific configuration when the server doesn't permit other methods. Rearrange the "Advanced server configuration" section and describe that use in the manual. * doc/misc/eglot.texi (Project-specific configuration): Correct mistake about global usefulness of eglot-workspace-configuration. (Advanced server configuration): Swap order of sections. (User-specific configuration): Mention possibility of globally setting eglot-workspace-configuration.
* ; * doc/misc/eglot.texi (Project-specific configuration): Fix typo.Yuan Fu2023-03-091-1/+1
|
* Add chapter on advanced server configuration to Eglot manualJoão Távora2023-03-091-94/+242
| | | | | | * doc/misc/eglot.texi (Top): Add section "Advanced server configuration" (Setting Up LSP Servers): Rework. (Advanced server configuration): New chapter.
* Update to Org 9.6.1-40-g3d817cKyle Meyer2023-03-051-1/+2
|
* Release ERC 5.5F. Jason Park2023-03-031-1/+1
| | | | | | | | | * doc/misc/erc.texi: Update ERCVER to 5.5. * lisp/erc/erc.el: Increment main version header to 5.5. Update Compat version in package-requires header to 29.1.3.4. Update `customize-package-emacs-version-alist' entry by mapping ERC 5.5 to Emacs 29.1. (erc-version): Update value to 5.5.
* ; * doc/misc/gnus.texi: Fix last change.Eli Zaretskii2023-02-271-11/+11
|
* ; Add `nnimap-user' to Gnus manualArash Esbati2023-02-271-0/+17
| | | | | | | * doc/misc/gnus.texi (Customizing the IMAP Connection): Document backend variable `nnimap-user' which was introduced with commit 5e68f8614f in 2011. Add index entries for all backend variables. (bug#61837)
* Eglot: simplify inlay hints implementation with jit-lockJoão Távora2023-02-241-8/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | This implementation is much simpler than the one based on windows-scroll-functions. It's also supposedly safer, as long as jit-lock guarantees refontification of affected regions. It's not _trivially_ simple though, as simply adding 'eglot--update-hints-1' to jit-lock-functions, while possible, is going to request inlay hints from the LSP server for many small regions of the buffer, depending on what jit-lock thinks is best. So we keep coalescing these into a larger region until the time is suitable for a more bandwidth-efficient request. To do this, we use a jit-lock implementation detail, jit-lock-context-unfontify-pos, which is a proxy for knowing that the jit-lock-context-timer has run. Not sure how brittle it is, but it seems to work reasonably. We also get rid of the previous "get hints for entire buffer" implementation. * doc/misc/eglot.texi (Eglot Variables): Remove mention to deleted eglot-lazy-inlay-hints. * lisp/progmodes/eglot.el (eglot-lazy-inlay-hints) (eglot--inlay-hints-after-scroll) (eglot--inlay-hints-fully) (eglot--inlay-hints-lazily): Remove. (eglot--update-hints): Add function. (eglot-inlay-hints-mode): Simplify.
* Eglot: implement inlay hints (bug#61412, bug#61066)João Távora2023-02-221-0/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Inlay hints are small text annotations to specific parts of the whole buffer, not unlike diagnostics, but designed to help readability instead of indicating problems. For example, a C++ LSP server can serve hints about positional parameter names in function calls and a variable's automatically deduced type. Emacs can display these hints in many little 0-length overlays with an 'before-string property, thus helping the user remember those types and parameter names. Since inlay hints are potentially a large amount of data to request from the LSP server, the implementation strives to be as parsimonious as possible with these requests. So, by default, inlay hints are only requested for the visible portions of the buffer across windows showing this buffer. This is done by leveraging the 'window-scroll-functions' variable, making for a reasonably complex implementation involving per-window timers. When scrolling a window, it may take a short amount of time for inlay hints to "pop in". The new user variable 'eglot-lazy-inlay-hints' can be used to exert some control over this. Specifically, if the variable's value is set to 'nil', then inlay hints are greedily fetched for the whole buffer every time a change occurs. This is a much simpler mode of operation which may avoid problems, but is also likely much slower in large buffers. Also, because the inlay feature is probably visually suprising to some, it is turned OFF by default, which is not the usual practice of Eglot (at least not when the necessary infrastructure is present). This decision may be changed soon. Here's a good one-liner for enabling it by default in every Eglot-managed buffer: (add-hook 'eglot-managed-mode-hook #'eglot-inlay-hints-mode) I haven't tested inlay hints extensively across many LSP servers, so I would appreciate any testing, both for functional edge cases and regarding performance. There are possibly more optimization oportunities in the "lazy" mode of operation, like more aggressively deleting buffer overlays that are not in visible parts of the buffer. Though I ended up writing this one from scratch, I want to thank Dimitry Bolopopsky <dimitri@belopopsky.com> and Chinmay Dala <dalal.chinmay.0101@gmail.com> for suggestions and early patches. * lisp/progmodes/eglot.el (eglot--lsp-interface-alist): Define InlayHint. (eglot-client-capabilities): Announce 'inlayHint' capability. (eglot-ignored-server-capabilities): Add :inlayHintProvider. (eglot--document-changed-hook): New helper hook. (eglot--after-change): Use it. (eglot-inlay-hint-face, eglot-type-hint-face) (eglot-parameter-hint-face): New faces. (eglot--update-hints-1, eglot--inlay-hints-after-scroll) (eglot--inlay-hints-fully, eglot--inlay-hints-lazily): New helpers. (eglot-lazy-inlay-hints): New user variable. (eglot-inlay-hints-mode): New minor mode. (eglot--maybe-activate-editing-mode): Try to activate eglot-inlay-hints-mode. (eglot--before-change): Remove overlays immediately in the area being changed. (eglot--managed-mode-off): Remove overlays. * doc/misc/eglot.texi (Eglot Features): Mention inlay hints. (Eglot Variables): Mention eglot-lazy-inlay-hints.
* ; Clarify "kill files" in Gnus manualEli Zaretskii2023-02-221-4/+5
| | | | | * doc/misc/gnus.texi (Scoring): Make the reference to kill files less vague. (Bug#61325)
* Update to Transient v0.3.7-216-gfe40342Jonas Bernoulli2023-02-201-3/+2
|
* Delete redundant question from Gnus FAQStefan Kangas2023-02-181-13/+3
| | | | | * doc/misc/gnus-faq.texi (FAQ 1-2): Delete redundant question. (FAQ 1-1, FAQ 1-3): Adjust accordingly.
* Spell out RPN abbreviation in Calc manual introStefan Kangas2023-02-181-11/+13
| | | | | * doc/misc/calc.texi (What is Calc, Demonstration of Calc) (RPN Tutorial): Spell out "Reverse Polish notation" abbreviation.
* Delete perplexing paragraph from Gnus manualStefan Kangas2023-02-151-9/+0
| | | | | * doc/misc/gnus.texi (Exiting Gnus): Delete a confusing paragraph, that may or may not have been intended as a joke. (Bug#61325)
* ; Prepare to update ERC version to 5.5F. Jason Park2023-02-141-2/+10
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/misc/erc.texi: Mention in various places that ERC is also available from GNU ELPA. * etc/ERC-NEWS: Mention Compat dependency and shorten title for auth-source section. * lisp/erc/erc-backend.el: (erc-server-reconnect-function, erc-tags-format): Update package version to 5.5. (erc--parse-message-tags): Downcase warning "type" to remain consistent with all other ERC warnings. * lisp/erc/erc-button.el: (erc-button-alist): Change package-version to 5.5. * lisp/erc/erc-match.el (erc-match-quote-when-adding): Update package version to 5.5. * lisp/erc/erc-sasl.el: Mention actual info node in Commentary. (erc-sasl): Update package version to 5.5. (erc-sasl-password): Reword doc string. (erc-sasl-auth-source-function): Capitalize "info" in doc string. * lisp/erc/erc-services.el (erc-auth-source-services-function): Update package version to 5.5. Capitalize "info" in doc string. Change choice type from const to function-item. * lisp/erc/erc.el (erc-password): Capitalize "info" in doc string. (erc-inhibit-multiline-input, erc-ask-about-multiline-input, erc-prompt-hidden, erc-hide-prompt, erc-unhide-query-prompt, erc-join-buffer, erc-reconnect-display, erc-kill-server-hook, erc-kill-channel-hook, erc-kill-buffer-hook, erc-url-connect-function): Update package version to 5.5. (erc-auth-source-server-function, erc-auth-source-join-function): Update package version to 5.5. Change choice type from const to function-item. Capitalize "info" in doc string. (erc-tls): Capitalize "info" in doc string.
* Update to Org 9.6.1-31-gaf1bb1Kyle Meyer2023-02-121-8/+8
|
* Update to Transient v0.3.7-204-gecff8c2Jonas Bernoulli2023-02-091-28/+2
|
* Update the Emacs FAQ for Emacs 29Eli Zaretskii2023-02-051-0/+120
| | | | | * doc/misc/efaq.texi (New in Emacs 29, History of Emacs): Add new section about Emacs 29.
* Update to Transient v0.3.7-196-gb91f509Jonas Bernoulli2023-01-301-40/+109
|
* ; Don't mention in the Gnus manual user options that were removedArash Esbati2023-01-251-11/+0
| | | | | * doc/misc/gnus.texi (HTML): Delete entries for custom variables removed in commit 2c8b2fc8d5. (Bug#61054)
* ; * doc/misc/erc.texi: Improve Local Modules section.F. Jason Park2023-01-241-14/+33
|
* Update to Org 9.6.1-16-ge37e9bKyle Meyer2023-01-221-1/+3
|
* Add more detail about how to invoke Eshell commandsJim Porter2023-01-171-36/+100
| | | | | | | | | | * doc/misc/eshell.texi (Variables): Move footnote explaining "REPL" from here... (Top): ... to its first use here. (Commands): Move explanation about kernel functions to here. (Invocation): Describe command form and Lisp form. Fix documentation about priority of commands in command form. (Arguments): Add a cross reference to the Invocation node.
* ; Fix last change: remove unused @anchor.Eli Zaretskii2023-01-151-1/+0
|
* ; Update htmlfontify documentationXi Lu2023-01-151-10/+4
| | | | | | * doc/misc/htmlfontify.texi (Customization): Remove 'hfy-find-cmd', add 'hfy-exclude-file-rules'. (Requirements): Remove text about 'find' program.
View Lorry Controller Status