GNU bug report logs - #32389
Default behaviour of xref-find-references is inconsistent with the documentation

Previous Next

Package: emacs;

Reported by: Shitikanth <shitikanth1 <at> gmail.com>

Date: Tue, 7 Aug 2018 15:18:02 UTC

Severity: normal

Done: Eli Zaretskii <eliz <at> gnu.org>

Bug is archived. No further changes may be made.

Full log

View this message in rfc822 format

From: Shitikanth <shitikanth1 <at> gmail.com>
To: 32389 <at> debbugs.gnu.org
Subject: bug#32389: Default behaviour of xref-find-references is inconsistent with the documentation
Date: Tue, 7 Aug 2018 14:25:46 +0530

[Message part 1 (text/plain, inline)]
Related to bug#29619.

The function documentation of xref-find-references says:

    Find references to the identifier at point. With prefix argument,
prompt for
    the identifier.

The Emacs manual (Node: Identifier Search) says:

    ‘M-?’ finds all the references for the identifier at point. If there’s
no
    identifier at point, or when invoked with a prefix argument, the command
    prompts for the identifier, with completion.


Inconsistent to both, the actual behaviour of xref-find-references and M-?
is to
*always* prompt for the identifier from the user (irrespective of whether
it is
invoked with or without the prefix-arg). The only way to get the documented
behaviour is by customizing xref-prompt-for-identifier, and there is no way
of
discovering this without reading the source code.

[Message part 2 (text/html, inline)]
This bug report was last modified 6 years and 287 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.