Re: [Emacs-diffs] emacs-25 f8208b6: Document the user-level features of the Xref package

[Dmitry Gutov]

On 01/11/2016 10:31 PM, Eli Zaretskii wrote:

> Doesn't sound right to me.  This is an important command, and a good
> addition to the Emacs features.  Leaving it out of the manual just
> because we cannot find a good place for it, or a good way to squeeze
> it into the chapter, sounds... unwise.

Also because it relies on a very scarcely documented facility, which 
comes with its own gotchas.

> ... xref-find-refrerences was the least of my problems when I worked
> on this.  It's just one command.

The "external tools" are only used in it, however. And my main complaint 
is against calling them "backends".

> What I needed is a coherent framework that would bring some order to
> this group of commands and features.

You might want to make the requirements more specific.

> Thanks, that's what I need.  If the concepts and the overall idea are
> good, the details will fall in place by themselves.

So, um, what exactly is missing in my previous response? I feel like 
I've answered all questions.

Aside from writing the "structure of the section", that is, because that 
sounds about as easy as rewriting the manual myself.