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

Previous Next

Full log

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 55742 <at> debbugs.gnu.org, salutis <at> me.com
Subject: Re: bug#55742: 29.0.50; Confusing "pcase" documentation on the web
Date: Wed, 01 Jun 2022 18:52:30 +0300

> Cc: 55742 <at> debbugs.gnu.org
> From: Lars Ingebrigtsen <larsi <at> gnus.org>
> 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?

Like this:

  @item _ <at> r{ (underscore)}

Previous Next

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