GNU bug report logs - #30920
doc: Inconsistent parentheses in "(guile) sxml-match"

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Ludovic Courtès <ludo <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#30920: closed (doc: Inconsistent parentheses in "(guile)
 sxml-match")
Date: Wed, 25 Mar 2020 21:55:01 +0000

[Message part 1 (text/plain, inline)]

Your message dated Wed, 25 Mar 2020 22:54:15 +0100
with message-id <871rpggkxk.fsf <at> gnu.org>
and subject line Re: bug#30920: doc: Inconsistent parentheses in "(guile) sxml-match"
has caused the debbugs.gnu.org bug report #30920,
regarding doc: Inconsistent parentheses in "(guile) sxml-match"
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
30920: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=30920
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Arun Isaac <arunisaac <at> systemreboot.net>
To: bug-guile <at> gnu.org
Subject: doc: Inconsistent parentheses in "(guile) sxml-match"
Date: Sat, 24 Mar 2018 10:44:46 +0530

All examples in "(guile) sxml-match" use square parentheses around each
match clause. However, in the subsection "Guards in Patterns" alone, the
example has round parentheses. I think it would be nice to use round
parentheses consistently in all examples so that sxml-match and match
have the same syntax. But, I have no strong opinions. If you can
recommend which way to go, I can provide a patch for the same.

[Message part 3 (message/rfc822, inline)]

From: Ludovic Courtès <ludo <at> gnu.org>
To: Arun Isaac <arunisaac <at> systemreboot.net>
Cc: 30920-done <at> debbugs.gnu.org
Subject: Re: bug#30920: doc: Inconsistent parentheses in "(guile) sxml-match"
Date: Wed, 25 Mar 2020 22:54:15 +0100

Hi Arun,

Arun Isaac <arunisaac <at> systemreboot.net> skribis:

> While working on this patch, I found that two of the code snippets don't
> work. They work neither with square brackets nor with round
> brackets. The two snippets are
>
> * The first snippet in the "Matching the Unmatched Attributes" subsection
>
> @lisp
> (sxml-match '(a (@@ (z 1) (y 2) (x 3)) 4 5 6)
>   ((a (@@ (y ,www) . ,qqq) ,t ,u ,v)
>    (list www qqq t u v)))
> @end lisp
>
> * The snippet in the "Default Values in Attribute Patterns" subsection
>
> @lisp
> (sxml-match '(e 3 4 5)
>   ((e (@@ (z (,d 1))) ,a ,b ,c) (list d a b c)))
> @end lisp
>
> These snippets fail to evaluate. Could you check?

I can confirm.  Would be worth fixing.

> From 6e31e3fe1fd2b537d4a02dbcfccbb03e0d20e804 Mon Sep 17 00:00:00 2001
> From: Arun Isaac <arunisaac <at> systemreboot.net>
> Date: Tue, 24 Mar 2020 01:45:32 +0530
> Subject: [PATCH] doc: Replace square brackets with round brackets.
>
> * doc/ref/sxml-match.texi: Replace all square brackets with round
> brackets in order to be consistent with the rest of the documentation.

Applied, thanks!

Ludo’.

Previous Next

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