Language
========

The syntax of Crowbar is designed to be similar to the syntax of C.

A Crowbar source file is UTF-8.
Crowbar source files can come in two varieties:

.. glossary::

    header file
        A Crowbar source file declaring types and functions.
        Can be intended for internal use within a project, or to define the public API of a library.
        Conventionally has the ``.hro`` file extension.

    implementation file
        A Crowbar source file providing function definitions, and sometimes its own type declarations.
        Conventionally has the ``.cro`` file extension.

A Crowbar source file is read into memory in two phases: *scanning* (which converts text into an unstructured sequence of tokens) and *parsing* (which converts an unstructured sequence of tokens into a parse tree).

..  toctree::
    :maxdepth: 1
    
    scanning
    flow-control