[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: master 1e3b0f2: Improve doc strings of project.el
From: |
Eli Zaretskii |
Subject: |
Re: master 1e3b0f2: Improve doc strings of project.el |
Date: |
Fri, 19 Jun 2020 17:28:53 +0300 |
> 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.
- Re: master 1e3b0f2: Improve doc strings of project.el, (continued)
- Re: master 1e3b0f2: Improve doc strings of project.el, Eli Zaretskii, 2020/06/19
- Re: master 1e3b0f2: Improve doc strings of project.el, Dmitry Gutov, 2020/06/19
- Re: master 1e3b0f2: Improve doc strings of project.el, Eli Zaretskii, 2020/06/20
- Re: master 1e3b0f2: Improve doc strings of project.el, Dmitry Gutov, 2020/06/20
- Re: master 1e3b0f2: Improve doc strings of project.el, Eli Zaretskii, 2020/06/20
- Re: master 1e3b0f2: Improve doc strings of project.el, Dmitry Gutov, 2020/06/20
- Re: master 1e3b0f2: Improve doc strings of project.el, Dmitry Gutov, 2020/06/19
- Re: master 1e3b0f2: Improve doc strings of project.el, Theodor Thornhill, 2020/06/19
- Re: master 1e3b0f2: Improve doc strings of project.el, Eli Zaretskii, 2020/06/19
- Re: master 1e3b0f2: Improve doc strings of project.el, Dmitry Gutov, 2020/06/19
- Re: master 1e3b0f2: Improve doc strings of project.el,
Eli Zaretskii <=