summaryrefslogtreecommitdiffhomepage
path: root/toml.html.markdown
diff options
context:
space:
mode:
authorLuke Harold Miles <10591373+qpwo@users.noreply.github.com>2024-05-12 23:41:45 -0700
committerGitHub <noreply@github.com>2024-05-13 00:41:45 -0600
commit5ffa5d8356cf1e99daea42a9d34c644b6ccb6a23 (patch)
tree11898cf6b5d4f9bb6418dfe3a780e5ea8c411bff /toml.html.markdown
parent9d1ddbea0407c2bd3ea49a364eb3fbb387c506e7 (diff)
[toml/en] change toml from 0.4.0 to 1.0.0 (#4690)
Diffstat (limited to 'toml.html.markdown')
-rw-r--r--toml.html.markdown12
1 files changed, 8 insertions, 4 deletions
diff --git a/toml.html.markdown b/toml.html.markdown
index 13be23b8..1af38e4a 100644
--- a/toml.html.markdown
+++ b/toml.html.markdown
@@ -9,8 +9,7 @@ TOML stands for Tom's Obvious, Minimal Language. It is a data serialisation lang
It is an alternative to YAML and JSON. It aims to be more human friendly than JSON and simpler that YAML. TOML is designed to map unambiguously to a hash table. TOML should be easy to parse into data structures in a wide variety of languages.
-Be warned, TOML's spec is still changing a lot. Until it's marked as 1.0, you
-should assume that it is unstable and act accordingly. This document follows TOML v0.4.0.
+This document follows [TOML v1.0.0](https://toml.io/en/v1.0.0). Future [changes](https://github.com/toml-lang/toml/blob/main/CHANGELOG.md) are expected to be minor and backwards-compatible.
```toml
# Comments in TOML look like this.
@@ -32,7 +31,8 @@ boolean = true
dateTime = 1979-05-27T07:32:00-08:00
scientificNotation = 1e+12
"key can be quoted" = true # Both " and ' are fine
-"key may contain" = "letters, numbers, underscores, and dashes"
+"unquoted key may contain" = "letters, numbers, underscores, and dashes"
+other_kêys = "are permitted by spec but most implementations don't actually permit them"
# A bare key must be non-empty, but an empty quoted key is allowed
"" = "blank" # VALID but discouraged
@@ -205,8 +205,12 @@ c = 2
# Inline table #
################
-inlineTables = { areEnclosedWith = "{ and }", mustBeInline = true }
+inlineTables = { areEnclosedWith = "{ and }", a = { b = { c = { d = 1 } } } }
point = { x = 1, y = 2 }
+usingMultiple = {
+ lines = "discouraged!",
+ instead = "use normal TOML tables",
+}
###################
# Array of Tables #