[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: The poor state of documentation of pcase like things.

From: Phillip Lord
Subject: Re: The poor state of documentation of pcase like things.
Date: Sun, 20 Dec 2015 22:54:39 +0000
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/24.5 (gnu/linux)

Eli Zaretskii <address@hidden> writes:
>> Simple change would be from:
>> Conditionals
>> * Pattern matching case statement::  How to use @code{pcase}.
>> to
>> Pattern Matching
>> * Conditional::  How to use @code{pcase}

> The last line can't be done, unless the node names are changed as
> well.  Right now the pcase description is in the child node of
> "Conditionals" whose name is "Pattern matching case statement".
> Also, I think having 2 nodes named "Conditionals" and "Conditional"
> will be too confusing.

Agreed. Hostage to fortune, if another pattern matching conditional is

"Pattern Matching" and "pcase" would work.

>> Pattern Matching
>> (this would contain a generalised introduction and tutorial, based
>> around pcase)
>> * List Clauses::            Destructuring Lists
>> * Predicates::              Matching with predicate functions
>> * Booleans::                and and or
>> * Guards::                  I don't quite understand guards
>> * Conditionals::            pcase
>> * Binding::                 pcase-let 
>> * Lambda::                  pcase-lambda
> These would be too short to justify a separate node, IMO.

They might be, yes. I'd write it and see. With examples for each, they
might get long enough.

>> * New Patterns:: pcase-macro, with description of seq and map support.
> We avoid using "new" in manuals, because they are that only for one
> release.

Sorry, poor working "Creating New Patterns" -- or perhaps "extending
pattern matching".


reply via email to

[Prev in Thread] Current Thread [Next in Thread]