aboutsummaryrefslogtreecommitdiffstats
path: root/doc (follow)
Commit message (Collapse)AuthorAgeFilesLines
...
* Remove info references to gmane web searchRobert Pluim2019-11-201-77/+15
| | | | | | * doc/misc/gnus.texi (Foreign Groups, Web Searches, What is nnir?): (Setting up nnir, Associating Engines, The imap Engine): (Customizations): Remove references to gmane web search.
* * lisp/dired.el (dired-dwim-target): Add choice dired-dwim-target-next-visibleJuri Linkov2019-11-171-1/+4
| | | | | | | | * lisp/dired-aux.el (dired-dwim-target-next): Add arg ALL-FRAMES. (dired-dwim-target-next-visible): New function. * doc/emacs/dired.texi (Operating on Files): Describe function value of dired-dwim-target. (Bug#35385)
* 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'.
* * lisp/dired.el (dired-dwim-target): Add new choices (bug#35385)Juri Linkov2019-11-121-4/+6
| | | | | | | | | | | | * lisp/dired.el (dired-dwim-target): Add choices dired-dwim-target-next and dired-dwim-target-recent. * lisp/dired-aux.el (dired-dwim-target-next) (dired-dwim-target-recent): New functions. (dired-dwim-target-directories): Call either of them. * doc/emacs/dired.texi (Operating on Files): Mention new preferences in dired-dwim-target.
* Conditionally omit edition numbers, dates in docPaul Eggert2019-11-123-35/+41
| | | | | | | | | | | | | | | | | | | | | | | | 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-102-32/+30
| | | | | | | | | | | | | * 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.
* CC Mode. Allow fontification of "wrong" style comments with warning face.Alan Mackenzie2019-11-091-8/+33
| | | | | | | | | | | | | | | | | | | | | | | | | | This fixes bug #4192. * etc/NEWS: Add a new entry. * lisp/progmodes/cc-defs.el (c-font-lock-flush): New macro. * lisp/progmodes/cc-cmds.el (c-toggle-comment-style): On toggling the comment style, invoke c-font-lock-flush when c-mark-wrong-style-of-comment is non-nil, to cause that marking to be done instead on the other style of comment. * lisp/progmodes/cc-fonts.el (c-maybe-font-lock-wrong-style-comments): New function. (c-cpp-matchers): Call c-maybe-font-lock-wrong-style-comments when appropriate. * lisp/progmodes/cc-vars.el (c-mark-wrong-style-of-comment): New customizable option. * doc/misc/cc-mode.texi (top level, Indentation Commands, Guessing the Style, Custom Macros): For some opening quote marks, correct '' to ``. (Minor Modes): Add an xref to the new page "Wrong Comment Style" in a footnote. (Wrong Comment Style): New page.
* 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)
* Fix MS-Windows version reference in FAQEli Zaretskii2019-11-081-4/+6
| | | | | * doc/misc/efaq-w32.texi (Which versions of Windows): Clarify that we support all recent versions of MS-Windows. (Bug#38023)
* 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)
* Minor fix in the Emacs manualEli Zaretskii2019-11-061-9/+10
| | | | | * doc/emacs/msdos.texi (ls in Lisp): Fix the description of 'ls-lisp-verbosity'. (Bug#38077)
* 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.
* Make 'g' refresh package data in package menuStefan Kangas2019-11-061-4/+5
| | | | | | | | | | | * lisp/emacs-lisp/package.el (package-menu--refresh): Rename from 'package-menu-refresh', make internal and non-interactive. (package-menu-mode-map, package-menu-mode-menu, package-menu-mode) (list-packages): Use the above. (Bug#35504) (package-menu-refresh): Redefine as obsolete fuction alias for 'revert-buffer'. * doc/emacs/package.texi (Package Menu): Document it. * etc/NEWS: Announce it.
* Rename *-multiframe-window to *-window-any-frameStefan Kangas2019-11-061-2/+2
| | | | | | | | | | | | | | Suggested by Drew Adams. * lisp/frame.el (next-multiframe-window): Define as obsolete alias for... (next-window-any-frame): ...new function name. (previous-multiframe-window): Define as obsolete alias for... (previous-window-any-frame): ...new function name. (Bug#12436) * lisp/term/ns-win.el (global-map): Use new command name. * doc/emacs/windows.texi (Other Window): Document it. * etc/NEWS: Announce it.
* Document fido-modeJoão Távora2019-11-051-0/+16
| | | | | | | | | | | * doc/emacs/buffers.texi (Icomplete): Document Fido Mode. * etc/NEWS: Mention Fido Mode. * lisp/icomplete.el (icomplete-mode): Ensure fido-mode is off. (fido-mode): Ensure icomplete-mode is off. (icomplete-magic-ido-ret): Don't force completions if no completions.
* 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.
* Allow flymake diagnostic types to have shorter namesJoão Távora2019-11-021-0/+5
| | | | | | | | | | | | | | | | Eglot, a third-party package which uses Flymake, has its own diagnostic types such as 'eglot-error', 'eglot-warning', etc... While not being too long, they will not fit in the type column of the "list all diagnostics" buffer. This commit allows diagnostic types to have user-defined names and also assigns names to the default categories. * doc/misc/flymake.texi (Flymake error types): Describe flymake-type-name prop. * lisp/progmodes/flymake.el (flymake--diagnostics-buffer-entries): Use type names. (flymake-error, flymake-warning, flymake-note): Give these diagnostic categories default type names.
* Clarify consequences of mismatching Flymake diagnostic buffersJoão Távora2019-11-021-1/+3
| | | | | | | | | | Fix bug#34418. * doc/misc/flymake.texi (Flymake utility functions): Add note to flymake-make-diagnostic. * lisp/progmodes/flymake.el (flymake--handle-report): Discard diagnostics from other buffers.
* 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.
* Document Windows font selection quirksEli Zaretskii2019-11-021-0/+9
| | | | | * doc/emacs/msdos.texi (Windows Fonts): Document 'w32-use-w32-font-dialog' and 'w32-fixed-font-alist'.
* Improve documentation of 'set-face-font'Eli Zaretskii2019-11-022-19/+33
| | | | | | | | | * 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-023-2/+38
| | | | | | This reverts commit 2f42832895942fdeaa0c500511aa19860fa806cd. Editions of Emacs manuals must be coordinated with the FSF publishing staff, as they appear on the printed books.
* * doc/emacs/package.texi (Package Menu): Add index items.Stefan Kangas2019-11-021-1/+31
|
* Omit edition numbers and dates in manualsPaul Eggert2019-11-013-38/+2
| | | | | | | | | | | | | | | | | 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.
* Remove obsolete doc references to XEmacs (Bug#37899)Stefan Kangas2019-10-285-16/+3
| | | | | | | | | | | | | | | | | * doc/misc/edt.texi (Changes, Goals): * doc/misc/emacs-mime.texi (Charset Translation): * doc/misc/gnus-faq.texi (FAQ 4-15): * doc/misc/pcl-cvs.texi (Bugs): * doc/misc/srecode.texi (SRecode Minor Mode): * lisp/cedet/srecode/insert.el (srecode-insert-ask-variable-method): * lisp/follow.el: * lisp/leim/quail/ipa.el (ipa-x-sampa, ipa-kirshenbaum): * lisp/net/newsticker.el: * lisp/obsolete/iswitchb.el: * lisp/progmodes/hideshow.el: * lisp/savehist.el (savehist-file): * lisp/vc/ediff.el: Remove obsolete references to XEmacs in doc strings and comments.
* 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).
* dired-dwim-target uses most recently visited window instead of next window.Juri Linkov2019-10-271-2/+3
| | | | | | | | | | | | | * doc/emacs/dired.texi (Operating on Files): Document behavior change. * lisp/dired-aux.el (dired-dwim-target-directories): New function. (dired-dwim-target-directory, dired-dwim-target-defaults): Use it to get the most recently used window instead of the next window (bug#35385). * lisp/dired.el (dired-dwim-target): Doc fix. * test/lisp/dired-tests.el: Remove unnecessary require and pacify byte-compiler.
* Merge branch 'master' of git.sv.gnu.org:/srv/git/emacsMichael Albinus2019-10-251-3/+9
|\