[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
RE: The poor state of documentation of pcase like things.
From: |
Drew Adams |
Subject: |
RE: The poor state of documentation of pcase like things. |
Date: |
Sun, 3 Jan 2016 22:19:18 -0800 (PST) |
> I'll try to take care of that stuff.
>
> After all, despite of the tone on both sides, I think we came to
> some conclusions:
>
> - The pcase docs must be updated, esp. wrt quoting/ backquote, and
> missing stuff (e.g. first matching branches' body is executed,
> remaining branches are ignored).
>
> - We should not use it in cases where a different thing (esp. cl-case)
> exactly fits. "Promoters" should use it sparse in contributions and
> only in cases where it improves readability or makes the case
> distinction clearer (given the reader read the documentation). Others
> should accept that some people find it handy and will use it in such
> cases in their contributions.
>
> - Occurrences in the sources must be revised.
>
> The only substantial difference, I think, was whether the design and
> concept of pcase is useful. I think it's ok when people have different
> preferences here (like with `loop', which I personally avoid btw).
>
> Thanks everyone, Michael.
A very constructive contribution to the discussion, IMO.
Thanks for taking a stab at the doc improvement. That will be
a great help, including in terms of guiding our use of `pcase'.
And thanks for the consensus summary - sounds good to me.
- Re: The poor state of documentation of pcase like things., (continued)
- RE: The poor state of documentation of pcase like things., Drew Adams, 2016/01/02
- Re: The poor state of documentation of pcase like things., Eli Zaretskii, 2016/01/02
- Message not available
- Message not available
- Message not available
- Message not available
- Message not available
- Message not available
- Message not available
- Message not available
- Message not available
- Re: The poor state of documentation of pcase like things., David Kastrup, 2016/01/03
- Re: The poor state of documentation of pcase like things., Dmitry Gutov, 2016/01/03
- Re: The poor state of documentation of pcase like things., David Kastrup, 2016/01/03
- Re: The poor state of documentation of pcase like things., Dmitry Gutov, 2016/01/03
- Re: The poor state of documentation of pcase like things., David Kastrup, 2016/01/03
- Re: The poor state of documentation of pcase like things., Michael Heerdegen, 2016/01/03
- RE: The poor state of documentation of pcase like things.,
Drew Adams <=
- Re: The poor state of documentation of pcase like things., John Wiegley, 2016/01/04
- Re: The poor state of documentation of pcase like things., Eli Zaretskii, 2016/01/04
- Re: The poor state of documentation of pcase like things., Michael Heerdegen, 2016/01/03
- Re: The poor state of documentation of pcase like things., Richard Copley, 2016/01/01
- RE: The poor state of documentation of pcase like things., Drew Adams, 2016/01/01
RE: The poor state of documentation of pcase like things., Drew Adams, 2016/01/01