[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Replace trivial pcase occurrences in the Emacs sources
From: |
Alan Mackenzie |
Subject: |
Re: Replace trivial pcase occurrences in the Emacs sources |
Date: |
Mon, 29 Oct 2018 13:01:32 +0000 |
User-agent: |
Mutt/1.10.1 (2018-07-13) |
Hello, Stefan.
On Sun, Oct 28, 2018 at 17:44:57 -0400, Stefan Monnier wrote:
> > pcase-lambda, pcase-let, pcase-let*, and pcase-dolist still have no
> > meaningful documentation,
> Not sure what kind of documentation would be more meaningful, sorry.
Doc strings which specify fully the arguments to these macros, including
their semantics, and say what the macros do. The current doc strings
(at least some of them) for these macros don't do this.
Entries in the elisp manual. These don't exist at all. (Or, if they
do, they don't have index entries.)
> Do you happen to have concrete questions about them which aren't answered
> by their docstrings?
I've had such questions in the past, and had to answer them by time
consuming guessing, reading the source of pcase-..., and
experimentation. Adequate documentation would have saved me a great
deal of time, frustration, and uncertainty.
[ .... ]
> Stefan
--
Alan Mackenzie (Nuremberg, Germany).
- Re: pcase pattern syntax (was: Replace trivial pcase occurrences in the Emacs sources), (continued)
- Re: pcase pattern syntax (was: Replace trivial pcase occurrences in the Emacs sources), Joost Kremers, 2018/10/26
- Re: Replace trivial pcase occurrences in the Emacs sources, João Távora, 2018/10/24
- Re: Replace trivial pcase occurrences in the Emacs sources, Stefan Monnier, 2018/10/24
- Re: Replace trivial pcase occurrences in the Emacs sources, Richard Stallman, 2018/10/24
- Re: Replace trivial pcase occurrences in the Emacs sources, Stefan Monnier, 2018/10/25
- Re: Replace trivial pcase occurrences in the Emacs sources, Andy Moreton, 2018/10/25
- Re: Replace trivial pcase occurrences in the Emacs sources, Stefan Monnier, 2018/10/26
- Re: Replace trivial pcase occurrences in the Emacs sources, Garreau\, Alexandre, 2018/10/26
- Re: Replace trivial pcase occurrences in the Emacs sources, Andy Moreton, 2018/10/27
- Re: Replace trivial pcase occurrences in the Emacs sources, Stefan Monnier, 2018/10/28
- Re: Replace trivial pcase occurrences in the Emacs sources,
Alan Mackenzie <=
- Re: Replace trivial pcase occurrences in the Emacs sources, Stefan Monnier, 2018/10/29
- Re: Replace trivial pcase occurrences in the Emacs sources, Alan Mackenzie, 2018/10/29
- Re: Replace trivial pcase occurrences in the Emacs sources, Stefan Monnier, 2018/10/29
- Re: Replace trivial pcase occurrences in the Emacs sources, Michael Heerdegen, 2018/10/29
- Re: Replace trivial pcase occurrences in the Emacs sources, Eric Abrahamsen, 2018/10/29
- Re: Replace trivial pcase occurrences in the Emacs sources, Eric Abrahamsen, 2018/10/29
- `pcase'/`case' implementation [Was: Re: Replace trivial pcase occurrences in the Emacs sources], Garreau\, Alexandre, 2018/10/29
- Re: Replace trivial pcase occurrences in the Emacs sources, Stefan Monnier, 2018/10/30
- Re: Replace trivial pcase occurrences in the Emacs sources, Eric Abrahamsen, 2018/10/30
- Re: Replace trivial pcase occurrences in the Emacs sources, Garreau\, Alexandre, 2018/10/31