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

7727 commits

Author SHA1 Message Date
Lars Ingebrigtsen
556ae6674c Mention shifted alphabetical control GUI sequences
* doc/emacs/custom.texi (Modifier Keys): Mention that you can bind
shifted alphabetical control sequences in GUI frames (bug#23247).
2019-10-13 20:06:19 +02: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
b37fa09337 Don't claim that the default height is precisely 36 characters
* doc/emacs/cmdargs.texi (Window Size X):
* doc/man/emacs.1.in: Be more vague about what the default height
is (bug#33921).
2019-10-13 00:49:09 +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
Paul Eggert
4b60e0722d Update from Gnulib
This incorporates:
2019-10-11 Simplify and regularize regex use of ‘assert’
2019-10-09 regex: omit debug assignment when not debugging
2019-10-09 regex: tell compiler there’s at most 256 arcs out
2019-10-09 regex: simplify by assuming C99
2019-10-09 regex: avoid copying of uninitialized storage
2019-09-29 fbufmode: Fix compilation error on glibc >= 2.28 systems
2019-09-28 Update comments that refer to POSIX
2019-09-23 Update URLs and associated text
* doc/misc/texinfo.tex, lib/open.c, lib/regcomp.c:
* lib/regex_internal.c, lib/regex_internal.h, lib/regexec.c:
* lib/stdio-impl.h:
Copy from Gnulib.
2019-10-11 18:24:19 -07: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
Stefan Kangas
65cda95be4 Remove reference to obsolete package gnuserv from FAQ
On visiting http://meltin.net/hacks/emacs/, we now find:
"I used to have some Emacs and Haskell hacks on my previous
sites. However, these hacks are now old and un-maintained. I don’t
think there is enough interest to keep them around."

* doc/misc/efaq.texi (Using an already running Emacs process):
Remove reference to obsolete package 'gnuserv'.  (Bug#37574)
2019-10-11 15:59:42 +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
17fea5ba38 Expand the documentation of --no-build-details
* doc/emacs/cmdargs.texi (Initial Options): Mention that
--no-build-details shouldn't be used in regular usage (bug#34448).
2019-10-11 09:05:25 +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
b16f19626c Move the "Skeleton Language" node to later in the manual
* doc/misc/autotype.texi (Skeleton Language): Move this low-level
node to after the more user-facing nodes (bug#20780).
2019-10-09 20:07:56 +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
Michael Albinus
e26c19b889 * doc/misc/tramp.texi (Remote shell setup): Howto configure local shell. 2019-10-09 13:56:58 +02:00
Juanma Barranquero
76a9f03ca6 Implement offsets for absolute line numbers
* src/xdisp.c (syms_of_xdisp) <display-line-numbers-offset>:
New variable to add an offset to absolute line numbers.
(syms_of_xdisp) <display-line-numbers>: Mention it in docstring.
(maybe_produce_line_number): Use it.

* doc/emacs/display.texi (Display Custom): Document it.

* etc/NEWS (value): Announce it.

* lisp/frame.el: Add `display-line-numbers-offset' to list of
variables which should trigger redisplay of the current buffer.
2019-10-09 12:49:39 +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
Federico Tedin
f96b8fd27c Filter packages by name in list-packages. (Bug#36981)
* lisp/emacs-lisp/package.el (package-menu-filter-by-name): New
function to filter packages by name.
(package-menu-clear-filter): New function to clear applied filters.
(package-menu-filter-by-keyword): Rename function from
package-menu-filter.
(package-menu--generate): Don't change 'q' binding anymore.
(package-menu-mode-map): Bind '/ n' to package-menu-filter-by-name, '/
k' to package-menu-filter-by-keyword and '/ /' to
package-menu-clear-filter.
(package-menu-mode-menu): Update menu entries for the three functions.
* test/lisp/emacs-lisp/package-tests.el (package-test-list-filter-by-name)
(package-test-list-clear-filter): New tests.
* doc/emacs/package.texi: Document usage of
package-menu-filter-by-name, package-menu-clear-filter and update
reference to package-menu-filter-by-keyword.
* etc/NEWS: Announce changes.
2019-10-08 19:24:12 +02:00
Hong Xu
ba57f1a427 Search upward from current dir for the default TAGS file
* doc/emacs/maintaining.texi (Select Tags Table): Update the doc
of `visit-tags-table' (bug#37518).
* lisp/progmodes/etags.el (tags--find-default-tags-dir-recursively)
(visit-tags-table): Search upward from current dir for the default
TAGS file.
2019-10-08 18:43:56 +02:00
Stefan Kangas
1793d4979b Fix title inconsistencies in elisp intro book
* doc/lispintro/emacs-lisp-intro.texi: Fix title
inconsistencies.  (Bug#31037)
2019-10-08 18:30:39 +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
Hong Xu
273dd6542d Default FILE to the current buffer for list-tags
* doc/emacs/maintaining.texi (List Identifiers): Update
`list-tags' doc (bug#37611).
* lisp/progmodes/etags.el (list-tags)
(tags--get-current-buffer-name-in-tags-file): Default FILE to the
current buffer for list-tags.
2019-10-07 06:03:21 +02:00
Basil L. Contovounesios
821c96c1b0 ; * doc/misc/eww.texi (Advanced): Fix recent typo. 2019-10-07 03:02:07 +01:00
Juri Linkov
01465915c9 Implement tab-close-other bound to C-x 6 1 by analogy with C-x 5 1.
* lisp/tab-bar.el (tab-close-other): New command bound to C-x 6 1.

* doc/emacs/frames.texi (Tab Bars): Document it.
2019-10-07 00:53:34 +03:00
Juri Linkov
d24a197790 Use tabs in EWW (bug#37592)
* lisp/net/eww.el (eww-open-in-new-buffer): Call tab-new when tab-bar-mode
is enabled.
(eww-browse-url): Add docstring.  Call tab-new when tab-bar-mode
is enabled.

* lisp/net/shr.el (shr-map): Bind [C-down-mouse-1] to
shr-mouse-browse-url-new-window.
(shr-mouse-browse-url-new-window): New command.
(shr-browse-url): Add optional arg new-window.

* doc/misc/eww.texi (Basics): Mention opening tabs on M-RET.
2019-10-07 00:08:10 +03:00
Stefan Kangas
dc8108e109 Support changing font size using mouse wheel
* lisp/mwheel.el (mouse-wheel-mode): Support changing font size (text
scaling) using mouse wheel.  (Bug#28182)
(mouse-wheel-scroll-amount): Bind the Ctrl modifier to text scaling.
(mwheel-installed-text-scale-bindings): New variable.
(mouse-wheel--remove-bindings): New helper function for
'mouse-wheel-mode'.

* doc/emacs/frames.texi (Mouse Commands): Document this feature.
* etc/NEWS: Announce it.
2019-10-06 21:57:58 +02:00
Juanma Barranquero
8de2e69f02 Set alternate faces for some line numbers (bug#27734)
* lisp/faces.el (line-number-major-tick, line-number-minor-tick):
New faces.
* lisp/cus-start.el (display-line-numbers-major-tick)
(display-line-numbers-minor-tick): Add customization info.
* lisp/frame.el: Add `display-line-numbers-major-tick' and
`display-line-numbers-minor-tick' to list of variables which
should trigger redisplay of the current buffer.

* src/xdisp.c (syms_of_xdisp) <display-line-numbers-major-tick>
<display-line-numbers-major-tick>: Defvar new options.
(syms_of_xdisp) <line-number-major-tick, line-number-minor-tick>:
Defsym new faces.
(maybe_produce_line_number): Use new faces for line numbers
that are multiple of `display-line-numbers-major-tick' and
`display-line-numbers-minor-tick'.

* etc/NEWS (value): Announce new feature.
* doc/emacs/display.texi (Display Custom): Describe it.  Wording by
Robert Pluim <rpluim@gmail.com>
2019-10-06 20:53:18 +02: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
Juri Linkov
6b915359ef More tab bar related key bindings.
* lisp/subr.el (ctl-x-6-map, ctl-x-6-prefix): Move here from tab-bar.el
to make it available to other modes like dired for 'C-x 6 d'.

* lisp/dired.el (dired-other-tab): New command bound to 'C-x 6 d'.

* lisp/tab-bar.el: Bind 'C-x 6 o' to tab-next.

* doc/emacs/frames.texi (Tab Bars): Describe C-x 6 prefix key bindings.
2019-10-06 00:54:46 +03:00
Lars Ingebrigtsen
73c6192fe6 Fix typo in frames.texi xref
* doc/emacs/frames.texi (Tab Bars): Fix typo in xref.
2019-10-05 16:50:16 +02:00
Eli Zaretskii
9cf8454463 Improve documentation of Tab bars
* doc/emacs/frames.texi (Menu Bars, Tool Bars, Tab Bars):
Don't start index entries from a capital letter.
(Tab Bars): Improve wording and indexing.

* etc/NEWS: Improve documentation of Tab bars.
2019-10-05 16:03:43 +03: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
52ab948510 * lisp/tab-bar.el (tab-bar-show): New defcustom.
* lisp/tab-bar.el (tab-bar-close-current-tab, tab-bar-close-tab):
(tab-bar-new-tab): Use tab-bar-show.

* doc/emacs/frames.texi (Tab Bars): Add tab-bar-show.

* lisp/speedbar.el (speedbar-mode): Set buffer-local tab-bar-mode
and tab-line-format to nil to not show in dedicated speedbar frame.
2019-10-02 23:18:01 +03:00
Stefan Kangas
9cd3b50ca8 Don't mention server-socket-dir in FAQ
server-socket-dir is a defvar, and users should use the defcustom
server-name instead.

* doc/misc/efaq.texi (Using an already running Emacs process): Remove
details on server-socket-dir, refer to Emacs Manual.  (Bug#20675)
2019-10-02 17:31:19 +02:00