Comments

Line, block, and nested block comments; visual separators with --; TODO/FIXME/NOTE/HACK/SAFETY conventions.

// ============================================================

// Comments in Zolo

// ============================================================

// -- Line comments --------------------------------------------

// This is a simple line comment.

// Everything after // until the end of line is ignored by the compiler.

let x = 42
// trailing comment at end of line

// You can use comments to disable code:

// let debug = true

// print("debug mode active")

// -- Block comments -------------------------------------------

/* This is a block comment.
   It can span multiple lines.
   Useful for describing large sections of code. */
let y = 10
/* inline value */
/* Block comments can be nested:
   /* this is a block inside another block */
   and this is still part of the outer comment
*/
// -- Visual sections with comments ----------------------------

// Use decorative lines to separate sections of code:

// -- Constants -------------------------------

const PI = 3.14159
const MAX_RETRIES = 3

// -- Helper functions ------------------------

fn helper(x: int) -> int {
    return x * 2
}

// -- Main logic ------------------------------

let result = helper(21)
print("Result: {result}")

// -- TODO / FIXME / NOTE --------------------------------------

// Common conventions in comments:

// TODO: implement input validation

// FIXME: this function does not handle negative values

// NOTE: this algorithm has O(n^2) complexity

// HACK: temporary workaround until the parser is fixed

// SAFETY: safe call because we validated bounds above

fn sum(a: int, b: int) -> int {
    // TODO: add overflow check

    return a + b
}

print("sum: {sum(10, 20)}")

Requires the Zolo CLI/host — open in the playground or run locally.