[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Update of pcase docs for the elisp manual
From: |
Eli Zaretskii |
Subject: |
Re: Update of pcase docs for the elisp manual |
Date: |
Fri, 29 Jan 2016 17:37:13 +0200 |
> From: Andy Moreton <address@hidden>
> Date: Fri, 29 Jan 2016 15:14:17 +0000
>
> Fair enough. Please consider starting a new paragraph though:
>
> "The ‘cond’ form lets you choose between alternatives using predicate
> conditions that compare values of expressions against specific values
> known and written in advance. However, sometimes it is useful to select
> alternatives based on more general conditions that distinguish between
> broad classes of values.
>
> The ‘pcase’ macro allows you to choose between alternatives based on
> matching the value of an expression against a series of patterns. A
> pattern can be a literal value (for comparisons to literal values you’d
> use ‘cond’), or it can be a more general description of the expected
> structure of the expression’s value."
Fine with me, thanks. Feel free to commit.
> >> However the doc strings are inconsistent with the manual:
> >> pcase: (PATTERN CODE...)
> >> cond: (CONDITION BODY...)
> >>
> >> It would be better to use consistent terms.
> >
> > Blame those who wrote the doc strings ;-)
>
> I sought improvement, not blame :-)
Feel free to improve the doc strings in that direction, and thanks.
- Re: Update of pcase docs for the elisp manual, (continued)
- Re: Update of pcase docs for the elisp manual, John Wiegley, 2016/01/26
- Re: Update of pcase docs for the elisp manual, Stefan Monnier, 2016/01/26
- Re: Update of pcase docs for the elisp manual, Eli Zaretskii, 2016/01/26
- Re: Update of pcase docs for the elisp manual, John Wiegley, 2016/01/26
- Re: Update of pcase docs for the elisp manual, Eli Zaretskii, 2016/01/26
- Re: Update of pcase docs for the elisp manual, John Wiegley, 2016/01/28
- Re: Update of pcase docs for the elisp manual, Eli Zaretskii, 2016/01/29
- Re: Update of pcase docs for the elisp manual, Andy Moreton, 2016/01/29
- Re: Update of pcase docs for the elisp manual, Eli Zaretskii, 2016/01/29
- Re: Update of pcase docs for the elisp manual, Andy Moreton, 2016/01/29
- Re: Update of pcase docs for the elisp manual,
Eli Zaretskii <=
- Re: Update of pcase docs for the elisp manual, Andy Moreton, 2016/01/26
- Re: Update of pcase docs for the elisp manual, Eli Zaretskii, 2016/01/26