1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-16 16:20:40 -08:00
Commit graph

4484 commits

Author SHA1 Message Date
Jimmy Aguilar Mena
424e6f54e5 Document new :extend face attribute in manuals.
Some stylistic corrections in src/xdisp.c and src/xfaces.c.
2019-10-14 14:18:42 +02:00
Juri Linkov
097a03d2a3 Enable tab-bar-mode from X resources
* 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").
2019-10-13 23:56:17 +03:00
Basil L. Contovounesios
fc759eb9b3 Fix with-coding-priority markup in Elisp manual
* 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).
2019-10-13 16:40:23 +01:00
Eli Zaretskii
f113ae5922 ; Minor copyedits in a recent ELisp manual change.
* doc/lispref/tips.texi (Coding Conventions): Make the
guideline against '-p' in variable names less mandatory and
more constructive.
2019-10-13 10:59:18 +03:00
Eli Zaretskii
0fcd6e320d ; Fix recent additions to ELisp manual
* doc/lispref/files.texi (Contents of Directories): Fix
recently added documentation of 'locate-dominating-file'.
2019-10-13 10:50:30 +03:00
Lars Ingebrigtsen
297f333a13 Document let-alist
* doc/lispref/lists.texi (Association Lists): Document let-alist
(bug#34842).
2019-10-13 01:29:32 +02:00
Lars Ingebrigtsen
5fffed6e88 Document locate-dominating-file
* doc/lispref/files.texi (Contents of Directories): Document
locate-dominating-file (bug#33869).
2019-10-13 00:22:37 +02:00
Lars Ingebrigtsen
6c677a101d Mention the Emacs exit code in batch mode
* doc/lispref/os.texi (Batch Mode): Mention what the exit code is
if an error is signalled (bug#31552).
2019-10-12 23:15:43 +02:00
Kaushal Modi
6bc938712f Document that variables should not be called -p
* doc/lispref/tips.texi (Coding Conventions): Document that
variables should now be called -p (bug#26564).
2019-10-12 22:26:50 +02:00
Eli Zaretskii
cb24f4a145 ; Remove unneeded @samp from a @table
* doc/lispref/objects.texi (Special Read Syntax): Remove @samp
from @item's.
2019-10-12 22:23:56 +03:00
Eli Zaretskii
e0a2dae0db Merge branch 'master' of git.savannah.gnu.org:/srv/git/emacs 2019-10-12 22:22:37 +03:00
Eli Zaretskii
2d3bb2250c Fix recent changes in ELisp manual
* doc/lispref/objects.texi (Special Read Syntax): Use @samp in
@table.

* doc/lispref/elisp.texi (Top): Update the detailed menu due
to a recent addition.
2019-10-12 22:18:34 +03:00
Lars Ingebrigtsen
0ba0af06e2 Document #$ in the overview
* doc/lispref/objects.texi (Special Read Syntax): Add #$.
2019-10-12 21:14:42 +02:00
Lars Ingebrigtsen
193ece8d32 Add a lispref node to list special read syntax forms
* doc/lispref/objects.texi (Special Read Syntax): Add a node to
list all the special read syntax forms (bug#18957).
2019-10-12 20:57:43 +02:00
Lars Ingebrigtsen
adb9dc4bff Document :match-inline widget elements
* doc/lispref/customize.texi (Type Keywords): Document
:match-inline (bug#8716).
(Splicing into Lists): Mention :match-inline.
2019-10-12 06:40:49 +02:00
Lars Ingebrigtsen
f9d8babe6a Document REAL-BINDING more extensively in Extended Menu Items
* doc/lispref/keymaps.texi (Extended Menu Items): Document that
REAL-BINDING can be other things than a real command (bug#7755).
2019-10-11 22:28:27 +02:00
Lars Ingebrigtsen
85b3d56276 New variable amalgamating-undo-limit
* doc/lispref/text.texi (Undo): Document it.

* lisp/simple.el (amalgamating-undo-limit): New variable (bug#31658).
2019-10-11 09:24:30 +02:00
Robert Pluim
49614ec800 Correct .dir-locals-2.el description
* doc/lispref/variables.texi (Directory Local Variables): Correct
description of .dir-locals-2.el functioning.  (Bug#37640)
2019-10-11 09:19:59 +02:00
Lars Ingebrigtsen
df713b9344 Ensure that setq-local take an even number of symbol/value pairs
* doc/lispref/variables.texi (Creating Buffer-Local): Document the
new syntax for setq-local.

* lisp/subr.el (setq-local): Ensure that there's an even number of
variable/value pairs, and expand the doc string by taking some
text from `setq'.
2019-10-11 08:27:50 +02:00
Juanma Barranquero
b3314ac5c4 identity, ignore: Make arg names more consistent with docs
* lisp/subr.el (ignore): Rename argument IGNORE to ARGUMENTS.

* src/fns.c (Fidentity): Rename ARG to ARGUMENT.

* doc/lispref/functions.texi (Calling Functions): Fix references.
2019-10-10 06:00:20 +02:00
Lars Ingebrigtsen
e4efab3f03 Clarify documentation of show-help-function slightly
* doc/lispref/text.texi (Special Properties): Clarify where the
example in Tooltip mode is (bug#35392).
2019-10-10 00:51:55 +02:00
Lars Ingebrigtsen
50886f0992 Add a letrec example to the manuel
* doc/lispref/variables.texi (Local Variables): Add a letrec example.
2019-10-09 19:27:17 +02:00
Lars Ingebrigtsen
fe2e29d29b Tweak letrec documentation
* doc/lispref/variables.texi (Local Variables): Compare letrec to
let* instead of let.
2019-10-09 18:42:41 +02:00
Robert Pluim
b5fbefdac6 Expand documentation on Lisp variables defined in C sources
* doc/lispref/internals.texi (Writing Emacs Primitives): Add
description of DEFVAR_* arguments.  Describe variable naming
conventions.  Explain how to express quoting of symbols in C, plus
'specbind' and how to create buffer-local variables.
2019-10-09 15:14:17 +02:00
Eli Zaretskii
87d999a2f4 Fix minor Texinfo errors in ELisp manual
* doc/lispref/errors.texi (Standard Errors): Fix incorrect
usage of @xref commands.  (Bug#37660)
* doc/lispref/internals.texi (Buffer Internals): Fix markup.
(Bug#37639)
2019-10-09 12:29:21 +03:00
Lars Ingebrigtsen
489a106b1c Document `letrec'
* doc/lispref/variables.texi (Local Variables): Document letrec
(bug#21048).

* lisp/subr.el (letrec): Expand the doc string slightly.
2019-10-09 06:06:24 +02:00
Basil L. Contovounesios
373ffc5931 Clarify docs on newline and auto-fill-mode
* doc/lispref/text.texi (Commands for Insertion):
* lisp/simple.el (newline): Do not mention conditions specific to
'do-auto-fill' under documentation of 'newline' (bug#36702).
2019-10-08 00:10:19 +01:00
Juri Linkov
29db34e3e0 Don't bind 'C-x 6' to '2C-mode-map' globally by default.
* lisp/textmodes/two-column.el: Don't autoload global setting of
"\C-x6" to 2C-command.

* lisp/ldefs-boot.el: Update to remove 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):
Unbind 'C-x 6' from '2C-mode-map'.
2019-10-06 21:47:24 +03:00
Paul Eggert
aadf721676 Improve documentation for year-zero issues
* doc/emacs/calendar.texi (Calendar Systems)
* doc/lispref/os.texi (Time Conversion):
Prefer "BC" to "B.C." since the documentation generally uses "BC".
* doc/misc/emacs-mime.texi (time-date):
* lisp/calendar/time-date.el (date-to-day, time-to-days):
In the doc string, state the day origin more clearly, and more
consistently with the rest of the documentation.
* src/timefns.c (Fdecode_time): State the year origin in
the doc string.
2019-10-05 21:24:09 -07:00
Basil L. Contovounesios
0fc8177414 Further improve button.el support for help-echo
The last change to forward-button added support for help-echo values
that are functions.  This patch fixes the arguments passed to such
functions and further adds support for help-echo values that are
forms (bug#37515).
* doc/lispref/display.texi (Button Properties): Fix description of
help-echo button property.
* lisp/button.el (button--help-echo): New function.
(forward-button): Use it.
(backward-button): Clarify help-echo reference in docstring.
* test/lisp/button-tests.el (button--help-echo-string)
(button--help-echo-form, button--help-echo-function): New tests.
2019-10-03 23:05:14 +01:00
Juri Linkov
2698d3dba2 Merge branch 'feature/tabs' 2019-10-01 23:15:03 +03:00
Juri Linkov
3f981a0a89 Remove unused code and reformat to 70 columns. 2019-10-01 23:01:08 +03:00
Lars Ingebrigtsen
4861328f2a Allow 'M-<' in the minibuffer to behave more logically
* doc/lispref/minibuf.texi (Completion Commands)
(Text from Minibuffer): Document it.

* lisp/minibuffer.el (minibuffer-beginning-of-buffer): New command
(bug#3447).
(map): Bind it.
2019-10-01 15:01:57 +02:00
Juanma Barranquero
24a3288278 Bump up max_specpdl_size to 1600
* src/eval.c (init_eval_once): Set max_specpdl_size to 1600.
* doc/lispref/variables.texi (Local Variables): Document it.
2019-10-01 04:33:28 +02:00
Eli Zaretskii
1e19ee781b Improve description of face merging
* doc/lispref/display.texi (Displaying Faces): More accurate
description of merging face attributes of "underlying text".
(Bug#1222)
2019-09-30 10:49:50 +03:00
Lars Ingebrigtsen
ab2a8f7077 Move convert-images-externally documentation to Emacs manual
* doc/emacs/files.texi (File Conveniences): Move bit about
convert-images-externally to user manual from lispref manual.
2019-09-29 13:32:30 +02:00
Eli Zaretskii
82c79220f5 Improve documentation of image conversion feature
* lisp/image/image-converter.el (image-converter)
(image-convert-p, image-convert):
* lisp/image.el (convert-images-externally):
* etc/NEWS:
* doc/lispref/display.texi (Defining Images): Fix recently
added documentation.
2019-09-29 10:09:56 +03:00
Lars Ingebrigtsen
63f4f02aa7 If requested, use external image converters for exotic formats
* doc/lispref/display.texi (Defining Images): Document it.

* lisp/image.el (convert-images-externally): New variable.
(image-type): Use it.
(create-image): Convert images.

* lisp/image/image-converter.el (image-converter--convert): New file.
2019-09-29 01:26:12 +02:00
Juri Linkov
457a7edb47 Update documentation for tabs.
* doc/emacs/frames.texi (Tab Bars): New node.
2019-09-28 22:55:05 +03:00
Eli Zaretskii
fc3ba91a57 Improve indexing of ELisp manual
* doc/lispref/frames.texi (Font and Color Parameters): Add index
entry for the 'mouse' face.
2019-09-28 22:09:11 +03:00
Lars Ingebrigtsen
45727c4e6d Add a new `dom-search' function
* doc/lispref/text.texi (Document Object Model): Document it.

* lisp/dom.el (dom-search): New function.
2019-09-27 00:33:45 +02:00
Stefan Kangas
814cab3b4d Add new function to clear tags in tabulated list
* lisp/emacs-lisp/tabulated-list.el (tabulated-list-clear-all-tags):
New function to clear all tags from padding area in current buffer.
* doc/lispref/modes.texi (Tabulated List Mode): Document it.
* etc/NEWS: Announce it.
2019-09-26 17:24:35 +02:00
Mattias Engdegård
07367e5b95 Add rx extension mechanism
Add a built-in set of extension macros: `rx-define', `rx-let' and
`rx-let-eval'.

* lisp/emacs-lisp/rx.el (rx-constituents, rx-to-string): Doc updates.
(rx--builtin-symbols, rx--builtin-names, rx--local-definitions)
(rx--lookup-def, rx--substitute, rx--expand-template)
(rx--make-binding, rx--make-named-binding, rx--extend-local-defs)
(rx-let-eval, rx-let, rx-define): New.
(rx--translate-symbol, rx--translate-form): Use extensions if any.
(rx): Use local definitions.
* test/lisp/emacs-lisp/rx-tests.el (rx-let, rx-define)
(rx-to-string-define, rx-let-define, rx-let-eval): New.
* etc/NEWS (Changes in Specialized Modes and Packages):
* doc/lispref/searching.texi (Rx Notation, Rx Functions, Extending Rx):
Add node about rx extensions.
2019-09-25 14:29:50 -07:00
Mattias Engdegård
2ed71227c6 New rx implementation
* lisp/emacs-lisp/rx.el:
* test/lisp/emacs-lisp/rx-tests.el:
* doc/lispref/searching.texi (Rx Constructs):
Rewrite rx for correctness, clarity, and performance.  The new
implementation retains full compatibility and has more comprehensive
tests.

* lisp/emacs-lisp/re-builder.el (reb-rx-font-lock-keywords):
Adapt to changes in internal variables in rx.el.
2019-09-25 14:29:50 -07:00
Mattias Engdegård
a773a64748 Allow regexp-quote to return its argument
* src/search.c (Fregexp_quote): Only allocate a new string if needed.
* doc/lispref/searching.texi (Regexp Functions):
* etc/NEWS (Incompatible Lisp Changes): Document.
2019-09-25 18:09:42 +02:00
Pip Cet
873cd63ff2 Allow a :stride argument so XBM boolvecs are in the right format.
* src/image.c (xbm_image_p): Explicitly specify the right stride if a
bool vector is used as argument.
* doc/lispref/display.texi (XBM Images): Describe bool vectors
accurately.
* etc/NEWS: Document the change (bug#36337).
2019-09-24 18:35:15 +02:00
Robert Pluim
9dcdb1384d Document how to listen on all interfaces in the Elisp manual
* doc/lispref/processes.texi (Network Processes): Explain how to
listen on all interfaces.
2019-09-24 14:45:15 +02:00
Paul Eggert
946a56a10f Update some URLs
This mostly changes http: to https: in URLs.  It also updates
some URLs that have moved, removes some URLs that no longer
work, recommends against using procmail (procmail.org no
longer works), and removes some mentions of the
no-longer-existing Gmane, LPF and VTW.
It doesn't update all URLs, just the ones I had time for.
* GNUmakefile (help):
* admin/admin.el (manual-doctype-string):
* admin/charsets/Makefile.in (${charsetdir}/ALTERNATIVNYJ.map):
* admin/charsets/mapconv:
* lisp/net/soap-client.el (soap-create-envelope):
* lisp/org/org.el (org-doi-server-url):
* lisp/textmodes/bibtex.el (bibtex-generate-url-list):
Prefer https: to http: un URLs.
2019-09-23 00:12:52 -07:00
Paul Eggert
d49d6ea967 Revert too-picky file-access tests
Problem reported by Andreas Schwab (Bug#37475).
* doc/lispref/files.texi (Writing to Files)
(Testing Accessibility, Kinds of Files):
Document that accessibility and file-type predicates return nil
if there is trouble determining accessibility or type.
* etc/NEWS: Adjust, and list the affected primitives.
* src/callproc.c (init_callproc): Go back to Ffile_exists_p.
* src/fileio.c (PICKY_EACCES, file_test_errno):
Remove.  All uses removed.
(Ffile_name_case_insensitive_p, Ffile_exists_p, Ffile_symlink_p)
(Ffile_directory_p, Ffile_regular_p): Document that these
functions return nil if there is trouble.
(Ffile_name_case_insensitive_p, check_file_access)
(Ffile_writable_p, Ffile_symlink_p, Ffile_directory_p)
(Ffile_accessible_directory_p, Ffile_regular_p)
* src/lread.c (Fload):
Go back to treating trouble in determining the answer as if the
file were missing.
* src/fileio.c (Ffile_newer_than_file_p): Use file_attribute_errno
not file_test_errno, since returning nil is not appropriate when
there are two files to test; e.g., in the rare cases where both
file timestamps have overflowed then neither t nor nil is correct.
2019-09-21 11:38:36 -07:00
Stefan Kangas
6d50010b34 Recommend against SHA-1 and MD5 for security
* doc/lispref/text.texi (Checksum/Hash):
* src/fns.c (Fmd5, Fsecure_hash):
* lisp/subr.el (sha1): Doc fix to recommend against SHA-1 and MD5 for
security-related applications, since they are not collision
resistant.  (Bug#37420)
2019-09-20 20:47:47 +02:00