From a19f5d5b5073de388feb7f7a01466a21cdf25bcd Mon Sep 17 00:00:00 2001 From: HassanAkbar Date: Mon, 2 Nov 2026 19:45:18 +0500 Subject: [PATCH] document referable remark ids --- syntax.adoc | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/syntax.adoc b/syntax.adoc index 3576c86..c555df0 100644 --- a/syntax.adoc +++ b/syntax.adoc @@ -84,6 +84,12 @@ These different types of remarks can be in multiple instances, for example, multiple `(*"{TAG}" ... *)` remarks can be made in an EXPRESS file to describe the particular object. +A note, example, figure or table can carry its own ID after a colon, such as +`(*"{TAG}.__note:two" ... *)`. Each ID makes a separate remark that can be +referred to from other remarks, for example +`<>`. The ID is any name unique among the remarks of +that type on `{TAG}`. + These named remarks are not bound to any particular location in an EXPRESS file. For example, they can be made immediately after the declaration of the EXPRESS object, or collected at the top or bottom of the EXPRESS file.