We humans need to "enhance" our logic with prose and explanation for others humans (and future versions of ourselves).
Since code should be manageable and understandable over time via different people, Adama supports C style comments.
This enables comments to be sprinkled liberally within Adama code.
Comments are part of the syntax tree for Adama as part of hidden meta-data on tokens. This is so that comments are available to tooling such that error messages can more helpful, but also so documentation can be generated and shared with document consumers.
Comments associate with tokens can be either in a forwards or backwards manner. Comments on multiple lines such as:
always associate forward. For instance the comment in
is associated to the 'int' token. Whereas single line comment like
usually associate backwards. Here, the comment is associated with the ';' token. Sometimes, the single line comment will associate forward but only after a multi-line comment has been introduced. For instance
will associate both comments to the 'int' token.