5965d46a1f
* BNF mod for `\^` `\$` et al. * go.mod go.sum * Update DSL-build instructions * tools/build-dsl artifacts * Unit-test updates * fix build error * unit-test files
1.1 KiB
This directory contains a single source file, mlr.bnf, which is the
lexical/semantic grammar file for the Miller put/filter DSL
(domain-specific language) using the GOCC framework. (In a classical Lex/Yacc
framework, there would be separate mlr.l and mlr.y files; using GOCC, there
is a single mlr.bnf file.)
All subdirectories of internal/pkg/parsing/ are autogen code created by GOCC's
processing of mlr.bnf. They are nonetheless committed to source control,
since running GOCC takes quite a bit longer than the go build does, and the
BNF file doesn't often change. (BNF is for Backus-Naur Form which is the
phrasing of the grammar file that GOCC support.) See the top-level miller/go
build scripts for how to rerun GOCC. As of this writing, it's
gocc -o internal/pkg/parsing internal/pkg/parsing/mlr.bnf
as invoked from the repo base directory -- however you should instead use
tools/build-dsl
Making changes to mlr.bnf requires several minutes to re-run GOCC. For
experimental changes, please see the
experiments directory.