gcgen Documentation
===================================
gcgen aims to provide a minimal, yet useful tool to aid with code generation, 
predominantly by allowing you to weave snippets of generated code in among
otherwise hand-written code, though generating entire files from scratch
is also supported.

gcgen is written for ease of use, thus it:

* Enables active code-generation
* Allows generated code to be mixed in among hand-written code
* Separates generator code from the project's source files
* Introduces very few concepts to learn
* Provides the full expressive power and library ecosystem of the Python programming language


Contents
--------

.. toctree::
   :maxdepth: 2

   getting_started/index.rst
   motivation.rst
   design.rst
   reference/installing_gcgen/index.rst
   reference/starting_a_project/index.rst
   reference/gcgen_file/index.rst
   reference/scope/index.rst
   reference/snippets/index.rst
   reference/generators/index.rst
   reference/section/index.rst
   reference/api/index.rst




Indices and tables
------------------

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`