aboutsummaryrefslogtreecommitdiffstats
path: root/doc (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Merge from origin/emacs-28Stefan Kangas2022-01-021-1/+1
|\ | | | | | | | | | | | | efb1c7ec37 ; * admin/notes/years: More known problems. f475c5823a ; Copyright year fixes 2684def348 ; Run set-copyright from admin.el 2558b37b5e ; * admin/notes/years: Mention known problems with 'update...
| * ; Copyright year fixesGlenn Morris2022-01-011-1/+1
| |
* | ; Add 2022 to copyright years.Eli Zaretskii2022-01-011-1/+1
| |
* | Merge from origin/emacs-28Eli Zaretskii2022-01-01197-197/+197
|\ \ | |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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-01197-197/+197
| |
* | Merge from origin/emacs-28Stefan Kangas2022-01-011-1/+4
|\ \ | |/ | | | | | | f2031d0ddb Minor improvement in user documentation of completion style 1e3076e2db Fix bug where bookmark-jump used (point), not (point-at-bol)
| * Minor improvement in user documentation of completion styleEli Zaretskii2021-12-301-1/+4
| | | | | | | | | | * doc/emacs/mini.texi (Completion Styles): Add reference to "Completion Variables" in the ELisp manual. (Bug#52901)
* | Documentation update for Secret ServiceMichael Albinus2021-12-311-14/+15
| | | | | | | | | | | | | | | | * doc/misc/auth.texi (Secret Service API): Precise "session" collection. * lisp/auth-source.el (auth-sources): Adapt custom label. * lisp/net/secrets.el: Adjust comments.
* | Minor improvements of 'lisp-directory' docsEli Zaretskii2021-12-311-25/+33
| | | | | | | | | | | | | | * lisp/startup.el (lisp-directory): * etc/NEWS: * doc/lispref/loading.texi (Library Search): Improve wording of documentation of 'lisp-directory' and related features.
* | Don't store docstrings of preloaded .el files in etc/DOCStefan Monnier2021-12-301-4/+15
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Since the location of those files changes between build time and installation time, this requires to tweak the file name used in those (#$ . NNN) references during the dump so they don't hardcode the build directory. We do it in the same way as was already done for those same file names in `load-history`, except we convert them back to absolute file names more lazily (i.e. when fetching the actual docstring rather than at startup), which requires remembering the `lisp-dir` computed at startup in the new `lisp-directory` variable. * src/Makefile.in ($(etc)/DOC): Don't scan Lisp files any more. * src/lread.c (Fload): Use relative file names for `load-file-name` when preloading for the dump, like we already did for `current-load-list`. (read_list): Don't zero-out dynamic docstring references during the preload since they won't be filled later by Snarf-documentation any more. (read1): Remove the hash-hack for doc references that were zeroed. * lisp/startup.el (lisp-directory): New variable. (command-line): Set it. * src/doc.c (get_doc_string): Use `lisp-directory` for dynamic docstring references using relative file names. (syms_of_doc): Add `Qlisp_directory`. * lib-src/make-docfile.c (scan_file): Don't handle `.el` or `.elc` files any more. (IS_SLASH): Remove macro, not used any more. (skip_white, read_lisp_symbol, search_lisp_doc_at_eol) (scan_lisp_file): Remove functions, not used any more. * doc/lispref/loading.texi (Library Search): Mention `lisp-directory`.
* | Merge from origin/emacs-28Stefan Kangas2021-12-302-8/+21
|\ \ | |/ | | | | | | | | | | | | 06545bc0cc CC Mode: c-update-brace-stack: After struct foo *, do not ... f11779f01b Improve documentation of 'M-X' and related features # Conflicts: # etc/NEWS
| * Improve documentation of 'M-X' and related featuresEli Zaretskii2021-12-292-8/+21
| | | | | | | | | | | | | | | | | | | | * doc/emacs/m-x.texi (M-x): Index 'M-X'. * doc/lispref/commands.texi (Interactive Call, Command Modes): Mention 'M-X' and 'execute-extended-command-for-buffer'. * etc/NEWS: Clarify that the '(declare (completion ...' and '(declare (modes ...' forms have no effect by default. Likewise for '(interactive "..." MODE)' specs. (Bug#52839)
* | Fix documentation of 'define-keymap'Eli Zaretskii2021-12-291-23/+26
| | | | | | | | | | * doc/lispref/keymaps.texi (Creating Keymaps) (Changing Key Bindings): Fix typos, improve wording.
* | Fix recent changes in 'keymap-lookup' documentationEli Zaretskii2021-12-291-4/+5
| | | | | | | | | | * doc/lispref/keymaps.texi (Functions for Key Lookup): Improve wording, correct typos.
* | Document keymap-set-after in Modifying Menus in lisprefLars Ingebrigtsen2021-12-291-5/+5
| | | | | | | | | | * doc/lispref/keymaps.texi (Modifying Menus): Document keymap-set-after (bug#52819).
* | Document `keymap-lookup' in the lipsref manualLars Ingebrigtsen2021-12-291-15/+24
| | | | | | | | | | * doc/lispref/keymaps.texi (Functions for Key Lookup): Document `keymap-lookup' instead of `lookup-key' (bug#52820).
* | Move define-keymap manual entry to Creating KeymapsLars Ingebrigtsen2021-12-291-89/+97
| | | | | | | | | | | | * doc/lispref/keymaps.texi (Creating Keymaps) (Changing Key Bindings): Move `define-keymap'/`defvar-keymap' to the Creating Keymaps node.
* | Merge from origin/emacs-28Stefan Kangas2021-12-291-5/+11
|\ \ | |/ | | | | 06dcd2be5d Improve rectangle-mark-mode documentation regarding mark a...
| * Improve rectangle-mark-mode documentation regarding mark activationSean Whitton2021-12-281-5/+11
| | | | | | | | | | | | | | | | | | | | | | * doc/emacs/killing.texi: Describe how rectangle-mark-mode works when Transient Mark mode is off. Qualify discussion of rectangle-exchange-point-and-mark to say that it cycles the four corners only when the region is active. * lisp/rect.el (rectangle-mark-mode): State that rectangle-mark-mode does not activate the mark when Transient Mark mode is off. Reword sentence about how long the mode lasts to account for when Transient Mark mode is off. (Bug#42663)
* | ; * doc/misc/gnus.texi (Server Commands): Fix typo.Stefan Kangas2021-12-291-1/+1
| |
* | ; * doc/emacs/search.texi (Lax Search): Fix wording.Eli Zaretskii2021-12-281-4/+4
| |
* | Fix EIEIO tests to account for eieio-compat moveStefan Monnier2021-12-272-4/+4
| | | | | | | | | | | | | | | | | | | | | | * test/lisp/emacs-lisp/eieio-tests/eieio-test-methodinvoke.el: * test/lisp/emacs-lisp/eieio-tests/eieio-tests.el: Require `eieio-compat` explicitly. * test/manual/cedet/tests/test.el (a-method, a-generic): * doc/misc/srecode.texi (Compound Dictionary Values): * doc/misc/ede.texi (ede-generic-project): Update sample code to use cl-generic syntax.
* | * doc/emacs/search.texi (Lax Search): Add char-fold-include.Juri Linkov2021-12-271-1/+5
| |
* | The temprary "session" collection might not exist in Secret ServiceMichael Albinus2021-12-271-1/+5
| | | | | | | | | | | | | | | | | | | | | | | | * doc/misc/auth.texi (Secret Service API): * test/lisp/net/secrets-tests.el (secrets--test-delete-all-session-items) (secrets-test02-collections, secrets-test03-items) (secrets-test04-search): The temporary "session" collection might not exist. * lisp/net/secrets.el (secrets-struct-secret-content-type): Remove compatibility hack. (secrets-create-item): Adapt accordingly.
* | read-multiple-choice: Add optional argument show-helpStefan Kangas2021-12-261-1/+5
| | | | | | | | | | | | | | | | * lisp/emacs-lisp/rmc.el (rmc--show-help): Factor out new function from read-multiple-choice. (read-multiple-choice): Add new optional argument show-help. * doc/lispref/commands.texi (Reading One Event): Document above new optional argument.
* | ; * doc/lispref/commands.texi (Misc Events): Fix wording.Eli Zaretskii2021-12-261-4/+7
| |
* | Clarify situations where pinch events can be sent.Po Lu2021-12-261-0/+4
| | | | | | | | | | * doc/lispref/commands.texi (Misc Events): Clarify the conditions under which pinch events will be sent.
* | Document the representation of DX and DY in pinch eventsPo Lu2021-12-261-0/+3
| | | | | | | | | | * doc/lispref/commands.texi (Misc Events): Document the precise meaning of DX and DY in pinch events.
* | Document some missing commands related to text scalingPo Lu2021-12-261-0/+14
| | | | | | | | | | * doc/emacs/display.texi (Text Scale): Document `text-scale-pinch' and `mouse-wheel-text-scale'.
* | ; * doc/lispref/commands.texi (Misc Events): Fix typos and wording.Eli Zaretskii2021-12-261-6/+7
| |
* | Fix some issues with a recent changePo Lu2021-12-261-11/+11
| | | | | | | | | | | | | | | | | | * doc/lispref/commands.texi (Misc Events): Improve documentation on pinch events. * etc/NEWS: Update documentation status for some recent changes and describe pinch events in more detail. * lisp/face-remap.el (text-scale-pinch): Prevent pinch events from being received in too quick succession.
* | Add support for pinch gestures to the XI2 buildPo Lu2021-12-261-0/+21
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/commands.texi (Misc Events): Document new event type `pinch'. * etc/NEWS: Announce new event `pinch'. * etc/PROBLEMS: Document problems with mismatched libXi versions. * lisp/face-remap.el (text-scale--pinch-start-scale): New variable. (text-scale-pinch): New command. * src/keyboard.c (make_lispy_event): Handle PINCH_EVENTs. (syms_of_keyboard): New symbol `pinch'. * src/termhooks.h (enum event_kind): New enum `PINCH_EVENT'. * src/xfns.c (setup_xi_event_mask): Add pinch events to event mask if available. * src/xterm.c (handle_one_xevent): Handle pinch events.
* | Merge from origin/emacs-28Stefan Kangas2021-12-261-1/+6
|\ \ | |/ | | | | | | 89a82182cb Improve documentation of read-multiple-choice 5fccd1e371 Explain why we remove stuff from 'user-full-name'
| * Improve documentation of read-multiple-choiceStefan Kangas2021-12-261-1/+6
| | | | | | | | | | * doc/lispref/commands.texi (Reading One Event): Document optional third argument help-string of read-multiple-choice.
* | Update modus-themes to version 2.0.0Protesilaos Stavrou2021-12-251-346/+251
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/misc/modus-themes.org (Overview): Update the description of the themes. (Enable and load): Reflow text. (Customization Options): Update the code sample with all customization options. (Option for color-coding success state) (Option for red-green color deficiency or deuteranopia): Document the new user option 'modus-themes-deuteranopia'. (Option for mode line presentation, Option for mode line padding): Update documentation about mode line padding. (Option for completion framework aesthetics): Minor rewording. (Option for diff buffer looks): Update section to exclude the discontinued "foreground-only" diff styles. (Option for Org agenda constructs): Expand documentation pertaining to the 'modus-themes-org-agenda' user option. (Option for the headings' overall style, Option for scaled headings): Document how heading scaling is now done directly with the 'modus-themes-headings' user option. (Option for variable-pitch font in headings): Remove section on 'modus-themes-variable-pitch-headings'. Its functionality is merged into 'modus-themes-headings'. (A theme-agnostic hook for theme loading): Add section on how users can add their own "foreground-only" diff styles. (Full support for packages or face groups, Indirectly covered packages): Update list of supported packages. (Note on god-mode.el): Reflow text. (Frequently Asked Questions): Remove invalid characters from heading. (Acknowledgements): Update list of contributors to code, ideas, etc. * etc/themes/modus-themes.el (modus-themes-operandi-colors) (modus-themes-vivendi-colors): Update theme color palettes. (modus-themes-variable-pitch-headings): Make it obsolete. Use 'modus-themes-headings' instead. (modus-themes--headings-choice): Accept float to adjust heading height. (modus-themes-headings, modus-themes-org-agenda): Update doc strings to cover new features. (modus-themes-scale-headings, modus-themes-scale-1, modus-themes-scale-2) (modus-themes-scale-3, modus-themes-scale-4, modus-themes-scale-5) (modus-themes-scale-title, modus-themes-scale-small): Deprecate them. Use 'modus-themes-headings' directly. (modus-themes-org-habit): Remove long-deprecated user option (modus-themes-mode-line): Update doc string about padding the mode line. (modus-themes-mode-line-padding): Deprecate user option. Use 'modus-themes-mode-line' directly. (modus-themes-diffs): Update doc string to omit discontinued "foreground-only" styles. (modus-themes-completions): Remove outdated reference. (modus-themes-intense-hl-line): Delete long-deprecated form. (modus-themes-lang-checkers, modus-themes-hl-line) (modus-themes-paren-match, modus-themes-syntax, modus-themes-links) (modus-themes-region): Update syntax of code sample in doc string. (modus-themes-success-deuteranopia): Deprecate it and alias it as 'modus-themes-deuteranopia'. (modus-themes--variable-pitch, modus-themes--lang-check) (modus-themes--prompt, modus-themes--paren) (modus-themes--syntax-foreground, modus-themes--syntax-extra) (modus-themes--syntax-string, modus-themes--syntax-comment) (modus-themes--heading, modus-themes--agenda-structure) (modus-themes--agenda-date, modus-themes--agenda-event) (modus-themes--agenda-habit, modus-themes--org-block-delim) (modus-themes--mode-line-padding, modus-themes--mode-line-attrs) (modus-themes--diff, modus-themes--diff-deuteran) (modus-themes--success-deuteran, modus-themes--link) (modus-themes--link-color, modus-themes--scale, modus-themes--region) (modus-themes--hl-line): Update private functions to parse the updated user options and to simplify/refine their code. (modus-themes-faces): Remove some faces, add a few others, and generally clean up the code to avoid overusing private functions for the expansion of attributes with user-facing options. (modus-themes-custom-variables): Remove support for 'highlight-tail' variable. * etc/themes/modus-operandi-theme.el: * etc/themes/modus-vivendi-theme.el: Bump file version. The change log entry for this release is available here: <https://protesilaos.com/codelog/2021-12-24-modus-themes-2-0-0/>.
* | * doc/misc/Makefile.in (need_emacsver): Add missing members.Glenn Morris2021-12-231-1/+2
| |
* | Allow window-text-pixel-size to measure pixels around a positionPo Lu2021-12-231-6/+16
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * doc/lispref/display.texi (Size of Displayed Text): Announce new meaning of `from'. * etc/NEWS: Announce changes. * lisp/pixel-scroll.el (pixel-scroll-precision-scroll-up-page): Use new feature. * src/xdisp.c (window_text_pixel_size): Understand a special format of `from' that specifies the amount of pixels above or below a position. (Fwindow_text_pixel_size): Update doc string.
* | ; Fix documentation of a recently-installed changeEli Zaretskii2021-12-231-6/+13
| | | | | | | | | | | | | | | | | | | | * lisp/gnus/message.el (message-server-alist) (message-update-smtp-method-header): Doc string fixes. * doc/misc/message.texi (Sending Variables): Fix wording and markup. * etc/NEWS: Fix the wording of the 'message-server-alist' entry.
* | Allow automatic X-Message-SMTP-Method header insertionPhilip Kaludercic2021-12-231-0/+9
| | | | | | | | | | | | | | | | | | * message.el (message-server-alist): Add user option (message-update-smtp-method-header): Add function (message-send): Call message-update-smtp-method-header * doc/misc/message.texi (Sending Variables): Document message-server-alist * etc/NEWS: Add news entry
* | ; Fix spelling; be consistent with "key binding" (Bug#52674)Stefan Kangas2021-12-2117-53/+52
| |
* | Prefer $(info) to @echoPaul Eggert2021-12-202-6/+6
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Have GNU Make output some diagnostics directly, instead of forking and execing a shell to do it. * GNUmakefile (help): * doc/lispref/two-volume.make (vol2.pdf, elisp2med-init) (elisp2-init): * doc/misc/Makefile.in (echo-info, echo-sources): * lib-src/Makefile.in (archlibdir, install, check): * src/verbose.mk.in (AM_V_AR, AM_V_CC, AM_V_CXX, AM_V_CCLD) (AM_V_CXXLD, AM_V_ELC, AM_V_ELN, AM_V_GEN, AM_V_GLOBALS) (AM_V_RC): * test/Makefile.in (subdirs, subdir-targets): Prefer $(info) to @echo. * GNUmakefile (MAKECMDGOALS, configure, Makefile): Prefer $(warning) to @echo >&2. * src/verbose.mk.in (AM_V_ELN): Output target, like the others.
* | Fix sloppy base64 acceptance of some multibyte charactersMattias Engdegård2021-12-201-3/+2
| | | | | | | | | | | | | | | | | | | | | | | | The base64 encoding functions incorrectly accepted some multibyte characters; stop doing that (bug#52670). * src/fns.c (base64_encode_1): Reject all multibyte characters. * test/src/fns-tests.el (fns-tests-base64-encode-string) (fns-test-base64url-encode-region) (fns-test-base64url-encode-string): Add tests. * doc/lispref/text.texi (Base 64): Rephrase outdated manual text. * etc/NEWS: Add a notice.
* | Merge from origin/emacs-28Stefan Kangas2021-12-201-14/+16
|\ \ | |/ | | | | | | 16ed9fad2c ; * doc/lispref/frames.texi (Child Frames): Improve wording. f11b996a3c Clarify description of two mouse dragging parameters (Bug#...
| * ; * doc/lispref/frames.texi (Child Frames): Improve wording.Eli Zaretskii2021-12-191-14/+16
| |
| * Clarify description of two mouse dragging parameters (Bug#52537)Martin Rudalics2021-12-191-14/+14
| | | | | | | | | | * doc/lispref/frames.texi (Child Frames): Clarify description of 'top-visible' and 'bottom-visible' parameters (Bug#52537).
* | New error symbol 'permission-denied'Eli Zaretskii2021-12-191-0/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | * src/fileio.c (syms_of_fileio) <permission-denied>: Define the symbol and its 'err-conditions' and 'error-message' properties. (get_file_errno_data): Return permission-denied on EACCES. * test/src/filelock-tests.el (filelock-tests-file-locked-p-spoiled) (filelock-tests-unlock-spoiled) (filelock-tests-kill-buffer-spoiled): Adapt the tests to the new error symbol. * doc/lispref/errors.texi (Standard Errors): * etc/NEWS: Document 'permission-denied' error.
* | CC Mode: Remove annoying background fontification. Should fix bug #52298Alan Mackenzie2021-12-191-56/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Partially revert the commits from 2021-10-24 - 2021-10-26, "CC Mode: Fontify "found types" which are recognized after being first scanned". This removes the background fontification which ran off of a 0.1s timer, but leaves the facility of normal fontification causing the fontification throughout the buffer of newly found types. * lisp/progmodes/cc-fonts.el (c-find-types-background) (c-type-finder-timer-func): Remove. * lisp/progmodes/cc-mode.el (c-type-finder-timer, c-inhibit-type-finder) (c-type-finder-pos, c-post-gc-hook): Remove. (c-leave-cc-mode-mode): Remove the manipulations of c-type-finder-timer and c-post-gc-hook. (c-basic-common-init): Remove the manipulations of c-type-finder-pos, c-type-finder-timer, and c-post-gc-hook. * lisp/progmodes/cc-vars.el (c-type-finder-time-slot) (c-type-finder-repeat-time, c-type-finder-chunk-size): Remove. * doc/misc/cc-mode.texi (Found Types): Remove. Amend some menu entries.
* | Add a shr-allowed-images user optionLdBeth2021-12-191-1/+4
| | | | | | | | | | | | | | | | | | * lisp/net/shr.el (shr-allowed-images): New variable (bug#52594). (shr-image-is-blocked): New function to use it. (shr-tag-img): Use it. * doc/misc/eww.texi (Advanced): Document it. Copyright-paperwork-exempt: yes
* | Update from gnulibPaul Eggert2021-12-181-6/+8
| | | | | | | | | | Make the following changes by hand, and run ‘admin/merge-gnulib’. * configure.ac (AM_CONDITIONAL): Adjust to new Gnulib convention.
* | Cleanup append-to-buffer section in ELisp IntroYugaEgo2021-12-181-98/+49
| | | | | | | | | | | | | | | | * doc/lispintro/emacs-lisp-intro.texi (append-to-buffer, Buffer Related Review, fwd-para let): Finalize shifting focus of the 'let*' introduction to the 'append-to-buffer' section. Improve wording, fix typos, remove redundant comments (Bug#8275).