The Bars Specification¶

Bars is the template language kBars implements. This specification is the normative definition of the language: a conforming workalike is one that satisfies this document, as verified by the conformance suite.

Latest version¶

0.1.0

All versions¶

Every released version's pages stay published — none are pruned from the site as new versions ship.

Versioning policy¶

The specification is versioned identically to the conformance suite: the version under development is always the current suiteVersion. Within a version directory, editorial (non-normative) corrections — typos, clarifications, broken links — may be made in place. Any normative change requires a new suite version, since a normative change needs new or changed fixtures to prove it. On a suite version bump, the prior version's specification directory is frozen and a new one is opened from a copy of it.

Relationship to the conformance suite and the reference grammar¶

See the current version's overview for the precedence rule governing how this specification, the conformance suite, and the reference ANTLR grammar relate.

Distribution¶

Each version's pages are also bundled into the conformance suite's ZIP under spec/<version>/, so a downloaded, pinned suite version is a fully self-contained artifact — fixtures, schemas, and the specification that governs them, all at once.