GNU bug report logs - #76555
30.1; PEG's doc needs some correction

Previous Next

Package: emacs;

Reported by: "Yue Yi" <include_yy <at> qq.com>

Date: Tue, 25 Feb 2025 14:55:02 UTC

Severity: minor

Found in version 30.1

Done: Stefan Monnier <monnier <at> iro.umontreal.ca>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Stefan Monnier <monnier <at> iro.umontreal.ca>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#76555: closed (30.1; PEG's doc needs some correction)
Date: Thu, 27 Mar 2025 01:07:03 +0000
[Message part 1 (text/plain, inline)]
Your message dated Wed, 26 Mar 2025 21:06:31 -0400
with message-id <jwvr02jz3m1.fsf-monnier+emacs <at> gnu.org>
and subject line Re: bug#76555: 30.1; PEG's doc needs some correction
has caused the debbugs.gnu.org bug report #76555,
regarding 30.1; PEG's doc needs some correction
to be marked as done.

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


-- 
76555: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=76555
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
From: "Yue Yi" <include_yy <at> qq.com>
To: "bug-gnu-emacs" <bug-gnu-emacs <at> gnu.org>
Subject: 30.1; PEG's doc needs some correction
Date: Tue, 25 Feb 2025 22:52:22 +0800
[Message part 3 (text/plain, inline)]
Hello Emacs, As we know, Emacs 30 introduced a PEG implementation, peg.el. I found that the following code doesn't work properly when reading the PEG documentation with folks: -------------- code from lispref/peg.texi ------------------------- (define-peg-rule digit ()   [0-9]) (define-peg-ruleset number-grammar         '((number sign digit (* digit))           digit  ;; A reference to the definition above.           (sign (or "+" "-" "")))) ------------------------------------------------------------------- We noticed that the correct usage of this macro is provided in peg.el. --------------code from peg.el ------------------------------------ ;;;; Named rulesets: ;; ;; You can define a set of rules for later use with: ;; ;;     (define-peg-ruleset myrules ;;       (sign  () (or "+" "-" "")) ;;       (digit () [0-9]) ;;       (nat   () digit (* digit)) ;;       (int   () sign digit (* digit)) ;;       (float () int "." nat)) ------------------------------------------------------------------- Perhaps we can correct the errors in the documentation through a simple replacement.  Regards, Yue Yi
[Message part 4 (text/html, inline)]
[Message part 5 (message/rfc822, inline)]
From: Stefan Monnier <monnier <at> iro.umontreal.ca>
To: "Yue Yi" <include_yy <at> qq.com>
Cc: Eric Abrahamsen <eric <at> ericabrahamsen.net>,
 76555 <76555-done <at> debbugs.gnu.org>, Stefan Kangas <stefankangas <at> gmail.com>
Subject: Re: bug#76555: 30.1; PEG's doc needs some correction
Date: Wed, 26 Mar 2025 21:06:31 -0400
> Thanks, three commits :p

And that's because I caught a first problem before the first push!
Otherwise it would have been 4 commits!  <eye-roll>
I really outdid myself.


        Stefan



This bug report was last modified 138 days ago.

Previous Next


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