skip to content
cint

specifications

The cint specification defines the cint language, the encodings of its values and records, its kernels and executors, its host interface, its tools and its toolchain. Each release publishes the specification in editions, and an edition does not change after the release that first publishes it.

Start with SPEC-00P.2, the overview: section 3 describes each document and section 4 gives reading orders for a learner, a C programmer, a Python user and an implementer. A reader learning the language needs only SPEC-04P.4.

current editions

Edition Title First released in
SPEC-00P.2 Overview cint v0.2.0
SPEC-01P.3 Canonical encodings and identity cint v0.2.3
SPEC-02P.2 Kernels and executors cint v0.2.3
SPEC-03P.3 The host interface: C and Python cint v0.2.4
SPEC-04P.4 The cint language cint v0.2.4
SPEC-06P.3 The cint tools cint v0.2.4
SPEC-09P.4 Toolchain and conformance cint v0.2.8
GLOSSARY-P.4 Glossary cint v0.2.4
REFERENCES-P.2 References cint v0.2.0

The numbers SPEC-05, SPEC-07 and SPEC-08 have no public edition.

how editions work

An edition is named SPEC-NNP.E: the document number NN, P for public and the edition number E. SPEC-04P.4 is the fourth edition of SPEC-04, the language. The glossary and the references follow the same scheme, as GLOSSARY-P.E and REFERENCES-P.E.

  • A released edition's text does not change. ERRATA.md lists any correction that changes no meaning (a typo, a broken link, a clearer sentence) as SPEC-04P.2 E1, and the edition keeps its number. A new edition beside the earlier one publishes any change of meaning.
  • Each minor release, such as 0.2.0, publishes an edition of every document. A patch release, such as 0.2.8, publishes the next edition only of a document whose rules or listed refusals it changes.
  • Each document counts its own editions, so SPEC-04P can be at edition 4 while SPEC-02P is at edition 2.
  • Each rule ends with its clause identifier, such as IM-106 or LS-17. An identifier stays with its rule when the rule moves to another section or document, and no rule reuses it. Section numbers belong to one edition. Every rule has an anchor named by its identifier and every section an anchor named by its title, so a link keeps working in each edition that keeps the rule or the section.
  • A diagnostic or a fault report may cite a rule as SPEC-04 LS-17, by document number and identifier. The current edition of that document holds the rule at the anchor #LS-17; where another document now states it, the cited document lists the identifier with a link to the edition and section that state it.
  • The rules of an edition are what the reference of its release runs. SPEC-09P.4 clause 12 lists the constructs that the other tools of that release refuse, with their diagnostic codes.

earlier editions

An earlier edition stays at its address unchanged, so that a link to it keeps working. Its rules are those of the release it was published with.

Edition Title Replaced by
SPEC-09P.3 Toolchain and conformance SPEC-09P.4
SPEC-03P.2 The host interface: C and Python SPEC-03P.3
SPEC-04P.3 The cint language SPEC-04P.4
SPEC-06P.2 The cint tools SPEC-06P.3
SPEC-09P.2 Toolchain and conformance SPEC-09P.3
GLOSSARY-P.3 Glossary GLOSSARY-P.4
SPEC-01P.2 Canonical encodings and identity SPEC-01P.3
SPEC-02P.1 Kernels and executors SPEC-02P.2
SPEC-03P.1 The host interface: C and Python SPEC-03P.2
SPEC-04P.2 The cint language SPEC-04P.3
SPEC-06P.1 The cint tools SPEC-06P.2
SPEC-09P.1 Toolchain and conformance SPEC-09P.2
GLOSSARY-P.2 Glossary GLOSSARY-P.3
SPEC-00P.1 Overview SPEC-00P.2
SPEC-01P.1 Integer machine SPEC-01P.2 and SPEC-04P.2
SPEC-04P.1 Language surface SPEC-04P.2
GLOSSARY-P.1 Glossary GLOSSARY-P.2
REFERENCES-P.1 References REFERENCES-P.2

editions by release

Release Editions
cint v0.2.8 SPEC-09P.4
cint v0.2.4 SPEC-03P.3, SPEC-04P.4, SPEC-06P.3, SPEC-09P.3, GLOSSARY-P.4
cint v0.2.3 SPEC-01P.3, SPEC-02P.2, SPEC-03P.2, SPEC-04P.3, SPEC-06P.2, SPEC-09P.2, GLOSSARY-P.3
cint v0.2.0 SPEC-00P.2, SPEC-01P.2, SPEC-02P.1, SPEC-03P.1, SPEC-04P.2, SPEC-06P.1, SPEC-09P.1, GLOSSARY-P.2, REFERENCES-P.2
cint v0.1.0 SPEC-00P.1, SPEC-01P.1, SPEC-04P.1, GLOSSARY-P.1, REFERENCES-P.1