]> code.delx.au - gnu-emacs/log
gnu-emacs
8 years ago; Instrument tramp-tests.el
Michael Albinus [Mon, 9 May 2016 14:53:49 +0000 (16:53 +0200)]
; Instrument tramp-tests.el

8 years agoFix the jit-lock-fontify-now test names
Dmitry Gutov [Mon, 9 May 2016 09:29:18 +0000 (12:29 +0300)]
Fix the jit-lock-fontify-now test names

* test/lisp/jit-lock-tests.el
(jit-lock-fontify-now-mends-the-gaps)
(jit-lock-fontify-now-does-not-refontify-unnecessarily):
Fix the test names.

8 years agoExtend completion candidates in tramp.el
Michael Albinus [Mon, 9 May 2016 07:20:34 +0000 (09:20 +0200)]
Extend completion candidates in tramp.el

* lisp/net/tramp.el (tramp-parse-default-user-host): New defun.
(tramp-get-completion-function): Use it.

8 years agoRevert e2f785991d0c696fbb2bc2f331f888d979b8da82 for tramp.el
Michael Albinus [Mon, 9 May 2016 07:18:50 +0000 (09:18 +0200)]
Revert e2f785991d0c696fbb2bc2f331f888d979b8da82 for tramp.el

* lisp/net/tramp.el (tramp-time-diff): Revert previous change due to backwards
compatibility.

8 years agoEmulate interactive mode
Dmitry Gutov [Mon, 9 May 2016 00:41:49 +0000 (03:41 +0300)]
Emulate interactive mode

