Commit: 679f746f4bf17fa9ac8ea1c3633093e2f432c9aa - CCastle2 (hg)

Castle: The best Real-Time/Embedded/HighTech language EVER. Attempt 2

Commit MetaInfo

• Révision: 679f746f4bf17fa9ac8ea1c3633093e2f432c9aa (tree)
• l'heure: 2022-05-19 19:32:39
• Auteur: Albert Mietus < albert AT mietus DOT nl >
• Commiter: Albert Mietus < albert AT mietus DOT nl >

Message de Log

asis/comment/doc added

Change Summary

• modified: castle/readers/parser/grammar/language.py

Modification

diff -r bc6b5143377d -r 679f746f4bf1 castle/readers/parser/grammar/language.py
--- a/castle/readers/parser/grammar/language.py	Thu May 19 12:31:21 2022 +0200
+++ b/castle/readers/parser/grammar/language.py	Thu May 19 12:32:39 2022 +0200
@@ -1,3 +1,19 @@
+# (C) Albert Mietus, 2022
+"""This module `grammar/language` defines the peg_grammar (declarations) that can be used in Castle.
+
+A peg_grammar (in Castle2) mainly contains (parse_)rules, but can also define setting (a kind of LEXER aliases).
+
+Any rule looks like::
+  Name '<-'  E1 E2  '|' E3 ';'
+
+Where Ex are (expression) rules itself.
+
+.. seealso:: The language is defined in arpeggio statements (that is a PEG itself, but using python syntax).
+
+    See https://textx.github.io/Arpeggio/
+"""
+
+
 from arpeggio import Optional, ZeroOrMore, OneOrMore, EOF
 from arpeggio import RegExMatch as _
 from arpeggio import ParserPython