aboutsummaryrefslogtreecommitdiffstats
path: root/doc/lispref (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Fix a recent change in ELisp manualEli Zaretskii2019-11-211-3/+1
| | | | | * doc/lispref/objects.texi (Special Read Syntax): Fix wording of the last change: don't document #' twice. (Bug#38278)
* Fix up previous #' documentation additionLars Ingebrigtsen2019-11-211-1/+1
| | | | | * doc/lispref/objects.texi (Special Read Syntax): Add an xref for the #' (bug#38278).
* Document the #' syntaxLars Ingebrigtsen2019-11-211-0/+5
| | | | | * doc/lispref/objects.texi (Special Read Syntax): Document the #' syntax (bug#38278).
* Make it clear what edebug-remove-instrumentation offersLars Ingebrigtsen2019-11-161-2/+4
| | | | | * doc/lispref/edebug.texi (Instrumenting): Reword the description of the edebug-remove-instrumentation command.
* Improve indexing of function doc string conventionsEli Zaretskii2019-11-151-1/+2
| | | | | * doc/lispref/functions.texi (Function Documentation): Improve indexing (bug#38158).
* Improve documentation of 'add-variable-watcher'Eli Zaretskii2019-11-151-13/+15
| | | | | | | | * doc/lispref/variables.texi (Watching Variables): Clarify the documentation of 'add-variable-watcher' and fix markup. * src/data.c (Fadd_variable_watcher): Clarify the doc string. (Bug#38205)
* Fix recent documentation changesEli Zaretskii2019-11-142-6/+5
| | | | | | | | * doc/lispref/minibuf.texi (Multiple Queries): Move the reference to 'read-char-from-minibuffer' from here... * doc/lispref/commands.texi (Reading One Event): ...to here. Fix the wording of the description of 'read-char-from-minibuffer'.
* Conditionally omit edition numbers, dates in docPaul Eggert2019-11-121-9/+11
| | | | | | | | | | | | | | | | | | | | | | | | This redoes the 2019-11-02T00:24:02!eggert@cs.ucla.edu patch, updated after consultation with John Sullivan. Omit printed edition numbers in online manuals while keeping them in printed manuals. In online manuals the edition numbers 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 "27.0" in online manuals. For printed manuals people can run, e.g., "texi2any -D 'EDITION Nineteenth'" when generating the 19th printed edition of the Emacs manual. * doc/emacs/emacs.texi (EDITION): * doc/lispintro/emacs-lisp-intro.texi (edition-number, update-date): * doc/lispref/elisp.texi (VERSION, DATE): Remove definitions. Instead, let the person printing the book specify these values, with the default being the online version which does not have printed edition numbers. * doc/lispintro/emacs-lisp-intro.texi (titlepage-edition-number): New flag, for the edition number as it appears on the title page.
* Rename font-log-refontifyLars Ingebrigtsen2019-11-121-2/+2
| | | | | | * lisp/font-lock.el (font-lock-debug-fontify): Rename to make it clearer what the function is for. * doc/lispref/modes.texi (Font Lock Basics): Ditto.
* Document Lisp floats a bit betterPaul Eggert2019-11-101-2/+6
| | | | | | | | | | | | | * doc/lispref/numbers.texi (Float Basics): * doc/misc/cl.texi (Implementation Parameters): * lisp/emacs-lisp/cl-lib.el (cl-most-positive-float) (cl-least-positive-float) (cl-least-positive-normalized-float, cl-float-epsilon) (cl-float-negative-epsilon): Document IEEE floating point better. Don’t suggest that Emacs might use some floating-point format other than IEEE format, as Emacs currently assumes IEEE in several places and there seems little point in removing those assumptions.
* Move read-char-from-minibuffer from simple.el to subr.el and document it.Juri Linkov2019-11-101-0/+12
| | | | | | | | | | | | * doc/lispref/minibuf.texi (Multiple Queries): Document read-char-from-minibuffer (bug#10477, bug#38076). * lisp/subr.el (read-char-history) (read-char-from-minibuffer-map) (read-char-from-minibuffer-map-hash) (read-char-from-minibuffer-insert-char) (read-char-from-minibuffer-insert-other, empty-history) (read-char-from-minibuffer): Move from simple.el to subr.el.
* 'y-or-n-p' now uses the minibuffer to read 'y' or 'n' answer (bug#38076)Juri Linkov2019-11-101-21/+15
| | | | | | | | | | | | * doc/lispref/minibuf.texi (Yes-or-No Queries): Update the fact that y-or-n-p uses the minibuffer. * lisp/subr.el (y-or-n-p-history-variable): New variable. (y-or-n-p-map): New keymap. (y-or-n-p-insert-y, y-or-n-p-insert-n, y-or-n-p-insert-other): New commands. (y-or-n-p): Rewrite to use read-from-minibuffer and make-composed-keymap with y-or-n-p-map and query-replace-map.
* 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).
generated by cgit v1.2.1 (git 2.18.0) at 2026-04-13 04:31:35 +0000