Re: master 1e3b0f2: Improve doc strings of project.el

[Dmitry Gutov]

On 19.06.2020 17:07, Eli Zaretskii wrote:
> > If you look at bug#41868, it mentions VC-Dir and Dired buffers. Perhaps
> > Philip also has other examples.
> So will something like the below do the job?
>
>      Switch to another buffer related to the current project.
>    A buffer is related to a project if its `default-directory'
>    is inside the directory hierarchy of the project's root.

Sounds good. Except some projects can be inside one another, too.

> Btw, AFAIU this command can prompt for a project's root, but the doc
> string doesn't mention that important fact.

That is the case for all of the commands in there.

> > It also cleans up some "invisible" buffers created to service the files
> > in the project, such as ones created by Flymake, etc.
> By "it" what do you mean here? you don't mean
> project-switch-to-buffer, do you?  And if so, how is that related to
> the issue at hand, which is the doc string of that function?

Sorry, got my wires crossed: this was about project-kill-buffers.

But the rest of the discussion should apply to project-switch-buffer 
just as well.

BTW, I imagine that the current project-kill-buffers docstring should 
seem ambiguous to you as well.