Re: pcase docs

[Alan Mackenzie]

Hello, Eli.

On Sat, Jan 23, 2016 at 01:43:07PM +0200, Eli Zaretskii wrote:

> (You can now understand why the documentation of 'pcase-defmacro' I
> added is rather laconic and in some sense unsatisfactory.)

> As an aside, when I look at such doc strings, I always become
> frustrated, because I must be extremely stupid to ask all these
> questions, when no one else evidently cares, which must mean they all
> understand this stuff, and only I alone don't, right?

No, you're not stupid, and you're not the only person who cares about
"economical" doc strings.  That was one of the reasons I raised a bug
about all the pcase stuff documentation a few weeks ago, and I think I
included things like the `pcase-defmacro' doc strings in that bug.

I admit my reaction to such things is usually to throw up my hands in
despair, then say to myself "I don't need this anyway" and pass on to
the next problem.  I suspect I'm not alone in this.  So a big thank-you
from me to you and Michael H., as a representative of all the people
similarly clueless about such things, that you're actually getting down
and sorting these things out.

> Thanks.

-- 
Alan Mackenzie (Nuremberg, Germany).