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

[Eli Zaretskii]

> Cc: emacs-devel@gnu.org, philip@warpmail.net
> From: Dmitry Gutov <dgutov@yandex.ru>
> Date: Fri, 19 Jun 2020 17:23:36 +0300
> 
> >      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.

Does that invalidate what the text above says?

> > 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.

That just means they all should mention this.

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

Not really, no.  It's pretty self-explanatory, especially since the
usual situation where the command will be invoked is when I cease
working on a project.