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

Previous Next

Full log

View this message in rfc822 format

From: Michael Heerdegen <michael_heerdegen <at> web.de>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: Eli Zaretskii <eliz <at> gnu.org>, 31311 <at> debbugs.gnu.org
Subject: bug#31311: 27.0; doc of `pcase'
Date: Sun, 29 Apr 2018 20:38:01 +0200

Drew Adams <drew.adams <at> oracle.com> writes:

> Perhaps you can at least remove the incomprehensible and
> seemingly unrelated text (I cited) that appears at the end
> of the doc string, as a start.

This is not unrelated: These are the docs for additional pcase patterns
defined elsewhere: pcase is extensible, and the pattern listing part in
the docstring is generated dynamically.  As a result of that conception
it may not read very fluently as a whole, but it's definitely nothing we
want to remove.

We clearly have some deficiencies, but the situation IMHO really is not
as horrible as Eli's sarcasm suggests.


Michael.

Previous Next

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