Re: [Jsonpath] I-Regexp railroad diagrams

Carsten Bormann <cabo@tzi.org> Thu, 28 April 2022 21:51 UTC

Return-Path: <cabo@tzi.org>
X-Original-To: jsonpath@ietfa.amsl.com
Delivered-To: jsonpath@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 76D31C15E40B for <jsonpath@ietfa.amsl.com>; Thu, 28 Apr 2022 14:51:56 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.898
X-Spam-Level:
X-Spam-Status: No, score=-1.898 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id SNzNT3gyV-7m for <jsonpath@ietfa.amsl.com>; Thu, 28 Apr 2022 14:51:54 -0700 (PDT)
Received: from gabriel-smtp.zfn.uni-bremen.de (gabriel-smtp.zfn.uni-bremen.de [134.102.50.15]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 17477C157B35 for <jsonpath@ietf.org>; Thu, 28 Apr 2022 14:51:52 -0700 (PDT)
Received: from smtpclient.apple (p5089ad4f.dip0.t-ipconnect.de [80.137.173.79]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by gabriel-smtp.zfn.uni-bremen.de (Postfix) with ESMTPSA id 4Kq8Td6rSXzDCbs; Thu, 28 Apr 2022 23:51:49 +0200 (CEST)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.80.82.1.1\))
From: Carsten Bormann <cabo@tzi.org>
In-Reply-To: <CAHBU6itK5ziu6+j2vtxmPmgbFfeJi6Cmh5HoX4_ewW=7nCu+QA@mail.gmail.com>
Date: Thu, 28 Apr 2022 23:51:49 +0200
Cc: jsonpath@ietf.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <3F8374E6-C0A7-4768-800E-09457291CCC5@tzi.org>
References: <CAHBU6itK5ziu6+j2vtxmPmgbFfeJi6Cmh5HoX4_ewW=7nCu+QA@mail.gmail.com>
To: Tim Bray <tbray@textuality.com>
X-Mailer: Apple Mail (2.3696.80.82.1.1)
Archived-At: <https://mailarchive.ietf.org/arch/msg/jsonpath/AKNgpGpng1F8cSAECZjcwZd2cEg>
Subject: Re: [Jsonpath] I-Regexp railroad diagrams
X-BeenThere: jsonpath@ietf.org
X-Mailman-Version: 2.1.34
Precedence: list
List-Id: A summary description of the list to be included in the table on this page <jsonpath.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/jsonpath>, <mailto:jsonpath-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/jsonpath/>
List-Post: <mailto:jsonpath@ietf.org>
List-Help: <mailto:jsonpath-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/jsonpath>, <mailto:jsonpath-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 28 Apr 2022 21:51:56 -0000

On 28. Apr 2022, at 20:50, Tim Bray <tbray@textuality.com> wrote:
> 
> Someone called @thingskatedid over on Twitter turned our ABNF into railroad diagrams: https://twitter.com/thingskatedid/status/1519749886073184257
> 
> Quite pretty!

Nice!

I’m using Kate’s railroad diagram generator in draft-ietf-core-href, but this is even way better.
The diagrams are directly supported in kramdown-rfc (both for txt and html).
The other reason to have “support” is to make them less pretty in order to stay within the child’s playpen that RFC 7996 is.

These railroad diagrams are nice until it comes to rules such as NormalChar or Letters/Punctuation etc.
But maybe we can simply leave some rules out.

I’ll add an appendix...

Grüße, Carsten