[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: master 0339325: ; * lisp/progmodes/project.el (project-current): Doc
From: |
Eli Zaretskii |
Subject: |
Re: master 0339325: ; * lisp/progmodes/project.el (project-current): Doc fix. |
Date: |
Mon, 13 Jul 2020 06:48:35 +0300 |
> From: Dmitry Gutov <dgutov@yandex.ru>
> Date: Sun, 12 Jul 2020 23:07:46 +0300
>
> On 12.07.2020 21:49, Eli Zaretskii wrote:
> > The \"transient\" project instance is a special kind of value
> > which denotes a project rooted in that directory and includes all
> > -files under it except for ones that match standard ignores.
> > +the files under the directory except for those that should be
> > +ignored (per `project-ignores').
>
> The more accurate way to say this
What isn't accurate in what I wrote? (The point being that 'standard
ignores" is something never mentioned in any other function or
variable in project.el, and so this term is unknown and confusing.)
> except for those that are ignored
> in the default 'project-ignores' implementation.
>
> But this is basically a tautology. If we wanted to describe transient's
> particular behavior we'd have to describe what it actually ignores (and
> it honors vc-directory-exclusion-list as well as
> grep-find-ignored-files). But that pretty clunky for one docstring.
Which is why I just mentioned the function which implements all that.
> So
> perhaps that description should move somewhere. Into the Commentary,
> maybe. Or directly to the cl-defgeneric's docstring, to which
> project-current's docstring would after all refer to as "the default
> `project-ignores' implementation".
You cannot usefully refer to the default implementation without saying
that this or that types of project use the default implementation,
which is IMO against your information encapsulation policies.
- Re: master 0339325: ; * lisp/progmodes/project.el (project-current): Doc fix., Dmitry Gutov, 2020/07/12
- Re: master 0339325: ; * lisp/progmodes/project.el (project-current): Doc fix.,
Eli Zaretskii <=
- Re: master 0339325: ; * lisp/progmodes/project.el (project-current): Doc fix., Dmitry Gutov, 2020/07/13
- Re: master 0339325: ; * lisp/progmodes/project.el (project-current): Doc fix., Eli Zaretskii, 2020/07/13
- Re: master 0339325: ; * lisp/progmodes/project.el (project-current): Doc fix., Dmitry Gutov, 2020/07/13
- Re: master 0339325: ; * lisp/progmodes/project.el (project-current): Doc fix., Dmitry Gutov, 2020/07/16
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/17
- Re: Opaque objects and Emacs documentation, tomas, 2020/07/17
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/17
- Re: Opaque objects and Emacs documentation, tomas, 2020/07/17
- Re: Opaque objects and Emacs documentation, Basil L. Contovounesios, 2020/07/17
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/17