mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-06 03:40:56 -08:00
Code Issues Projects Releases Wiki Activity
139317 commits 243 branches 194 tags 712 MiB
Commit graph

7692 commits

Author SHA1 Message Date
Eli Zaretskii
996e08b05f Document Windows font selection quirks 
* doc/emacs/msdos.texi (Windows Fonts): Document
'w32-use-w32-font-dialog' and 'w32-fixed-font-alist'.
 2019-11-02 12:50:27 +02:00
Eli Zaretskii
cacd58463b Improve documentation of 'set-face-font' 
* 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)
 2019-11-02 12:41:51 +02:00
Eli Zaretskii
5a778d504f Revert "Omit edition numbers and dates in manuals" 
This reverts commit 2f42832895.
Editions of Emacs manuals must be coordinated with the FSF
publishing staff, as they appear on the printed books.
 2019-11-02 09:52:39 +02:00
Stefan Kangas
3b2f11f268 * doc/emacs/package.texi (Package Menu): Add index items. 2019-11-02 03:22:58 +01:00
Paul Eggert
2f42832895 Omit edition numbers and dates in manuals 
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.
 2019-11-01 17:24:47 -07:00
Paul Eggert
9b1c00b3ca Document limits on some time-conversion functions 
* 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).
 2019-11-01 16:13:50 -07:00
