--- a/docs/example-1.pseudocode	Thu May 07 15:49:13 2026 +0200
+++ b/docs/example-1.pseudocode	Thu May 07 16:06:59 2026 +0200
@@ -4,12 +4,12 @@
   /*
    * The program is here, but it also could be an \ALGORITHM
    *
-   * /* YES! Nested multiline comments work! */
+   * /* YES! Nested multi-line comments work! */
    */
 
   \PROC {A Procedure name} \IS
     \TBLOCK {A text block 1}
-    \TBLOCK {A text block 2 with an expression: \expr{flag is FALSE}}
+    \TBLOCK {A text block 2 with a nested expression: \expr{flag is FALSE}}
     \BLOCK {
         \REMARK  A remark on its own line within a "BLOCK"
     }
@@ -31,9 +31,14 @@
     a and b xor (c in d)      \rem this is another remark
 
     # This is another one-line comment
+
+    (* Here is a "block" of expressions.
+       A block has a leading symbol. *)
     \block {foo
       bar}
     \block{a 1.2 {x in X\} c}
+    (* Analogous there is a variant that is in text-mode by default.
+       It has an other leading symbol. *)
     \tstate{We will compute next \expr{a xor b or (\text{set} X is Empty)} \rem without c!
       or multiply it the other way round}