aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref (follow)
Commit message (Collapse)AuthorAgeFilesLines
...
* Fix last changeEli Zaretskii2019-11-091-1/+3
| | | | | | | | | * lisp/simple.el (goto-history-element) (next-history-element): Fix quoting of "future history". * doc/lispref/minibuf.texi (Minibuffer Commands) (Text from Minibuffer): Add index entry and cross-reference for "future history". (Bug#38026)
* Mention future history in history-related minibuffer commandsHong Xu2019-11-091-2/+5
| | | | | | | | | * lisp/simple.el (goto-history-element): * doc/lispref/minibuf.texi (Minibuffer Commands): Explain negative NABS. * lisp/simple.el (next-history-element): * doc/lispref/minibuf.texi (Minibuffer Commands): Mention "future history." (Bug#38026)
* Minor copyedits in ELisp manualEli Zaretskii2019-11-081-3/+2
| | | | | * doc/lispref/lists.texi (Sets And Lists): Minor rewording of the "Common Lisp note". (Bug#37811)
* Avoid changing value of defcustom package-enable-at-startupStefan Kangas2019-11-061-4/+1
| | | | | | | | | | | | | | * lisp/emacs-lisp/package.el (package--activated): New variable to avoid changing value of defcustom 'package-enable-at-startup'. (package-initialize): Don't set 'package-enable-at-startup'. (package-initialize, package-activate-all): Set 'package--activated' instead of 'package-enable-at-startup'. (package--initialized): Add doc string. * lisp/startup.el (command-line): Check if 'package--activated' is non-nil before activating packages. * doc/lispref/package.texi (Packaging Basics): Update docs.
* Always check for client-certificatesRobert Pluim2019-11-051-2/+6
| | | | | | | | | | | | | | | * lisp/net/network-stream.el (network-stream-use-client-certificates): New user option. (open-network-stream): If 'network-stream-use-client-certificates' is t, and the user hasn't specified :client-certificate, do certificate lookups via 'auth-source'. (network-stream-certificate): Only return key and certificate files that exist. * doc/lispref/processes.texi (Network): Document new client-certificate behavior. * etc/NEWS: Document 'network-stream-use-client-certificates'.
* Overflow errors are range errorsPaul Eggert2019-11-041-4/+4
| | | | | | | | | | | * etc/NEWS: Mention this. * doc/lispref/errors.texi (Standard Errors): Document overflow-error, which was formerly undocumented. It is a range error, not a domain error. * src/data.c (syms_of_data): overflow-error and (undocumented) underflow-error are subtypes range-error, not domain-error. This fixes bugs in timezone-time-from-absolute and in erc-ctcp-reply-PING.
* Improve time documentation a bit morePaul Eggert2019-11-031-15/+18
| | | | | * doc/lispref/os.texi (Time of Day, Time Conversion) (Time Parsing, Time Calculations): Improve doc.
* Fix doc of font-lock-syntactic-face-functionLars Ingebrigtsen2019-11-031-3/+13
| | | | | * doc/lispref/modes.texi (Syntactic Font Lock): Don't refer to no-longer-existing OTHER-VARS (bug#17730) and include an example.
* Further fixup of the previous doc fix in the Faces nodeLars Ingebrigtsen2019-11-021-4/+3
| | | | | * doc/lispref/display.texi (Faces): Improve wording from previous change.
* Improve documentation of 'set-face-font'Eli Zaretskii2019-11-021-14/+19
| | | | | | | | | * lisp/faces.el (set-face-font): * doc/emacs/frames.texi (Fonts): * doc/lispref/display.texi (Face Attributes) (Attribute Functions): Clarify and correct the documentation of set-face-font and related descriptions of font specifications. (Bug#14647)
* Revert "Omit edition numbers and dates in manuals"Eli Zaretskii2019-11-021-1/+12
| | | | | | This reverts commit 2f42832895942fdeaa0c500511aa19860fa806cd. Editions of Emacs manuals must be coordinated with the FSF publishing staff, as they appear on the printed books.
* Omit edition numbers and dates in manualsPaul Eggert2019-11-011-12/+1
| | | | | | | | | | | | | | | | | These seem to cause more confusion than they cure; e.g., https://shop.fsf.org/books/gnu-emacs-manual-18th-edition-v-261 currently advertises "18th edition" even as it points to https://www.gnu.org/software/emacs/manual/pdf/emacs.pdf which says "Seventeenth Edition". It is simpler and less confusing to stick to one version number like "26.3". If we need a separate edition number for each printed manual for some reason (marketing?) we can put “@ifset printed-edition” around anything specific to the printed editions. (as opposed to online PDF copies). * doc/emacs/emacs.texi (EDITION): * doc/lispintro/emacs-lisp-intro.texi (edition-number, update-date): * doc/lispref/elisp.texi (VERSION, DATE): Remove, and remove uses.
* Document limits on some time-conversion functionsPaul Eggert2019-11-011-10/+22
| | | | | | | * doc/lispref/os.texi (Time of Day, Time Zone Rules) (Time Conversion, Time Parsing, Time Calculations): Document functions that limit the range of time values due to OS limits (Bug#37974).
* Fix documentation of set-face-font in the manualLars Ingebrigtsen2019-11-011-1/+5
| | | | | * doc/lispref/display.texi (Attribute Functions): Describe more precisely what set-face-font does (bug#14647).
* Low-Level Font documentation fixLars Ingebrigtsen2019-11-011-1/+4
| | | | | * doc/lispref/display.texi (Low-Level Font): Mention what the data types the font attributes are (bug#14634).
* Don't claim that anonymous face can't be used in font-lockLars Ingebrigtsen2019-11-011-5/+4
| | | | | | * doc/lispref/display.texi (Faces): Anonymous functions can be used when font locking, so adjust the injunction against them (bug#35005).
* Minor wording change in ELisp manualRichard Stallman2019-11-011-3/+9
| | | | | | * doc/lispref/functions.texi (Advising Named Functions): Improve and clarify wording of the advice to avoid advising functions in released code.
* ; Add @cindex in files.texi for "temporary file on a remote host"Michael Albinus2019-11-011-0/+1
| | | | | * doc/lispref/files.texi (Unique File Names): Add @cindex for "temporary file on a remote host". (Bug#38010)
* Inhibit undo-in-region for mouse-drag-region (bug#37700)Mattias Engdegård2019-10-312-0/+11
| | | | | | | | | | | | | | 'mouse-drag-region' leaves the region active around the dragged text, so a straight undo did not revert the entire operation. To remedy this, inhibit undo-in-region when the last command was mouse-drag-region. (Method suggested by Stefan Monnier.) * lisp/mouse.el (undo-drag-region): Set the undo-inhibit-region property. * lisp/simple.el (undo): Inhibit undo-in-region if the last command had the undo-inhibit-region property set. * doc/lispref/symbols.texi (Standard Properties): * doc/lispref/text.texi (Undo): Document undo-inhibit-region. * etc/NEWS: Announce the property.
* Add a convenience function to be used when working on font lockingLars Ingebrigtsen2019-10-301-0/+6
| | | | | | * doc/lispref/modes.texi (Font Lock Basics): Document it. * lisp/font-lock.el (font-lock-refontify): New convenience command.
* Document run-with-timerLars Ingebrigtsen2019-10-291-0/+7
| | | | * doc/lispref/os.texi (Timers): Mention run-with-timer (bug#37875).
* Default exotic image formats (like .webp) to image-modeLars Ingebrigtsen2019-10-291-0/+3
| | | | | | | | | | | | | | | | | | * doc/lispref/errors.texi (Standard Errors): Mention the new error. * lisp/files.el (auto-mode-alist): Add a bunch of image suffixes to the list (bug#37972) based on the output from "gm convert -list format" (i.e., graphicsmagick). * lisp/image-mode.el (image-mode): Rewrite to possibly notify the user about image-use-external-converter. (image-mode--setup-mode): Factor out into own function and don't run under `condition-case' as there's nothing here that should error. * lisp/image.el (unknown-image-type): New error. (image-type): Signal that error so that image-mode can offer sensible feedback to the user.
* ; Fix recent change in docsEli Zaretskii2019-10-281-4/+4
| | | | | * doc/lispref/minibuf.texi (Minibuffer Commands): Fix wording and markup. (Bug#37948)
* Add doc for goto-history-elementHong Xu2019-10-281-0/+6
| | | | | | * doc/lispref/minibuf.texi (Minibuffer Commands): Add goto-history-element (bug#37948). * lisp/simple.el (goto-history-element): Clarify NABS.
* Expand rx definitions inside (not ...)Mattias Engdegård2019-10-271-2/+2
| | | | | | | | | * lisp/emacs-lisp/rx.el (rx--translate-not): * test/lisp/emacs-lisp/rx-tests.el (rx-not, rx-def-in-not): * doc/lispref/searching.texi (Rx Constructs, Extending Rx): Allow user-defined rx constructs to be expanded inside (not ...) forms, for better composability (bug#37849).
* * doc/lispref/display.texi: Document `delay-warning'Juanma Barranquero2019-10-241-3/+9
|
* Fix recent changes in documentationEli Zaretskii2019-10-221-4/+4
| | | | | | | | * doc/lispref/edebug.texi (Edebug Eval, Eval List): Reword recently added text to follow conventions. * src/textprop.c (Ftext_properties_at): Don't use passive tense in doc string.
* Add a fringe exampleLars Ingebrigtsen2019-10-221-0/+11
| | | | * doc/lispref/display.texi (Fringe Bitmaps): Add an example.
* Make edebug-eval-last-sexp interactively take a zero prefixLars Ingebrigtsen2019-10-221-3/+7
| | | | | | * lisp/emacs-lisp/edebug.el (edebug-eval-last-sexp): Make the zero prefix work analogously to in eval-last-sexp (bug#28895). (edebug-eval-print-last-sexp): Ditto.
* Add a way to disable substitution of command keys in help stringsClément Pit-Claudel2019-10-201-2/+13
| | | | | | | | | * src/keyboard.c (help_echo_substitute_command_keys): New function. (help_echo_echo, parse_menu_item): Use it. (syms_of_keyboard): Define Qhelp_echo_inhibit_substitution. * doc/lispref/text.texi (Special Properties), etc/NEWS: Document the effect of 'help-echo-inhibit-substitution'.
* Add a command to toggle an edebug breakpointLars Ingebrigtsen2019-10-201-2/+8
| | | | | | | | | | * doc/lispref/edebug.texi (Breakpoints): Document this. * lisp/emacs-lisp/edebug.el (edebug-disabled-breakpoint): New face (bug#23472). (edebug-enabled-breakpoint): Rename. (edebug--overlay-breakpoints): Use the new face. (edebug-toggle-disable-breakpoint): New command and keystroke.
* Add missing rx symbols `bow' and `eow' to documentationMattias Engdegård2019-10-201-2/+4
| | | | | * doc/lispref/searching.texi (Rx Constructs): * lisp/emacs-lisp/rx.el (rx): Add missing synonyms.
* * doc/lispref/display.texi (Low-Level Font): Describe max-width.Juanma Barranquero2019-10-201-0/+3
|
* Add a new edebug-breakpoint faceLars Ingebrigtsen2019-10-201-1/+2
| | | | | | * doc/lispref/edebug.texi (Breakpoints): Mention it. * lisp/emacs-lisp/edebug.el (edebug-breakpoint): New face.
* while-no-input-ignore-events manual clarificationLars Ingebrigtsen2019-10-201-1/+1
| | | | | * doc/lispref/commands.texi (Event Input Misc): Be slightly clearer about what while-no-input-ignore-events is.
* New command to clear all breakpoints in a functionLars Ingebrigtsen2019-10-201-0/+4
| | | | | | | * doc/lispref/edebug.texi (Breakpoints): Mention it. * lisp/emacs-lisp/edebug.el (edebug-unset-breakpoints): New command and keystroke.
* lisp/*.el: Fix typos and improve some docstringsJuanma Barranquero2019-10-201-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | * lisp/auth-source.el (auth-source-backend-parse-parameters) (auth-source-search-collection) (auth-source-secrets-listify-pattern) (auth-source--decode-octal-string, auth-source-plstore-search): * lisp/registry.el (registry-lookup) (registry-lookup-breaks-before-lexbind) (registry-lookup-secondary, registry-lookup-secondary-value) (registry-search, registry-delete, registry-size, registry-full) (registry-insert, registry-reindex, registry-prune) (registry-collect-prune-candidates): * lisp/subr.el (nbutlast, process-live-p): * lisp/tab-bar.el (tab-bar-list): * lisp/cedet/ede/linux.el (ede-linux--get-archs) (ede-linux--include-path, ede-linux-load): * lisp/erc/erc-log.el (erc-log-all-but-server-buffers): * lisp/erc/erc-pcomplete.el (pcomplete-erc-commands) (pcomplete-erc-ops, pcomplete-erc-not-ops, pcomplete-erc-nicks) (pcomplete-erc-all-nicks, pcomplete-erc-channels) (pcomplete-erc-command-name, pcomplete-erc-parse-arguments): * lisp/eshell/em-term.el (eshell-visual-command-p): * lisp/gnus/gnus-cache.el (gnus-cache-fully-p): * lisp/gnus/nnmail.el (nnmail-get-active) (nnmail-fancy-expiry-target): * lisp/mail/mail-utils.el (mail-string-delete): * lisp/mail/supercite.el (sc-hdr, sc-valid-index-p): * lisp/net/ange-ftp.el (ange-ftp-use-smart-gateway-p): * lisp/net/nsm.el (nsm-save-fingerprint-maybe) (nsm-network-same-subnet, nsm-should-check): * lisp/net/rcirc.el (rcirc-looking-at-input): * lisp/net/tramp-cache.el (tramp-get-hash-table): * lisp/net/tramp-compat.el (tramp-compat-process-running-p): * lisp/net/tramp-smb.el (tramp-smb-get-share) (tramp-smb-get-localname, tramp-smb-read-file-entry) (tramp-smb-get-cifs-capabilities, tramp-smb-get-stat-capability): * lisp/net/zeroconf.el (zeroconf-list-service-names) (zeroconf-list-service-types, zeroconf-list-services) (zeroconf-get-host, zeroconf-get-domain) (zeroconf-get-host-domain): * lisp/nxml/rng-xsd.el (rng-xsd-compile) (rng-xsd-make-date-time-regexp, rng-xsd-convert-date-time): * lisp/obsolete/erc-hecomplete.el (erc-hecomplete) (erc-command-list, erc-complete-at-prompt): * lisp/org/ob-scheme.el (org-babel-scheme-get-buffer-impl): * lisp/org/ob-shell.el (org-babel--variable-assignments:sh-generic) (org-babel--variable-assignments:bash_array) (org-babel--variable-assignments:bash_assoc) (org-babel--variable-assignments:bash): * lisp/org/org-clock.el (org-day-of-week): * lisp/progmodes/cperl-mode.el (cperl-char-ends-sub-keyword-p): * lisp/progmodes/gud.el (gud-find-c-expr, gud-innermost-expr) (gud-prev-expr, gud-next-expr): * lisp/textmodes/table.el (table--at-cell-p, table--probe-cell) (table--get-cell-justify-property) (table--get-cell-valign-property) (table--put-cell-justify-property) (table--put-cell-valign-property): Fix typos. * lisp/so-long.el (fboundp): Doc fix. (so-long-mode-line-info, so-long-mode) (so-long--check-header-modes): Fix typos. * lisp/emulation/viper-mous.el (viper-surrounding-word) (viper-mouse-click-get-word): Fix typos. (viper-mouse-click-search-word): Doc fix. * lisp/erc/erc-backend.el (erc-forward-word, erc-word-at-arg-p) (erc-bounds-of-word-at-point): Fix typos. (erc-decode-string-from-target, define-erc-response-handler): Refill docstring. * lisp/erc/erc-dcc.el (pcomplete/erc-mode/DCC): Fix typo. (erc-dcc-get-host, erc-dcc-auto-mask-p, erc-dcc-get-file): Doc fixes. * lisp/erc/erc-networks.el (erc-network-name): Fix typo. (erc-determine-network): Refill docstring. * lisp/net/dbus.el (dbus-list-hash-table) (dbus-string-to-byte-array, dbus-byte-array-to-string) (dbus-check-event): Fix typos. (dbus-introspect-get-property): Doc fix. * lisp/net/tramp-adb.el (tramp-adb-file-name-handler): Rename ARGS to ARGUMENTS. Doc fix. (tramp-adb-sh-fix-ls-output, tramp-adb-execute-adb-command) (tramp-adb-find-test-command): Fix typos. * lisp/net/tramp.el (tramp-set-completion-function) (tramp-get-completion-function) (tramp-completion-dissect-file-name) (tramp-completion-dissect-file-name1) (tramp-get-completion-methods, tramp-get-completion-user-host) (tramp-get-inode, tramp-get-device, tramp-mode-string-to-int) (tramp-call-process, tramp-call-process-region) (tramp-process-lines): Fix typos. (tramp-interrupt-process): Doc fix. * lisp/org/ob-core.el (org-babel-named-src-block-regexp-for-name) (org-babel-named-data-regexp-for-name): Doc fix. (org-babel-src-block-names, org-babel-result-names): Fix typos. * lisp/progmodes/inf-lisp.el (lisp-input-filter): Doc fix. (lisp-fn-called-at-pt): Fix typo. * lisp/progmodes/xref.el (xref-backend-identifier-at-point): Doc fix. (xref-backend-identifier-completion-table): Fix typo.
* New command edebug-remove-instrumentationLars Ingebrigtsen2019-10-201-0/+4
| | | | | | | * doc/lispref/edebug.texi (Instrumenting): Document it. * lisp/emacs-lisp/edebug.el (edebug-remove-instrumentation): New command (bug#15843).
* Use 'C-x t' for tab-prefix-map instead of 'C-x 6' still used by 2C-mode-map.Juri Linkov2019-10-202-6/+17
| | | | | | | | | | | | | | | | | | | | | | | | | * doc/emacs/commands.texi (Keys): Add 'C-x t'. * doc/emacs/frames.texi (Tab Bars): Replace 'C-x 6' with 'C-x t'. * doc/lispref/keymaps.texi (Prefix Keys): Add 'C-x t' (tab-prefix-map). * doc/lispref/maps.texi (Standard Keymaps): Add tab-prefix-map, tab-bar-map. * lisp/dired.el: Rebind 'C-x 6 d' to 'C-x t d'. Use tab-prefix-map. * lisp/subr.el (ctl-x-6-map, ctl-x-6-prefix, ctl-x-t-prefix): Remove. (tab-prefix-map): New keymap bound to 'C-x t'. * lisp/tab-bar.el: Use tab-prefix-map instead of ctl-x-6-map. * lisp/textmodes/two-column.el: Restore autoload global setting of "\C-x6" to 2C-command. * lisp/ldefs-boot.el: Update to add setting "\C-x6" to 2C-command. * doc/emacs/commands.texi (Keys): * doc/emacs/text.texi (Two-Column): * doc/lispref/keymaps.texi (Prefix Keys): * doc/lispref/maps.texi (Standard Keymaps): Restore 'C-x 6' bound to '2C-mode-map'.
* Add `unmatchable' as alias for (or) in rx (bug#37659)Mattias Engdegård2019-10-181-0/+6
| | | | | | | | | * lisp/emacs-lisp/rx.el (rx--translate-symbol, rx--builtin-symbols, rx): * test/lisp/emacs-lisp/rx-tests.el (rx-atoms): * doc/lispref/searching.texi (Rx Constructs): * etc/NEWS: Add `unmatchable', more descriptive than (or), and corresponding to the variable `regexp-unmatchable'.
* Add `anychar' as alias to `anything' in rx (bug#37659)Mattias Engdegård2019-10-181-1/+2
| | | | | | | | | * lisp/emacs-lisp/rx.el (rx--translate-symbol, rx--builtin-symbols, rx): * test/lisp/emacs-lisp/rx-tests.el (rx-atoms): * doc/lispref/searching.texi (Rx Constructs): * etc/NEWS: Add `anychar', an alias for `anything'. Since `anychar' is more descriptive (and slightly shorter), treat it as the preferred name.
* lisp/*.el, src/*.c: Doc fixes related to returning t vs non-nilJuanma Barranquero2019-10-171-2/+2
| | | | | | | | | | | | | | | | | | | | | | | | * lisp/progmodes/flymake-proc.el (flymake-proc--find-buffer-for-file): Doc fix; return value is a buffer, not t. * lisp/progmodes/ebrowse.el (ebrowse-member-display-p): Doc fix; return value is the MEMBER argument, not nil. * lisp/files.el (hack-one-local-variable-eval-safep): * lisp/play/doctor.el (doctor-nounp, doctor-pronounp): * lisp/progmodes/flymake-proc.el (flymake-proc--check-include): * lisp/progmodes/js.el (js--broken-arrow-terminates-line-p): Doc fix; a non-nil return value is not always t. * lisp/image.el (image-type-available-p): * lisp/simple.el (region-active-p): * lisp/window.el (frame-root-window-p): * src/buffer.c (Fbuffer_live_p): * src/image.c (Finit_image_library): * src/window.c (Fwindow_minibuffer_p): Doc fix; a non-nil return value is always t. * doc/lispref/minibuf.texi (Minibuffer Windows): Doc fix.
* Fix duplicated words in lisprefRobert Pluim2019-10-152-2/+2
| | | | | | * doc/lispref/text.texi (Base 64): * doc/lispref/internals.texi (Window Internals): Remove duplicated words.
* Add new macro `benchmark-progn'Lars Ingebrigtsen2019-10-151-3/+3
| | | | | | * doc/lispref/debugging.texi (Profiling): Mention it. * lisp/emacs-lisp/benchmark.el (benchmark-progn): New macro.
* ; Minor copyedits of recent documentation changesEli Zaretskii2019-10-141-8/+10
| | | | | | * etc/NEWS: * doc/lispref/display.texi (Face Attributes): Fix documentation of the ':extend' face attribute.
* Document new :extend face attribute in manuals.Jimmy Aguilar Mena2019-10-141-0/+22
| | | | Some stylistic corrections in src/xdisp.c and src/xfaces.c.
* Enable tab-bar-mode from X resourcesJuri Linkov2019-10-131-2/+2
| | | | | | | | | * lisp/startup.el (x-apply-session-resources): Enable tab-bar-mode when X resource "tabBar" class "TabBar" is "on", "yes" or "1". * doc/man/emacs.1.in: * doc/emacs/xresources.texi (Table of Resources): Document X resource "tabBar" (class "TabBar").
* Fix with-coding-priority markup in Elisp manualBasil L. Contovounesios2019-10-131-5/+5
| | | | | | | * doc/lispref/nonascii.texi (Specifying Coding Systems): Don't use '&rest' in conjunction with 'body...' in arglist of with-coding-priority. Fix typo and cross-referencing (2-arg @pxref adds a trailing period).
* ; Minor copyedits in a recent ELisp manual change.Eli Zaretskii2019-10-131-3/+4
| | | | | | * doc/lispref/tips.texi (Coding Conventions): Make the guideline against '-p' in variable names less mandatory and more constructive.
* ; Fix recent additions to ELisp manualEli Zaretskii2019-10-131-11/+17
| | | | | * doc/lispref/files.texi (Contents of Directories): Fix recently added documentation of 'locate-dominating-file'.