Lars Ingebrigtsen
eda98211e3 Fix documentation of set-face-font in the manual 
* doc/lispref/display.texi (Attribute Functions): Describe more
precisely what set-face-font does (bug#14647).
 2019-11-01 18:27:17 +01:00
Lars Ingebrigtsen
fd29402180 Low-Level Font documentation fix 
* doc/lispref/display.texi (Low-Level Font): Mention what the data
types the font attributes are (bug#14634).
 2019-11-01 18:14:17 +01:00
Lars Ingebrigtsen
f301513a46 Don't claim that anonymous face can't be used in font-lock 
* doc/lispref/display.texi (Faces): Anonymous functions can be
used when font locking, so adjust the injunction against them
(bug#35005).
 2019-11-01 14:17:17 +01:00
Richard Stallman
8758c96dc7 Minor wording change in ELisp manual 
* doc/lispref/functions.texi (Advising Named Functions):
Improve and clarify wording of the advice to avoid advising
functions in released code.
 2019-11-01 11:45:51 +02:00
Michael Albinus
2448cebf76 ; Add @cindex in files.texi for "temporary file on a remote host" 
* doc/lispref/files.texi (Unique File Names): Add @cindex for
"temporary file on a remote host".  (Bug#38010)
 2019-11-01 10:36:26 +01:00
Mattias Engdegård
d75794fd5c Inhibit undo-in-region for mouse-drag-region (bug#37700) 
'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.
 2019-10-31 17:41:29 +01:00
Lars Ingebrigtsen
e1409379f7 Add a convenience function to be used when working on font locking 
* doc/lispref/modes.texi (Font Lock Basics): Document it.

* lisp/font-lock.el (font-lock-refontify): New convenience command.
 2019-10-30 13:16:44 +01:00
Lars Ingebrigtsen
6f7e99fb18 Document run-with-timer 
* doc/lispref/os.texi (Timers): Mention run-with-timer (bug#37875).
 2019-10-29 22:22:25 +01:00
Lars Ingebrigtsen
19c98f7620 Default exotic image formats (like .webp) to image-mode 
* 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.
 2019-10-29 21:42:39 +01:00
Eli Zaretskii
0c3e3a82aa ; Fix recent change in docs 
* doc/lispref/minibuf.texi (Minibuffer Commands): Fix wording
and markup.  (Bug#37948)
 2019-10-28 17:52:16 +02:00
Hong Xu
70578e0777 Add doc for goto-history-element 
* doc/lispref/minibuf.texi (Minibuffer Commands): Add
goto-history-element (bug#37948).
* lisp/simple.el (goto-history-element): Clarify NABS.
 2019-10-28 16:20:52 +01:00
Stefan Kangas
c515d4eeb2 Remove obsolete doc references to XEmacs (Bug#37899) 
* 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.
 2019-10-28 15:55:10 +01:00
Mattias Engdegård
cbd439e785 Expand rx definitions inside (not ...) 
* 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).
 2019-10-27 09:54:54 +01:00
Juri Linkov
c6667cc6a9 dired-dwim-target uses most recently visited window instead of next window. 
* 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.
 2019-10-27 02:20:15 +03:00
Michael Albinus
084007a594 Merge branch 'master' of git.sv.gnu.org:/srv/git/emacs 2019-10-25 16:52:14 +02:00
Michael Albinus
4bcf3a5fdc Mention completion styles for Tramp user/host name completion 
* doc/misc/tramp.texi (File name completion): Emacs must have one
of the completion styles `basic', `emacs21', or `emacs22'.
 2019-10-25 16:45:48 +02:00
Juanma Barranquero
57162dbc06 * doc/lispref/display.texi: Document `delay-warning' 2019-10-24 21:16:43 +02:00
Stefan Kangas
b3b74514e9 Update FAQ section on large files (Bug#37818) 
* doc/misc/efaq.texi (Problems with very large files): Extend section
and remove information about ancient versions of Emacs.
 2019-10-24 01:08:30 +02:00
Stefan Kangas
61223a046c Update FAQ section on Emacs security (Bug#37818) 
* doc/misc/efaq.texi (Security risks with Emacs): Remove section on
movemail.  Add section on third-party packages.
 2019-10-24 01:08:20 +02:00
Eli Zaretskii
b1be40c468 Fix recent changes in documentation 
* 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.
 2019-10-22 19:28:58 +03:00
Stefan Kangas
1f1b2e3da6 Various doc fixes for auto-insert-mode 
* doc/misc/autotype.texi (Autoinserting): Various doc fixes.
* lisp/autoinsert.el (top-level): Recommend 'auto-insert-mode' over
'add-hook'.
 2019-10-22 18:06:01 +02:00
Lars Ingebrigtsen
f9519a9c86 Add a fringe example 
* doc/lispref/display.texi (Fringe Bitmaps): Add an example.
 2019-10-22 16:21:11 +02:00
Lars Ingebrigtsen
7f5d92e643 Make edebug-eval-last-sexp interactively take a zero prefix 
* 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.
 2019-10-22 13:12:08 +02:00
Stefan Kangas
b087a5f3e4 Remove XEmacs compat code from speedbar.el 
* lisp/speedbar.el (speedbar-frame-plist, speedbar-frame-mode)
(speedbar-make-overlay, speedbar-overlay-put, speedbar-delete-overlay)
(speedbar-mode-line-update, speedbar-frame-reposition-smartly)
(speedbar-set-mode-line-format, speedbar-reconfigure-keymaps)
(speedbar-add-localized-speedbar-support, speedbar-check-vc)
(speedbar-highlight-one-tag-line)
(speedbar-unhighlight-one-tag-line): Remove XEmacs compat code.

* doc/misc/speedbar.texi (Frames and Faces): Remove documentation for
XEmacs.
 2019-10-22 00:39:25 +02:00
Clément Pit-Claudel
435eb82e7b Add a way to disable substitution of command keys in help strings 
* 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'.
 2019-10-20 21:48:38 -04:00
Lars Ingebrigtsen
78cb3791fa Add a command to toggle an edebug breakpoint 
* 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.
 2019-10-20 23:46:50 +02:00
Mattias Engdegård
c2cd27bceb Add missing rx symbols bow' and eow' to documentation 
* doc/lispref/searching.texi (Rx Constructs):
* lisp/emacs-lisp/rx.el (rx):  Add missing synonyms.
 2019-10-20 20:28:12 +02:00
Stefan Kangas
f22a1008a1 Update FAQ entry on XEmacs (Bug#37815) 
* doc/misc/efaq.texi (Difference between Emacs and XEmacs): Update
section to reflect the current state of affairs.  XEmacs is not
actively developed and is lacking many important features of Emacs.
 2019-10-20 15:18:07 +02:00
Juanma Barranquero
f480484cae * doc/lispref/display.texi (Low-Level Font): Describe max-width. 2019-10-20 14:54:52 +02:00
Lars Ingebrigtsen
34744278ba Add a new edebug-breakpoint face 
* doc/lispref/edebug.texi (Breakpoints): Mention it.

* lisp/emacs-lisp/edebug.el (edebug-breakpoint): New face.
 2019-10-20 14:09:36 +02:00
Lars Ingebrigtsen
db1907233c while-no-input-ignore-events manual clarification 
* doc/lispref/commands.texi (Event Input Misc): Be slightly
clearer about what while-no-input-ignore-events is.
 2019-10-20 13:52:03 +02:00
Lars Ingebrigtsen
23b3032702 New command to clear all breakpoints in a function 
* doc/lispref/edebug.texi (Breakpoints): Mention it.

* lisp/emacs-lisp/edebug.el (edebug-unset-breakpoints): New
command and keystroke.
 2019-10-20 13:40:03 +02:00
Juanma Barranquero
41ba8231ef lisp/*.el: Fix typos and improve some docstrings 
* 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.
 2019-10-20 12:12:27 +02:00
Lars Ingebrigtsen
e2acf4d29d New command edebug-remove-instrumentation 
* doc/lispref/edebug.texi (Instrumenting): Document it.

* lisp/emacs-lisp/edebug.el (edebug-remove-instrumentation): New
command (bug#15843).
 2019-10-20 11:29:34 +02:00
Juri Linkov
58d23f5f19 Use 'C-x t' for tab-prefix-map instead of 'C-x 6' still used by 2C-mode-map. 
* 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'.
 2019-10-20 01:06:38 +03:00
Eli Zaretskii
2385dddb33 Fix a recent change in Emacs FAQ 
* doc/misc/efaq.texi (New in Emacs 23, Common requests):
Remove references to the removed section "Highlighting a
region".
 2019-10-19 18:05:44 +03:00
Michael Albinus
5ea28ea4d1 * doc/emacs/emacs.texi (Intro): Mention remote file editing. 2019-10-19 15:25:45 +02:00
Stefan Kangas
981c309325 Don't explain FTP acronym in FAQ 
* doc/misc/efaq.texi (Common acronyms): Remove explanation of the FTP
acronym.  Emacs is no longer distributed over FTP, and the FAQ doesn't
refer to any other FTP URLs.
 2019-10-19 15:06:13 +02:00
Stefan Kangas
11c3ec3df6 Remove FAQ section "Highlighting a region" (Bug#37818) 
* doc/misc/efaq.texi (Highlighting a region): Remove section.
 2019-10-19 14:32:11 +02:00
Michael Albinus
7c58cca134 Support old Samba versions in Tramp 
* doc/misc/tramp.texi (Relevant connection properties to override):
New subsection.

* lisp/net/tramp-smb.el (tramp-smb-get-cifs-capabilities): Check "posix"
connection property.

* lisp/net/tramp.el (with-tramp-progress-reporter): Fix docstring.
 2019-10-18 19:44:49 +02:00
Mattias Engdegård
ae5407b857 Add `unmatchable' as alias for (or) in rx (bug#37659) 
* 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'.
 2019-10-18 14:46:06 +02:00
Mattias Engdegård
e5a446b0a7 Add anychar' as alias to anything' in rx (bug#37659) 
* 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.
 2019-10-18 14:45:47 +02:00
Stefan Kangas
4531d2bc63 Remove obsolete XEmacs references from manuals 
* doc/misc/erc.texi:
* doc/misc/eshell.texi:
* doc/misc/htmlfontify.texi:
* doc/misc/remember.texi:
* doc/misc/sieve.texi:
* doc/misc/viper.texi: Remove obsolete XEmacs references.
 2019-10-17 13:56:42 +02:00
Stefan Kangas
3cf92da6fa Improve documentation of shell-command-prompt-show-cwd 
* doc/emacs/misc.texi (Single Shell):
* lisp/simple.el (shell-command): Document
'shell-command-prompt-show-cwd'.  (Bug#4987)
 2019-10-17 12:55:25 +02:00