GNU bug report logs - #55742
29.0.50; Confusing "pcase" documentation on the web

Previous Next

Full log

Message #8 received at 55742 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Rudolf Adamkovič <salutis <at> me.com>
Cc: 55742 <at> debbugs.gnu.org
Subject: Re: bug#55742: 29.0.50; Confusing "pcase" documentation on the web
Date: Wed, 01 Jun 2022 15:39:55 +0200

Rudolf Adamkovič <salutis <at> me.com> writes:

> In "The pcase macro" documentation on the web
>
> https://www.gnu.org/software/emacs/manual/html_node/elisp/pcase-Macro.html
>
> has "_" on its own line, surrounded with whitespace.  It looks like a
> dash, and in a graphical browser, one has to select it to discover the
> mistake.  Could we add the word "underscore" somewhere next to it?

Yup.  The texi here is 

---
@table @code

@item _
Matches any @var{expval}.
This is also known as @dfn{don't care} or @dfn{wildcard}.
---

Anybody know whether we have a convention for adding notes/comments
after a @code item?

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

Previous Next

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