implements PLN-0092
This commit is contained in:
@@ -114,6 +114,13 @@ String literals:
|
||||
- delimited by `"`.
|
||||
- supported escapes: `\\`, `\"`, `\n`, `\r`, `\t`.
|
||||
|
||||
Documentation text block literals:
|
||||
|
||||
- delimited by `"""`.
|
||||
- valid only as the value of the `markdown` argument in the reserved `[Doc(markdown = """...""")]` attribute surface.
|
||||
- not part of the runtime expression literal surface in v1 core.
|
||||
- preserve authored text for later documentation normalization.
|
||||
|
||||
Boolean literals:
|
||||
|
||||
- `true`, `false`.
|
||||
@@ -241,7 +248,8 @@ Attribute ::= '[' Identifier AttrArgs? ']'
|
||||
AttrArgs ::= '(' AttrArgList? ')'
|
||||
AttrArgList ::= AttrArg (',' AttrArg)*
|
||||
AttrArg ::= Identifier '=' AttrValue
|
||||
AttrValue ::= StringLit | IntLit | BoolLit
|
||||
AttrValue ::= StringLit | IntLit | BoolLit | DocTextBlock
|
||||
DocTextBlock ::= '"""' DocTextBlockChar* '"""'
|
||||
```
|
||||
|
||||
Rules:
|
||||
@@ -250,11 +258,16 @@ Rules:
|
||||
- Attributes do not introduce values, types, callables, or modules by themselves.
|
||||
- In v1 core, ordinary user-authored modules MUST reject attributes unless another specification explicitly permits them.
|
||||
- Ordinary userland source MAY use `[Init]` and `[Frame]` only on top-level `fn` declarations.
|
||||
- Ordinary userland source MAY use `[Doc(markdown = """...""")]` on named API declarations where the static semantics specification permits documentation.
|
||||
- Reserved stdlib/toolchain interface modules MAY use attributes where explicitly allowed by syntax and semantics.
|
||||
- Reserved stdlib/toolchain interface modules MAY additionally use `[InitAllowed]` only on `declare host` method signatures where another specification explicitly permits it.
|
||||
- Attribute interpretation is compile-time only unless another specification explicitly lowers its effect into runtime-facing metadata.
|
||||
- Reserved attribute names used by builtin-type and intrinsic shells do not become ordinary value-level syntax.
|
||||
- `Slot(...)` is not part of the v1 attribute surface; source that uses `Slot` must be rejected in syntax phase.
|
||||
- `Doc` is a reserved documentation attribute name. Its only v1 syntactic shape is `[Doc(markdown = """...""")]`.
|
||||
- The `Doc` attribute MUST NOT accept positional arguments, `text`, `html`, `format`, `Document`, `Documentation`, or prefixed text block forms such as `md"""..."""`.
|
||||
- Documentation text blocks are not string literals and MUST NOT appear in ordinary expressions, parameter defaults, or non-`Doc` attribute arguments.
|
||||
- Attribute ordering is syntactically insignificant; semantic validation determines duplicate or invalid attribute combinations.
|
||||
|
||||
### 6.2 Top-level declarations
|
||||
|
||||
|
||||
Reference in New Issue
Block a user