[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of
From: |
Eli Zaretskii |
Subject: |
Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package |
Date: |
Fri, 22 Jan 2016 10:21:24 +0200 |
> From: Stephen Leake <address@hidden>
> Cc: Eli Zaretskii <address@hidden>, address@hidden
> Date: Fri, 22 Jan 2016 01:40:04 -0600
>
> Dmitry Gutov <address@hidden> writes:
>
> > On 01/21/2016 10:19 PM, Stephen Leake wrote:
> >
> >> xref-find-apropos
> >>
> >> This is just a search, not relying on any "cross reference"
> >> information.
> >>
> >> project-find-* provides the same functionality, so xref-find-apropos
> >> can be removed (assuming every xref backend provides a project
> >> backend).
> >
> > No, "apropos" lists the *definitions* matching a regexp. You won't get
> > that by simply using regexp-search.
>
> The doc string says:
>
> Find all meaningful symbols that match PATTERN.
> The argument has the same meaning as in ‘apropos’.
The doc string "needs work"™. Welcome to the issue of doc strings of
quite a few commands introduced in Emacs 25. Feel free to augment,
expand, improve, or even rewrite any of them, based on what the code
actually does. Thanks in advance.
> I read that as "all occurances of the regexp"; I don't know what
> "meaningful" is supposed to mean here.
>
> If it is supposed to find only definitions, the doc string should say
> so:
>
> Find the definitions of all symbols that match PATTERN.
> PATTERN has the same meaning as in `apropos'.
The manual says:
The command `C-M-.' (`xref-find-apropos') finds the definitions of
one or more identifiers that match a specified regular expression. It
is just like `M-.' except that it does regexp matching of identifiers
instead of matching symbol names as fixed strings.
> However, the etags implementation uses re-search-forward to find PATTERN
> in the tags files; that won't handle word lists as `apropos' does. So
> does that need to be fixed, or should we change the doc string further
> to say:
>
> Find the definitions of all symbols that match PATTERN (a regexp).
Good question.
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, (continued)
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Dmitry Gutov, 2016/01/21
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Eli Zaretskii, 2016/01/21
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Dmitry Gutov, 2016/01/21
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Eli Zaretskii, 2016/01/21
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Dmitry Gutov, 2016/01/21
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Eli Zaretskii, 2016/01/21
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Dmitry Gutov, 2016/01/21
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Stephen Leake, 2016/01/21
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Dmitry Gutov, 2016/01/21
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Stephen Leake, 2016/01/22
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package,
Eli Zaretskii <=
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Dmitry Gutov, 2016/01/22
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Eli Zaretskii, 2016/01/22
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Dmitry Gutov, 2016/01/22
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, Eli Zaretskii, 2016/01/21
- Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, John Yates, 2016/01/22
Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package, John Wiegley, 2016/01/19