[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Opaque objects and Emacs documentation
From: |
Stefan Monnier |
Subject: |
Re: Opaque objects and Emacs documentation |
Date: |
Fri, 17 Jul 2020 12:48:08 -0400 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) |
> Basically, you are saying that in your opinion this is as it should
> be, and cannot be helped.
>
> Which I think is against long-time Emacs tradition for documenting its
> interfaces, and by that facilitating extensibility. It is IMO wrong
> to fill Emacs application levels with opaque objects which cannot be
> usefully described; they should be a rare exception, but definitely
> not the rule.
I believe in this specific case, the issue is that the shape can and
will change and not only over time. The only thing defined is an
interface and any code which relies on more than this interface
(e.g. a function which relies on completion-tables being lists of
strings) will break sooner or later.
Of course, that doesn't prevent the doc from giving *examples* to show
the intended behavior.
Stefan
- Re: Opaque objects and Emacs documentation, (continued)
- Re: Opaque objects and Emacs documentation, Gregory Heytings, 2020/07/17
- RE: Opaque objects and Emacs documentation, Drew Adams, 2020/07/17
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/17
- Re: Opaque objects and Emacs documentation, Gregory Heytings, 2020/07/17
- Re: Opaque objects and Emacs documentation, Yuan Fu, 2020/07/17
- RE: Opaque objects and Emacs documentation, Drew Adams, 2020/07/17
- Re: Opaque objects and Emacs documentation, Richard Stallman, 2020/07/17
- RE: Opaque objects and Emacs documentation, Drew Adams, 2020/07/17
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/17
- RE: Opaque objects and Emacs documentation, Drew Adams, 2020/07/17
- Re: Opaque objects and Emacs documentation,
Stefan Monnier <=
- Re: Opaque objects and Emacs documentation, Andy Moreton, 2020/07/23
- Re: Opaque objects and Emacs documentation, Andy Moreton, 2020/07/23
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/24
- Re: Opaque objects and Emacs documentation, Andy Moreton, 2020/07/24
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/24
- Re: Opaque objects and Emacs documentation, Dmitry Gutov, 2020/07/23
- Re: Opaque objects and Emacs documentation, Andy Moreton, 2020/07/23
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/24
- Re: Opaque objects and Emacs documentation, Andy Moreton, 2020/07/25
- Re: Opaque objects and Emacs documentation, Eli Zaretskii, 2020/07/25