---
title: "Editions"
url: https://una-lang.org/en/docs/editions/
release: v0.4.0
---

# Editions

An edition is the version of the language a package is written in. Each package names its edition in its manifest (`una.toml` for editions 0.1 to 0.3, `ita.una` from edition 0.4), and a release of the compiler supports a set of editions, so a package keeps its meaning when the compiler is updated.

At v0.4.0, `una --version` prints:

```text
una 0.4.0
editions: 0.1, 0.2, 0.3, 0.4, 0.5
preview: 0.3, 0.4, 0.5
z3: 5.1.0
development build
```

## The `edition` key

From spec/13 §7:

- `[package]`, required: `name`, `version` and `edition`, non-empty strings; `edition` is `"0.1"`. (v0.2, ADR 0056.) `edition` is `"0.1"` or `"0.2"`. The constructs of `spec/17`, `spec/18`, `spec/19` and `spec/20` and the keywords of edition `0.2` exist only in packages of edition `"0.2"` and later, and a single file has edition `"0.1"`, unless a manifest above it names another (`spec/30`, #1175).

## What edition 0.2 does not have yet

These are planned or deliberately absent. Using a reserved word gives U0103 (§1.5).

| Area | Status |
| --- | --- |
| Shared and isolated references (`shared`, `iso`, `weak`), cyclic structures | not in any edition yet; the words are reserved for a later edition; use arenas and indices |
| User traits and implementations (`trait`, `impl`), laws of constraints | later; edition `0.2` has `Eq`, `Ord` and `Integer` |
| Task values, detached tasks, `race`, `select`, timeouts, channels, actors | in editions `0.2` and `0.3`, `together` is the only concurrency; edition `0.4` (preview) adds started tasks (`tasks` and `start`), deadlines (`within`) and races (`first of`) ([spec/27](https://una-lang.org/en/docs/spec/27-tasks-and-time/)); `select`, channels and actors are in no edition |
| `break`, `continue`, an `invariant` clause for loops | not in v0.2 |
| A checked left shift | not in v0.2; use `wrapping_shift_left` or a multiplication |
| Cross-compilation of native executables | not in v0.2; each host builds for itself |
| Units of measure | edition `0.3` preview ([spec/25](https://una-lang.org/en/docs/spec/25-units-of-measure/), [ADR 0104](https://github.com/una-lang/una/blob/v0.4.0/docs/adr/0104-units-of-measure.md)) |
| Pipeline operator (`\|>`) | not added; method-call chains already cover this form ([ADR 0110](https://github.com/una-lang/una/blob/v0.4.0/docs/adr/0110-pipelines-and-shorthand-lambdas.md)) |
| Foreign code and FFI | not permitted in any edition ([ADR 0121](https://github.com/una-lang/una/blob/v0.4.0/docs/adr/0121-the-terms-of-a-preview-edition.md), rule 17) |
| Quantified laws and property tests | deferred: verification tiers 2 and 3 ([spec/12](https://una-lang.org/en/docs/spec/12-verification/), [backlog](https://github.com/una-lang/una/blob/v0.4.0/docs/plan/backlog.md)) |
| Semantic diff | deferred; in no release yet ([availability](https://una-lang.org/en/docs/editions/availability/)) |
| Cost contracts | a later release, not yet scheduled ([backlog](https://github.com/una-lang/una/blob/v0.4.0/docs/plan/backlog.md)) |
| External state semantics (idempotency, delivery, `observe`), durable effect journal | not in 0.4.0, and no edition plans them yet ([ADR 0139](https://github.com/una-lang/una/blob/v0.4.0/docs/adr/0139-edition-numbering-follows-the-release-that-closes-it.md), rule 6); `observe` is only a reserved word |
| Services, data access, infrastructure generation | not in 0.4.0, and no edition plans them yet; edition `0.4` (preview) has HTTP servers only ([spec/31](https://una-lang.org/en/docs/spec/31-http-servers/)) |
| Exceptions, null, inheritance, operator overloading, macros, implicit conversions, global mutable state, ambient authority | never |

## Moving a package to edition 0.2

See [Migrating from edition 0.1](https://una-lang.org/en/docs/editions/migrate-0.1-to-0.2/).