* test/lisp/jit-lock-tests.el (jit-lock-tests--setup-buffer)
(jit-lock-does-not-refontify-unnecessarily):
Bind noninteractive to nil (bug#23278).

8 years agoSimplify now that float-time etc. are built-in
Paul Eggert [Sun, 8 May 2016 19:46:00 +0000 (12:46 -0700)]
Simplify now that float-time etc. are built-in

This was prompted by warnings about calls to now-obsolete functions.
* lisp/calendar/time-date.el (encode-time-value):
Use setq rather than a recursive call, to avoid a warning
about calling this obsolete function.
* lisp/calendar/time-date.el (encode-time-value)
(with-decoded-time-value, time-to-seconds, time-to-number-of-days):
* lisp/erc/erc.el (erc-emacs-time-to-erc-time):
* lisp/net/rcirc.el (rcirc-float-time):
* lisp/org/org-compat.el (org-float-time):
Simplify now that time-add and float-time are now built-in.
* lisp/calendar/time-date.el (time-add, time-subtract, time-less-p):
* lisp/net/newst-backend.el (time-add):
* lisp/org/org.el (time-subtract):
Remove backward-compatibility definitions; they are now built-in.
* lisp/calendar/timeclock.el (timeclock-time-to-seconds)
(timeclock-seconds-to-time):
* lisp/net/rcirc.el (rcirc-float-time):
* lisp/org/org-compat.el (org-float-time):
Now obsolete, since callers can just use float-time and
seconds-to-time.  All uses changed.
* lisp/emacs-lisp/ert.el (ert-results-pop-to-timings):
* lisp/gnus/gnus-art.el (article-lapsed-string):
* lisp/gnus/gnus-diary.el (gnus-user-format-function-d):
* lisp/gnus/gnus-group.el (gnus-group-timestamp-delta):
* lisp/gnus/nndiary.el (nndiary-compute-reminders):
* lisp/net/tramp.el (tramp-time-diff):
* lisp/org/org-clock.el (org-clock-timestamps-change):
Prefer the time-subtract builtin to the subtract-time alias.
* lisp/files.el (dir-locals-find-file, dir-locals-read-from-dir):
* test/lisp/character-fold-tests.el (character-fold--speed-test):
Prefer the float-time builtin to the time-to-seconds alias.
* lisp/org/org-agenda.el, lisp/org/org-clock.el, lisp/org/org-list.el:
* lisp/org/org-timer.el, lisp/org/org.el:
Adjust to org-float-time deprecation.

8 years agoAdd :after-hook facility to define-derived-mode.
Alan Mackenzie [Sun, 8 May 2016 13:24:20 +0000 (13:24 +0000)]
Add :after-hook facility to define-derived-mode.

This allow a form to be evaluated _after_ a major mode's hooks have been run.
It is needed to solve some problems in CC Mode, including bug #16759 and
bug #23476.

* lisp/emacs-lisp/derived.el (define-derived-mode): introduce the new argument
`:after-hook', and generate the requisite code for it.
(derived-mode-make-docstring): Take account of the possibility of :after-hook.

* lisp/subr.el (delayed-after-hook-forms): New variable.
(run-mode-hooks): As the last thing evaluate the forms in
delayed-after-hook-forms.

* doc/lispref/modes.texi (Derived Modes): Document :after-hook.
(Mode Hooks): Document the new feature in run-mode-hooks.

* etc/NEWS: Note the new feature.

8 years agoMerge branch 'master' of git.sv.gnu.org:/srv/git/emacs
Michael Albinus [Sun, 8 May 2016 09:47:33 +0000 (11:47 +0200)]
Merge branch 'master' of git.sv.gnu.org:/srv/git/emacs

8 years agoFix recursive load of tramp.elc
Michael Albinus [Sun, 8 May 2016 09:47:08 +0000 (11:47 +0200)]
Fix recursive load of tramp.elc

* lisp/net/tramp.el (tramp-completion-file-name-handler):
Check also for `tramp-completion-mode-p'.
(tramp-completion-mode, tramp-completion-mode-p): Autoload them.

8 years agoPrefer grep -E/-F to egrep/fgrep
Paul Eggert [Sun, 8 May 2016 01:40:10 +0000 (18:40 -0700)]
Prefer grep -E/-F to egrep/fgrep

POSIX marked egrep and fgrep as legacy apps in SUSv2 (1997) and
withdrew them in SUSv3 (2001), and these days grep -E and grep -F
are probably more portable.
* lib-src/etags.c (main):
* lisp/eshell/em-unix.el (eshell-grep, eshell/egrep)
(eshell/fgrep):
* lisp/cedet/semantic/symref.el (semantic-symref-find-text):
* lisp/eshell/esh-var.el (eshell-apply-indices):
* lisp/progmodes/ada-xref.el (ada-xref-search-with-egrep)
(ada-find-in-src-path):
* lisp/textmodes/ispell.el (ispell-grep-command):
(ispell-lookup-words):
Use or document grep -E and grep -F instead of egrep and fgrep.
* lisp/textmodes/ispell.el (ispell-grep-options):
Use -Ei on all platforms, not just MS-Windows.

8 years agoAvoid unnecessary work if a chunk is empty
Dmitry Gutov [Sat, 7 May 2016 23:01:22 +0000 (02:01 +0300)]
Avoid unnecessary work if a chunk is empty

* lisp/jit-lock.el (jit-lock-fontify-now): Avoid unnecessary work
if a chunk is empty (bug#23278).

8 years ago* test/lisp/jit-lock-tests.el: New file.
Dmitry Gutov [Sat, 7 May 2016 23:00:25 +0000 (02:00 +0300)]
* test/lisp/jit-lock-tests.el: New file.

8 years agoContinue to fix Bug#10085
Michael Albinus [Sat, 7 May 2016 20:52:30 +0000 (22:52 +0200)]
Continue to fix Bug#10085

* lisp/net/tramp.el (tramp-completion-file-name-handler-alist)
<expand-file-name>: Add handler.
(tramp-completion-handle-expand-file-name): New defun.
(tramp-handle-file-name-as-directory): Handle completion mode case.

* test/lisp/net/tramp-tests.el (tramp-test06-directory-file-name):
Fix test.
(tramp-test24-file-name-completion): Extend test.

8 years agoRevert change 8e4595a... due to annoyance it causes the development team.
Alan Mackenzie [Sat, 7 May 2016 20:28:18 +0000 (20:28 +0000)]
Revert change 8e4595a... due to annoyance it causes the development team.

Change 8e4595a438fe85dd109756886cdeaeea2e665afb from 2016-04-30 17:28:24
+0000 was an enhancement to .dir-locals to allow correct fontification
of certain macro constructs.

* .dir-locals.el: Remove the two forms for C Mode dealing with noise macros.

8 years ago* lisp/emacs-lisp/edebug.el (edebug-sit-on-break): Give it a version number.
Alan Mackenzie [Sat, 7 May 2016 17:10:36 +0000 (17:10 +0000)]
* lisp/emacs-lisp/edebug.el (edebug-sit-on-break): Give it a version number.

8 years agoAdd tests for CSS mode completion
Simen Heggestøyl [Sat, 7 May 2016 14:32:29 +0000 (16:32 +0200)]
Add tests for CSS mode completion

* test/lisp/textmodes/css-mode-tests.el (css-test-property-values)
(css-test-property-values-no-duplicates)
(css-test-value-class-lookup): Use `seq-sort'.
(css-mode-tests--completions): New helper function for retrieving CSS
completions.
(css-test-complete-bang-rule, scss-test-complete-bang-rule)
(css-test-complete-property-value, css-test-complete-pseudo-class)
(css-test-complete-pseudo-element, css-test-complete-at-rule)
(scss-test-complete-at-rule, css-test-complete-property)
(css-test-complete-selector, css-test-complete-nested-selector)
(scss-test-complete-nested-selector): New tests.

8 years agoAdd an option in Edebug to prevent pauses after `h', 'f', and `o'.
Alan Mackenzie [Sat, 7 May 2016 06:42:29 +0000 (06:42 +0000)]
Add an option in Edebug to prevent pauses after `h', 'f', and `o'.

Requested by Paul Pogonyshev.  Also add in documentation for Edebug config
variables which was missing.

* lisp/emacs-lisp/edebug.el (edebug-sit-on-break): New customizable option.
(edebug--display-1): Test edebug-sit-on-break before pausing 1 second.

* doc/lispref/edebug.texi (Jumping): Document the effect of the new option.
(Edebug Options): Document the new option.  Also add documentation for
edebug-eval-macro-args, edebug-print-length, edebug-print-level,
edebug-print-circle, edebug-sit-for-seconds.

* etc/NEWS: Note the new feature.

8 years agoscheme.el: Turn literal tabs into \t
Jorgen Schaefer [Sat, 7 May 2016 10:22:48 +0000 (12:22 +0200)]
scheme.el: Turn literal tabs into \t

* lisp/progmodes/scheme.el: The last change to turn tabs into spaces
also caught some literal tabs in character classes. Fix this by
adding \t to those classes.

8 years agoMake 'backtab' work in table-mode on text terminals
Tino Calancha [Sat, 7 May 2016 08:19:26 +0000 (11:19 +0300)]
Make 'backtab' work in table-mode on text terminals

* lisp/textmodes/table.el (table-cell-bindings): Bind 'backtab'
explicitly.  (Bug#23456)

8 years agoTry to speed-up display of many all-blank lines
Eli Zaretskii [Sat, 7 May 2016 08:00:36 +0000 (11:00 +0300)]
Try to speed-up display of many all-blank lines

* src/bidi.c (bidi_initialize): Use anchored regexps for
paragraph start and paragraph separator sequences.  (Bug#23457)

8 years agoCorrect hack-local-variables change from Thu May 5 11:05:49 2016 +0000
Alan Mackenzie [Fri, 6 May 2016 18:58:49 +0000 (18:58 +0000)]
Correct hack-local-variables change from Thu May 5 11:05:49 2016 +0000

Prevent hack-local-variables being called from the fundamental-mode mode call
early in normal-mode.  This fixes bug #23460 and bug #23463.

* lisp/files.el (normal-mode) Replace call to fundamental-mode with calls to
the things it calls, with the exception of hack-local-variables.

* etc/NEWS: Add an entry to note the calling of hack-local-variables at each
major mode initialization.

8 years agoPort xref-tests to master branch
Paul Eggert [Fri, 6 May 2016 17:09:13 +0000 (10:09 -0700)]
Port xref-tests to master branch

Also, add a test to make this problem less likely in the future.
* test/Makefile.in (check-no-automated-subdir): New rule.
(check, check-expensive, check-maybe): Depend on it.
* test/automated/data/xref/file1.txt: Rename to ...
* test/data/xref/file1.txt: ... here.
* test/automated/data/xref/file2.txt: Rename to ...
* test/data/xref/file2.txt: ... here.
* test/automated/xref-tests.el: Rename to ...
* test/lisp/progmodes/xref-tests.el: ... here.
(xref-tests-data-dir): Use EMACS_TEST_DIRECTORY.

8 years agoMerge from origin/emacs-25
Paul Eggert [Fri, 6 May 2016 06:11:11 +0000 (23:11 -0700)]
Merge from origin/emacs-25

50650cb Doc fixes for fclist and grep
5e814e0 Minor doc fixes for quoting
3347a73 `nreverse' the marker pairs list
1a4127d Use save-excursion in xref-location-marker more
ab3ba91 shell-quote-argument DIR when appropriate
922c7a3 Rework xref-query-replace-in-results
3fe3510 * lisp/replace.el (query-replace-read-from): Use minibuffer-w...
0932b94 Fix todo-mode bug involving archived items (bug#23447)
e68ad1f ; * etc/NEWS: Tiny edit. (Bug#23432)
adc80b7 ; * test/automated/xref-tests.el: Add copyright and license.
4d8fd9c Handle "empty line" regexp in xref searches
f559b37 Add tests for xref-collect-matches
6428aa0 Use grep-find-ignored-directories instead of vc-directory-exc...
6f82d8e Clear buffer-undo-list when showing xrefs
c68a091 Note the quote translation in `message' in section "incompati...
52f86a7 * etc/NEWS: Mention (message "%s" (format ...)).
93703c5 (Common Keywords): Correct what missing :group means
79e5800 Improve documentation of Dired's 'A' and 'Q' commands
2ea2a2f Doc fixes for quoting
8544b98 posnp doc clarification
805204f Mention what a missing :group does
ec554d7 Fix documentation of dired-aux search/replace commands

8 years agoDoc fixes for fclist and grep
Paul Eggert [Thu, 5 May 2016 19:48:33 +0000 (12:48 -0700)]
Doc fixes for fclist and grep

A newline is needed between two fc-list calls.
egrep and fgrep have been withdrawn from POSIX,
so document grep -E and grep -F instead.

8 years agoSupport completion of HTML tags in CSS selectors
Simen Heggestøyl [Thu, 5 May 2016 19:21:10 +0000 (21:21 +0200)]
Support completion of HTML tags in CSS selectors

* lisp/textmodes/css-mode.el (css--html-tags): New variable holding a
list of HTML tags for completion.
(css--nested-selectors-allowed): New variable for determining whether
nested selectors are allowed in the current mode.
(css--complete-selector): New function for completing part of a CSS
selector.
(css-completion-at-point): Support completion of selectors.
(scss-mode): Allow nested selectors.

8 years agoMake `R' in eww work more reliably
Lars Ingebrigtsen [Thu, 5 May 2016 17:41:11 +0000 (19:41 +0200)]
Make `R' in eww work more reliably

* lisp/net/eww.el (eww-score-readability): Protect against
null children.

8 years agoMinor doc fixes for quoting
Paul Eggert [Thu, 5 May 2016 13:39:17 +0000 (06:39 -0700)]
Minor doc fixes for quoting

* doc/lispref/control.texi (Signaling Errors):
* doc/lispref/display.texi (Displaying Messages):
Don’t say that formats “generate”.  Try to word more clearly.
* etc/NEWS: Coalesce near-duplicate entries.

8 years ago`nreverse' the marker pairs list
Dmitry Gutov [Thu, 5 May 2016 13:01:52 +0000 (16:01 +0300)]
`nreverse' the marker pairs list

* lisp/progmodes/xref.el (xref--buf-pairs-iterator): `nreverse'
the marker pairs list for each buffer before returning.

8 years agoCall hack-local-variables from major modes rather than from file visiting
Alan Mackenzie [Thu, 5 May 2016 11:05:49 +0000 (11:05 +0000)]
Call hack-local-variables from major modes rather than from file visiting

This prevents file/directory local variables from being lost when the major
mode is set or changed.

This fixes bug #15577 and bug #23407.

* lisp/files.el (normal-mode): Call `hack-local-variables' when the major mode
function hasn't already done so.
(hack-local-variables): Rename parameter `mode-only' to `handle-mode', make
its previous non-nil setting be t, and introduce the following action for a
non-nil non-t value: apply all settings apart from `mode'.

* lisp/subr.el (run-mode-hooks): call `hack-local-variables' for buffers
which are visiting files.

* doc/emacs/custom.texi (File Variables): Note that setting a major mode also
sets file variables.
(Directory Variables): Note that `mode', `eval', and `unibyte' can be set as
dir local variables, but `coding' can't.

* doc/lispref/modes.texi (Major Mode Conventions): Say that `run-mode-hooks'
also calls `hack-local-variables'.
(Auto Major Mode): Say that `find-file' no longer runs `hack-local-variables',
as from 25.2.  Remove vagueness from `normal-mode' and `set-auto-mode' by
saying that the mode IS SET, not merely "selected" or "chosen".
(Mode Hooks): Document change to `run-mode-hooks'.

* doc/lispref/variables.texi (File Local Variables): Document change to
`hack-local-variables'.

8 years agotramp-sh.el: Work around a stat bug
Michael Albinus [Thu, 5 May 2016 08:23:06 +0000 (10:23 +0200)]
tramp-sh.el: Work around a stat bug

* lisp/net/tramp-sh.el (tramp-get-remote-stat): Do not use
stat versions which produce shell quoted output.  See also
coreutils Bug#23422.

8 years agoFix autogen.sh for separate worktrees
Noam Postavsky [Thu, 5 May 2016 04:09:22 +0000 (21:09 -0700)]
Fix autogen.sh for separate worktrees

* autogen.sh: Use the $hooks variable in the $sample_hooks loop, instead
of assuming .git/hooks is a directory.

8 years agoUse save-excursion in xref-location-marker more
Dmitry Gutov [Thu, 5 May 2016 01:28:14 +0000 (04:28 +0300)]
Use save-excursion in xref-location-marker more

* lisp/progmodes/elisp-mode.el (xref-location-marker): Use
save-excursion, in order not to alter the value of point if the
buffer is currently open in the background (problem reported by
Robert Weiner).

* lisp/progmodes/etags.el (xref-location-marker): Same.

8 years agoshell-quote-argument DIR when appropriate
Dmitry Gutov [Thu, 5 May 2016 01:15:23 +0000 (04:15 +0300)]
shell-quote-argument DIR when appropriate

* lisp/progmodes/project.el (project-file-completion-table):
`shell-quote-argument' DIR as well.

* lisp/progmodes/xref.el (xref--rgrep-command): Pass DIR through
`shell-quote-argument' (bug#23453).  Thanks for Kaushal Modi for
pointing out the problem.  Assert that DIR doesn't start with `~'.

8 years agoRework xref-query-replace-in-results
Dmitry Gutov [Wed, 4 May 2016 23:52:34 +0000 (02:52 +0300)]
Rework xref-query-replace-in-results

* lisp/progmodes/xref.el (xref-query-replace-in-results): Collect
all xrefs from the buffer first, then delegate most of the
processing to the value returned by xref--buf-pairs-iterator.
(xref--buf-pairs-iterator): New function.  Return an "iterator"
which partitions returned markers into buffers, and only processes
markers from one buffer at a time.  When an xref is out of date,
skip it with a message instead of signaling error (bug#23284).
(xref--outdated-p): Extract from xref--buf-pairs-iterator.  Trim
CR from both strings before comparing.
(xref--query-replace-1): Remove the variable current-buf, no need
to track it anymore.  Simplify the filter-predicate and search
functions accordingly.  Iterate over buffer-markers pairs returned
by the iterator, and call `perform-replace' for each of them.  Use
multi-query-replace-map (bug#23284).  Use `switch-to-buffer' every
time after the first, in order not to jump between windows.

* test/automated/xref-tests.el
(xref--buf-pairs-iterator-groups-markers-by-buffers-1)
(xref--buf-pairs-iterator-groups-markers-by-buffers-2)
(xref--buf-pairs-iterator-cleans-up-markers): New tests.

8 years ago* lisp/replace.el (query-replace-read-from): Use minibuffer-with-setup-hook
Juri Linkov [Wed, 4 May 2016 20:05:33 +0000 (23:05 +0300)]
* lisp/replace.el (query-replace-read-from): Use minibuffer-with-setup-hook

to set minibuffer-local value of text-property-default-nonsticky.
(Bug#23418, bug#23127)

8 years agoAllow `text-quoting-style' to be `leave', i.e. no translation of quotes.
Alan Mackenzie [Wed, 4 May 2016 19:59:50 +0000 (19:59 +0000)]
Allow `text-quoting-style' to be `leave', i.e. no translation of quotes.

* lisp/help-fns.el (describe-function-1): Don't set coding system to UTF-8
when text-quoting-style is `leave'.

* src/lisp.h (enum text_quoting_style): Add identifier LEAVE_QUOTING_STYLE.

* src/doc.c (syms_of_doc): New symbol "leave".  Amend doc string of
`text_quoting_style'.
(text_quoting_style): Handle `leave' by returning LEAVE_QUOTING_STYLE.
(Fsubstitute_command_keys): Don't translate quotes when quoting_style is
LEAVE_QUOTING_STYLE.

* src/editfns.c (styled_format): Set quoting_style to -1 when
text-quoting-style is `leave'.

8 years agoFix todo-mode bug involving archived items (bug#23447)
Stephen Berman [Wed, 4 May 2016 19:52:32 +0000 (21:52 +0200)]
Fix todo-mode bug involving archived items (bug#23447)

* lisp/calendar/todo-mode.el (todo-jump-to-category): When jumping
from Todo Categories mode to a category with only archived items
and todo-skip-archived-categories is non-nil, make sure the
archive file buffer is in Todo Archive mode to prevent
todo-category-select from raising an error, and don't set
todo-current-todo-file, since that makes todo-show display the
archived category.  Remove a no-op call to kill-buffer, which is
already called in todo-insert-category-line.

8 years ago; * etc/NEWS: Tiny edit. (Bug#23432)
Glenn Morris [Wed, 4 May 2016 17:23:21 +0000 (13:23 -0400)]
; * etc/NEWS: Tiny edit. (Bug#23432)

8 years ago* lisp/emulation/viper(-cmd)?.el: Use lexical-binding.
Stefan Monnier [Wed, 4 May 2016 15:09:01 +0000 (11:09 -0400)]
* lisp/emulation/viper(-cmd)?.el: Use lexical-binding.

* lisp/emulation/viper-cmd.el: Use lexical-binding.
(viper-change-state-to-vi, viper-change-state-to-emacs): Allow dummy
args, for use in advice-add.
(viper--init-message): Rename from init-message.
(viper-minibuffer-standard-hook): Adjust accordingly.
(viper-undo): Remove unused var `modified'.
(viper-read-string-with-history, viper-set-searchstyle-toggling-macros):
Don't use dynamic vars as args.
(viper-submit-report): Clarify use of dynamic vars.

* lisp/emulation/viper.el: Use lexical-binding and nadvice.
Remove redundant :group keywords.  Group the (if viper-mode) at top-level.
Use add-function rather than a `(lambda ...).
(viper--advice-list): New var.
(viper--advice-add, viper--deactivate-advice-list): New funs.
(viper-go-away, viper-set-hooks, viper-non-hook-settings): Use them.
(viper-non-hook-settings): Don't hook into find-file any more.

8 years ago* lisp/vc/ediff-util.el: Use lexical-binding.
Stefan Monnier [Wed, 4 May 2016 13:12:49 +0000 (09:12 -0400)]
* lisp/vc/ediff-util.el: Use lexical-binding.

8 years ago* lisp/progmodes/js.el (js-syntax-propertize): Recognize shebang line.
Stefan Monnier [Wed, 4 May 2016 12:53:00 +0000 (08:53 -0400)]
* lisp/progmodes/js.el (js-syntax-propertize): Recognize shebang line.

8 years ago; * test/automated/xref-tests.el: Add copyright and license.
Glenn Morris [Wed, 4 May 2016 02:36:40 +0000 (19:36 -0700)]
; * test/automated/xref-tests.el: Add copyright and license.

8 years agoAdd an animation sanity check
Lars Ingebrigtsen [Tue, 3 May 2016 23:37:01 +0000 (01:37 +0200)]
Add an animation sanity check

* lisp/image.el (image-multi-frame-p): Give up on animations
if it seems like they are too slow (bug#23431).

8 years agoHandle "empty line" regexp in xref searches
Dmitry Gutov [Tue, 3 May 2016 22:59:29 +0000 (01:59 +0300)]
Handle "empty line" regexp in xref searches

* lisp/progmodes/xref.el (xref--collect-matches-1): Stop after one
match if re-search-forward doesn't move point (bug#23426).

* test/automated/xref-tests.el
(xref-collect-matches-finds-an-empty-line-regexp-match):
Uncomment test.

8 years agoAdd tests for xref-collect-matches
Dmitry Gutov [Tue, 3 May 2016 22:38:02 +0000 (01:38 +0300)]
Add tests for xref-collect-matches

* test/automated/xref-tests.el: New file.  Add tests for
xref-collect-matches.

8 years agoUse grep-find-ignored-directories instead of vc-directory-exclusion-list
Dmitry Gutov [Tue, 3 May 2016 22:02:43 +0000 (01:02 +0300)]
Use grep-find-ignored-directories instead of vc-directory-exclusion-list

* lisp/dired-aux.el (dired-do-find-regexp):
Use grep-find-ignored-directories instead of
vc-directory-exclusion-list.  The result should be functionally
similar (the former uses the latter as the default value), but it
should be more consistent and appropriate WRT user
customizations.
(dired-do-find-regexp-and-replace): Update the docstring.

* lisp/dired.el: Update the corresponding autoloads.

* doc/emacs/dired.texi (Operating on Files): Update the
documentation accordingly.

8 years agoClear buffer-undo-list when showing xrefs
Dmitry Gutov [Tue, 3 May 2016 21:42:43 +0000 (00:42 +0300)]
Clear buffer-undo-list when showing xrefs

* lisp/progmodes/xref.el (xref--show-xref-buffer): Clear
buffer-undo-list and temporarily bind it to t while rendering the
buffer contents.

8 years agoNote the quote translation in `message' in section "incompatible changes".
Alan Mackenzie [Tue, 3 May 2016 20:27:48 +0000 (20:27 +0000)]
Note the quote translation in `message' in section "incompatible changes".

* etc/NEWS: Note that `message' translates quotes, that the translation
cannot be disabled, and that `format' can be used to get the old
behavior back.

8 years ago* etc/NEWS: Mention (message "%s" (format ...)).
Paul Eggert [Tue, 3 May 2016 20:30:21 +0000 (13:30 -0700)]
* etc/NEWS: Mention (message "%s" (format ...)).

8 years agoabbrev-tests.el fix
Lars Ingebrigtsen [Tue, 3 May 2016 17:21:47 +0000 (19:21 +0200)]
abbrev-tests.el fix

* test/lisp/abbrev-tests.el (abbrev-table-p-test): Don't check
internal implementation detail.

8 years ago(Common Keywords): Correct what missing :group means
Lars Ingebrigtsen [Tue, 3 May 2016 17:06:13 +0000 (19:06 +0200)]
(Common Keywords): Correct what missing :group means

* doc/lispref/customize.texi (Common Keywords): Correct what
missing :group means.

8 years agoImprove documentation of Dired's 'A' and 'Q' commands
Eli Zaretskii [Tue, 3 May 2016 16:14:31 +0000 (19:14 +0300)]
Improve documentation of Dired's 'A' and 'Q' commands

* lisp/dired-aux.el (dired-do-find-regexp)
(dired-do-find-regexp-and-replace): Mention
'grep-find-ignored-files' and 'vc-directory-exclusion-list', and
also the fact that REGEXP should be palatable by Grep.  (Bug#23426)
* lisp/dired.el: Update the corresponding autoload forms.

* doc/emacs/dired.texi (Operating on Files): Mention
'grep-find-ignored-files' and 'vc-directory-exclusion-list'.
(Bug#23429)

8 years ago(shr-rescale-image): Clarify logic slightly
Lars Ingebrigtsen [Tue, 3 May 2016 15:26:54 +0000 (17:26 +0200)]
(shr-rescale-image): Clarify logic slightly

* lisp/net/shr.el (shr-rescale-image): Clarify logic slightly.

8 years agoDoc fixes for quoting
Paul Eggert [Tue, 3 May 2016 15:02:16 +0000 (08:02 -0700)]
Doc fixes for quoting

* doc/emacs/text.texi, doc/lispintro/emacs-lisp-intro.texi:
* doc/lispref/control.texi, doc/lispref/display.texi:
* doc/lispref/help.texi, doc/lispref/strings.texi, lisp/subr.el:
* src/callint.c, src/doprnt.c, src/editfns.c:
Document quoting a bit more systematically.
Problem reported by Alan Mackenzie (Bug#23425).

8 years agoBind `widget-button-click' to mouse-1/-2 instead of down-mouse-1/-2
Martin Rudalics [Tue, 3 May 2016 06:38:49 +0000 (08:38 +0200)]
Bind `widget-button-click' to mouse-1/-2 instead of down-mouse-1/-2

* lisp/wid-edit.el (widget-keymap): Bind `widget-button-click'
to mouse-1/-2 instead of down-mouse-1/-2.  Suggested by Stefan
Monnier.  (Bug#19185, Bug#20398)

8 years agoAdd more abbrev tests
Lee Bochicchio [Mon, 2 May 2016 22:12:53 +0000 (00:12 +0200)]
Add more abbrev tests

* test/lisp/abbrev-tests.el
(clear-abbrev-table-test): Use `abbrev-expansion'
(abbrev-table-empty-p-test, list-abbrevs-test)
(prepare-abbrev-list-buffer-test, insert-abbrevs-test)
(edit-abbrevs-test, define-abbrevs-test)
(read-write-abbrev-file-test)
(abbrev-edit-save-to-file-test): New tests (bug#23139).

8 years agoposnp doc clarification
Lars Ingebrigtsen [Mon, 2 May 2016 22:08:31 +0000 (00:08 +0200)]
posnp doc clarification

* lisp/subr.el (posnp): Mention that a posn object is returned
from `event-start' (bug#18211).

8 years agoMention what a missing :group does
Lars Ingebrigtsen [Mon, 2 May 2016 22:02:50 +0000 (00:02 +0200)]
Mention what a missing :group does

* doc/lispref/customize.texi (Common Keywords): Document that
a missing :group reuses the group from the preceding item (bug#21601).

8 years agoAllow eval-ing named character literals
Philipp Stephani [Mon, 2 May 2016 21:58:15 +0000 (23:58 +0200)]
Allow eval-ing named character literals

* lisp/progmodes/elisp-mode.el (elisp--preceding-sexp): Skip over
named character literals.
* test/lisp/progmodes/elisp-mode-tests.el
(elisp--preceding-sexp--char-name): Add test for skipping over
named character literals (bug#23354).

Copyright-paperwork-exempt: yes

8 years agoCall va_end in boot_error
Aaron Conole [Mon, 2 May 2016 21:42:10 +0000 (23:42 +0200)]
Call va_end in boot_error

* src/gnutls.c (boot_error): A recent change added a function
to signal an error or return an error code. That function uses
a variadic argument list to populate an error message
string. However, it missed calling va_end after using the
variadic argument list.

  Copyright-paperwork-exempt: yes

8 years agoFix the call to set_network_coding_system
Aaron Conole [Mon, 2 May 2016 21:40:14 +0000 (23:40 +0200)]
Fix the call to set_network_coding_system

* src/process.c (Fmake_network_process): A recent commit
modified the set_network_socket_coding_system function to take
arguments host, service, and name. However, those arguments
appear to be swapped.

  Copyright-paperwork-exempt: yes

8 years agoFix documentation of dired-aux search/replace commands
Eli Zaretskii [Mon, 2 May 2016 19:57:06 +0000 (22:57 +0300)]
Fix documentation of dired-aux search/replace commands

* lisp/dired-aux.el (dired-do-find-regexp)
(dired-do-find-regexp-and-replace): Doc fixes.  (Bug#23429)
* lisp/dired.el: Update the corresponding autoload forms.

8 years agoRevert "alas, a map can have only one parent"
Lars Ingebrigtsen [Mon, 2 May 2016 18:08:48 +0000 (20:08 +0200)]
Revert "alas, a map can have only one parent"

This reverts commit d05806fda1cbba2db112bc783597fbe9d27175b2.

This had already been fixed by using `make-composed-map'.  And
we don't want image-map to inherit from special-mode-map, anyway.

8 years agoMerge from origin/emacs-25
Paul Eggert [Mon, 2 May 2016 17:46:53 +0000 (10:46 -0700)]
Merge from origin/emacs-25

bf21c84 Fix quoting problem in cc-engine debug message
8f36614 Add electric-quote-string unit test
6280531 Don’t electrically quote ‘'’ in Python
fd7b430 `nreverse' Grep hits before passing them to xref--convert-hits

8 years agoFix quoting problem in cc-engine debug message
Paul Eggert [Mon, 2 May 2016 17:06:04 +0000 (10:06 -0700)]
Fix quoting problem in cc-engine debug message

* lisp/progmodes/cc-engine.el (c-replay-parse-state-state):
Use "%s" format to pass through ‘'’ unscathed (Bug#23425), and
likewise for ‘`’, and ‘%’.

8 years agoAdd electric-quote-string unit test
Philipp Stephani [Mon, 2 May 2016 15:57:30 +0000 (08:57 -0700)]
Add electric-quote-string unit test

* test/automated/electric-tests.el (electric-quote-string): New test.

8 years agoDon’t electrically quote ‘'’ in Python
Paul Eggert [Mon, 2 May 2016 15:56:02 +0000 (08:56 -0700)]
Don’t electrically quote ‘'’ in Python

Problem reported by Philipp Stephani (Bug#23387).
* lisp/electric.el (electric-quote-post-self-insert-function):
Do not requote a string starter or ender.

8 years agoalas, a map can have only one parent
Sam Steingold [Fri, 22 Apr 2016 18:52:37 +0000 (14:52 -0400)]
alas, a map can have only one parent

* lisp/image-mode.el (image-model-map): Cannot have two parents.
* lisp/image.el (image-map): Inherit from `special-mode-map'.

8 years ago; Fix last commit in tramp-tests.el
Michael Albinus [Mon, 2 May 2016 09:45:16 +0000 (11:45 +0200)]
; Fix last commit in tramp-tests.el

8 years ago`nreverse' Grep hits before passing them to xref--convert-hits
Dmitry Gutov [Sun, 1 May 2016 23:38:01 +0000 (02:38 +0300)]
`nreverse' Grep hits before passing them to xref--convert-hits

* lisp/progmodes/xref.el (xref-collect-matches): `nreverse' hits
before passing them to xref--convert-hits.  Fixes a regression
from cc0b7132.

8 years agoFix Bug#10085
Michael Albinus [Mon, 2 May 2016 07:02:27 +0000 (09:02 +0200)]
Fix Bug#10085

* lisp/net/tramp.el (tramp-find-foreign-file-name-handler):
Add optional arguments OPERATION and COMPETION.  Handle
`file-name-as-directory', `file-name-directory' and
`file-name-nondirectory' also in completion mode.
(tramp-file-name-handler): Use it.  (Bug#10085)

* test/lisp/net/tramp-tests.el (tramp-test06-directory-file-name):
Extend test.

8 years ago* src/minibuf.c (read_minibuf): Use CONSP instead of Fconsp.
Martin Rudalics [Mon, 2 May 2016 06:25:08 +0000 (08:25 +0200)]
* src/minibuf.c (read_minibuf): Use CONSP instead of Fconsp.

8 years agoTweak .gitignore
Paul Eggert [Mon, 2 May 2016 05:44:14 +0000 (22:44 -0700)]
Tweak .gitignore

* .gitignore: Remove leim/changed.misc, leim/changed.tit,
as these files are no longer created.  Add gmon.out, for
-pg profiling.  Sort.

8 years ago; Spelling and quoting fixes
Paul Eggert [Mon, 2 May 2016 01:52:50 +0000 (18:52 -0700)]
; Spelling and quoting fixes

8 years agoSync from gnulib
Paul Eggert [Mon, 2 May 2016 01:36:38 +0000 (18:36 -0700)]
Sync from gnulib

This incorporates:
2016-05-01 mktime: port to stricter signed overflow checking
2016-05-01 mktime: speed up DEBUG_MKTIME benchmarks
2016-05-01 mktime: resurrect DEBUG_MKTIME testing
2016-05-01 mktime: simplify DEBUG_MKTIME
2016-05-01 Port mktime_internal offset to unsigned time_t
2016-04-27 xstrtol: prohibit monstrosities like "1bB"
2016-04-13 mktime: improve integer overflow checking
2016-04-13 intprops: check two's complement assumption
2016-04-13 intprops, mktime, strtol: assume two's complement
* lib/intprops.h, lib/mktime-internal.h, lib/mktime.c:
* lib/strtol.c, lib/timegm.c, m4/mktime.m4, m4/std-gnu11.m4:
Copy from gnulib.

8 years ago; Fix texinfo typo
Paul Eggert [Mon, 2 May 2016 01:24:05 +0000 (18:24 -0700)]
; Fix texinfo typo

8 years agoMerge from origin/emacs-25
Paul Eggert [Mon, 2 May 2016 01:14:23 +0000 (18:14 -0700)]
Merge from origin/emacs-25

c695fb3 ; Spelling fixes
03750c0 * doc/misc/texinfo.tex: Sync from gnulib.
42fed3b * lisp/isearch.el (isearch-forward-symbol-at-point): Add isea...

8 years ago; Merge from origin/emacs-25
Paul Eggert [Mon, 2 May 2016 01:14:23 +0000 (18:14 -0700)]
; Merge from origin/emacs-25

The following commits were skipped:

8aa4147 tramp.texi: Revert last change due to backward compatibility
69f7940 cua-prefix-override-inhibit-delay doc fix
350792e global-eldoc-mode doc fix
c3b3b90 normal-top-level-add-subdirs-to-load-path doc fix
9f27bcf isearch-search-fun-function doc tweak
78ae805 Fill some imenu--index-alist doc lines
d1ab001 Fmarker_position doc string clarification
8c66ebf Further define-obsolete-* doc fixups
25b4cf3 Describe WHEN in all the define-obsolete- macros
6b39501 Mention with-silent-modifications in the lispref manual
9722ae1 with-silent-modifications doc clarification
3bc26a7 clear-visited-file-modtime doc string fix
7b7b4c2 Document mode mode line variables
7907b82 Add a cross ref to Optional Mode Line
ecdb340 Add a doc string to display-time-string
6d8c2d0 custom-buffer-style doc fix
ef32be6 Rearrange the doc of query-replace slightly
7350d3d apropos-print doc fix
afb2257 completion-table-with-predicate doc string fix
f3f4502 Fill the completion-table-with-predicate doc string
983ad8d replace-match-maybe-edit doc clarification
bbda22c add-timeout doc fix
818fb69 Extremely minor doc fix in Choosing Window
2abc85e Transform mentions of `eval-after-load' to `with-eval-after-l...
ec392ff cursor-type doc fix
ff834ff Add a link from Tool Bar to Images
93598ff (default-mode-line-format): More explicit obsolete info
b04fcc4 Fcompare_buffer_substrings doc string clarification
f92d0aa insert-file-contents-literally doc fix
ad5572b Fix custom types for cursor-in-non-selected-windows
2ef780f Doc clarification to mwheel-scroll
ed8474e Clarify the doc of eval-expression-print-format
8f1e784 Explictly explain that package-initialize loads the packages
1378680 Have the doc strings of `load-path' and `require' mention eac...
a73de71 Doc fix for insert-pair-alist
619f1ed Move doc of backup-directory-alist to the Backup node
0846f21 Tiny doc clarification for create-fontset-from-fontset-spec
925af7e Fill the doc string of font-lock-keywords
05194cb Doc fix for font-lock-remove-keywords
7a03d55 Clarify whitespace-style doc string
651182d Doc fixed for next-error-buffer-p
d815ba5 Tiny doc fix
7b85885 Doc fix
c355774 delsel doc touch ups
4a2f33d Doc fixes for menu-bar.el
71795d4 Doc fix
3852fd6 Minor doc clarification
db20f89 Fill font-lock-mode doc string
df6cee9 Wrap the auto-generated doc string
dc960d9 Clarify hi-lock-find-patterns
8748c21 Add a doc string to `winner-mode'
02c1aa8 Doc fix for align-newline-and-indent
bc6c294 Doc fix for `kbd'
28ef870 Doc tweak
92559c7 Link from (emacs)Exiting to (lisp)Killing Emacs
cc00738 find-lisp doc touchups
396747d Don't have the manual claim that it lists all CL incompatibil...
3cbc1e3 Change all occurrences of "Mouse-[0-9]" to "mouse-[0-9]"
de8349e Doc string change to enable-recursive-minibuffers
cf33ae0 Clarify the `interactive' doc string slightly
0a14d84 Clarify some doc strings
351c079 Add some concept index entries for custom types
3fc1ed8 Mention `lisp-indent-function' in the lispref manual
9bd2af8 Clarify doc string of internal compilation function

8 years agoMerge from origin/emacs-25
Paul Eggert [Mon, 2 May 2016 01:14:22 +0000 (18:14 -0700)]
Merge from origin/emacs-25

d8affa3 Use ‘T *restrict’ proto, not ‘T[restrict]’
d38d2a8 Fix documentation of 'url-retrieve-synchronously'
586b213 * lisp/url/url.el (url-retrieve-synchronously): Doc fix.  (Bu...

# Conflicts:
# doc/misc/url.texi
# lisp/url/url.el

8 years ago; Merge from origin/emacs-25
Paul Eggert [Mon, 2 May 2016 01:09:30 +0000 (18:09 -0700)]
; Merge from origin/emacs-25

The following commit was skipped:

3cade20 ; Auto-commit of loaddefs files.

8 years agoMerge from origin/emacs-25
Paul Eggert [Mon, 2 May 2016 01:09:29 +0000 (18:09 -0700)]
Merge from origin/emacs-25

16e5e8e Fix last change to isearch-update (bug#23406)
b755d98 Autoload cursor-sensor-inhibit (bug#23406)
b52ebd4 org-map-entries: Fix org-agenda-prepare-buffers call
86aa409 Followup for last commit in the user manual
7004459 Improve doc string of 'set-goal-column'
ccdaf04 Fix the MSDOS build
ffe701c Remove \= from format string (bug#18190)
1c58fa1 Fix variable-pitch font on MS-Windows
c6077bf Restore follow-scroll-up/down to scrolling by the combined si...
b671e21 Revert unneeded change which harms syntactic parsing.  This f...
48b24c9 Correct indentation of ids in a C++ enum after a protection k...
5c3534f * lisp/window.el (window--process-window-list): No-op if no p...
734fb3a Port dumping to NetBSD with PaX
0255a70 Don't mistake `for' inside a function for a part of array com...

# Conflicts:
# src/Makefile.in

8 years ago; Merge from origin/emacs-25
Paul Eggert [Mon, 2 May 2016 01:07:58 +0000 (18:07 -0700)]
; Merge from origin/emacs-25

The following commit was skipped:

ff7e201 Fix bug#22891: wrong terminal width when a fringe width is zero.

8 years agoMerge from origin/emacs-25
Paul Eggert [Mon, 2 May 2016 01:07:57 +0000 (18:07 -0700)]
Merge from origin/emacs-25

71fb0e0 Improve last change to vc-git-mode-line-string
6858e77 Todo mode doc bug fix
e55d0db Fix revision calculation in vc-git-mode-line-string
ca87b34 ; Fix errant revert ccb75d7
40bfebe Add Python 3.5 keyword "await"
fa7886a Add new keywords of Python 3.5
ccb75d7 Partially revert previous change.
8ee168a ; * etc/NEWS: Update entry about color fonts on OS X with a w...
b09ca27 Say why text-quoting-style is not a user option

8 years ago; Merge from origin/emacs-25
Paul Eggert [Mon, 2 May 2016 01:07:57 +0000 (18:07 -0700)]
; Merge from origin/emacs-25

The following commits were skipped:

935715a * lisp/emacs-lisp/autoload.el (update-directory-autoloads): F...
6ac9892 ; Auto-commit of loaddefs files.

8 years agoMerge from origin/emacs-25
Paul Eggert [Mon, 2 May 2016 01:07:56 +0000 (18:07 -0700)]
Merge from origin/emacs-25

5a952eb Don't mention ~/.emacs.bmk literally in doc strings
c338cf3 * etc/NEWS: Explain why multicolor font display is disabled o...
c30d1b4 Port to Ubuntu 16.04 --enable-gcc-warnings

8 years ago; Spelling fixes
Paul Eggert [Mon, 2 May 2016 01:01:19 +0000 (18:01 -0700)]
; Spelling fixes

8 years ago* doc/misc/texinfo.tex: Sync from gnulib.
Paul Eggert [Mon, 2 May 2016 00:58:42 +0000 (17:58 -0700)]
* doc/misc/texinfo.tex: Sync from gnulib.

8 years agoMention the `find-library-name' changes
Lars Ingebrigtsen [Sun, 1 May 2016 23:49:01 +0000 (01:49 +0200)]
Mention the `find-library-name' changes

8 years ago* lisp/isearch.el (isearch-forward-symbol-at-point): Add isearch-push-state.
Juri Linkov [Sun, 1 May 2016 20:30:51 +0000 (23:30 +0300)]
* lisp/isearch.el (isearch-forward-symbol-at-point): Add isearch-push-state.

(Bug#23410)

8 years agoFix text in menu in minor-mode-menu-from-indicator
Lars Ingebrigtsen [Sun, 1 May 2016 19:36:39 +0000 (21:36 +0200)]
Fix text in menu in minor-mode-menu-from-indicator

* lisp/mouse.el (minor-mode-menu-from-indicator): Don't
capitalize "Off" in "Turn Off" (bug#11028).

8 years agogitmerge: Add cherry pick to gitmerge-skip-regexp
David Engster [Sun, 1 May 2016 19:05:18 +0000 (21:05 +0200)]
gitmerge: Add cherry pick to gitmerge-skip-regexp

* gitmerge.el (gitmerge-skip-regexp): Add "cherry picked from commit",
  which is the string appended by 'git cherry-pick -x'.

8 years agoAllow `global-set-key' to bind keys under the `M-o' map
Lars Ingebrigtsen [Sun, 1 May 2016 19:15:06 +0000 (21:15 +0200)]
Allow `global-set-key' to bind keys under the `M-o' map

* lisp/subr.el (global-set-key): Allow binding keys under the
`M-o' map (bug#9730).

8 years agoAdd `size-indication-mode' to the menu on `mouse-1' "Top"
Lars Ingebrigtsen [Sun, 1 May 2016 17:42:35 +0000 (19:42 +0200)]
Add `size-indication-mode' to the menu on `mouse-1' "Top"

* lisp/bindings.el (mode-line-column-line-number-mode-map):
Add `size-indication-mode' to the menu (bug#5727).

8 years agotramp.texi: Revert last change due to backward compatibility
Michael Albinus [Sun, 1 May 2016 08:14:05 +0000 (10:14 +0200)]
tramp.texi: Revert last change due to backward compatibility

(cherry picked from commit 910f9a0a936aacbffe9b9b790d7f698dfd287aac)

8 years agocua-prefix-override-inhibit-delay doc fix
Lars Ingebrigtsen [Sat, 30 Apr 2016 23:53:58 +0000 (01:53 +0200)]
cua-prefix-override-inhibit-delay doc fix

* lisp/emulation/cua-base.el
(cua-prefix-override-inhibit-delay): Typo fix in doc string
(bug#23401).

(cherry picked from commit 2b4c099822811ede787fc6e575bfbb17b3cc0681)

8 years agoglobal-eldoc-mode doc fix
Lars Ingebrigtsen [Sat, 30 Apr 2016 23:08:23 +0000 (01:08 +0200)]
global-eldoc-mode doc fix

* lisp/emacs-lisp/eldoc.el (global-eldoc-mode): Be more
specific about what "applicable" means (bug#23071).

(cherry picked from commit 25e95b5dd8cd92e03788e589bf99a4b399f03114)

8 years agonormal-top-level-add-subdirs-to-load-path doc fix
Lars Ingebrigtsen [Sat, 30 Apr 2016 22:26:00 +0000 (00:26 +0200)]
normal-top-level-add-subdirs-to-load-path doc fix

* lisp/startup.el (normal-top-level-add-subdirs-to-load-path):
Doc fix (bug#21962).

(cherry picked from commit 28aaa6d20586e3330a23b017a65e56dd6461c003)

8 years agoisearch-search-fun-function doc tweak
Lars Ingebrigtsen [Sat, 30 Apr 2016 22:16:42 +0000 (00:16 +0200)]
isearch-search-fun-function doc tweak

* lisp/isearch.el (isearch-search-fun-function): Mention what
the STRING parameter is (bug#21552).

(cherry picked from commit cafc2a5940cdc523cfea6dcf1cf540f48367c62a)

8 years agoFill some imenu--index-alist doc lines
Lars Ingebrigtsen [Sat, 30 Apr 2016 22:10:57 +0000 (00:10 +0200)]
Fill some imenu--index-alist doc lines

* lisp/imenu.el (imenu--index-alist): Fill some doc lines (bug#21269).

(cherry picked from commit 4b7bb8f596550628eaa83b82c0f7eabe59a84964)

8 years agoFmarker_position doc string clarification
Lars Ingebrigtsen [Sat, 30 Apr 2016 22:03:15 +0000 (00:03 +0200)]
Fmarker_position doc string clarification

* src/marker.c (Fmarker_position): Clarify the doc string
(bug#21231).

(cherry picked from commit eeac7c57273cec3f9408b18392dd2bafe3be4450)