GNU bug report logs - #31311
27.0; doc of `pcase'

Previous Next

Full log

View this message in rfc822 format

From: Noam Postavsky <npostavs <at> gmail.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: Michael Heerdegen <michael_heerdegen <at> web.de>, drew.adams <at> oracle.com, 31311 <at> debbugs.gnu.org
Subject: bug#31311: 27.0; doc of `pcase'
Date: Mon, 30 Apr 2018 07:20:23 -0400

Eli Zaretskii <eliz <at> gnu.org> writes:

>> From: Michael Heerdegen <michael_heerdegen <at> web.de>
>> Cc: drew.adams <at> oracle.com,  31311 <at> debbugs.gnu.org
>> Date: Sun, 29 Apr 2018 22:05:55 +0200
>> 
>> Eli Zaretskii <eliz <at> gnu.org> writes:
>> 
>> > There's nothing special about this feature that should present
>> > conceptual problems for documenting it well, any more than any other
>> > advanced feature of which we have dozens in the ELisp manual.
>> 
>> From the beginning people were divided about the usefulness and
>> conception of the thing, and people discussed exceptionally emotionally
>> and destructively.
>
> Irrelevant.  We are talking about documentation, not about the feature
> itself.  The concept of how such complex features should be documented
> is well established in Emacs, and we have a wealth of examples in the
> ELisp manual of how it should be and is done.

It's relevant if potential contributors turn away/tune out/ignore
the whole thing due to the unpleasant discussion.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.