.. Ginger documentation master file, created by
   sphinx-quickstart on Mon Nov  7 20:46:55 2011.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

=======================================
The Ginger Programming Language Project
=======================================

Ginger is a programming language that is easy to learn, quick to get results and 
is suitable for a really wide range of projects - from the small, off-the-cuff scripts
to large scale team projects. We hope it will become your other programming language; 
the one you use when you want to have fun or really get things done; the one that no one 
has to pay you to use. 

*Ginger is still in development though, so maybe you would like to join in and 
help as a tester or a developer. We have a lot to do!*

The aim of the Ginger Project is not just to create the Ginger programming language 
but also its ecosystem of libraries, documentation and supporting tools.

Introduction and Getting Started
--------------------------------

.. toctree::
   :maxdepth: 1

   
   introduction
   Getting started <get_started>
   FAQ <faq_list>
   Overview of the whole Ginger Project <overview>
   
Learn to Program in Ginger using the Common Syntax
--------------------------------------------------




Random Topics
-------------

.. toctree::
   :glob:
   :maxdepth: 1

   Ginger Interpreter, appginger <appginger>
   The Ginger Common Syntax <syntax/common_syntax>
   Patterns and Queries <design/patterns_and_queries>

   Equality <equality>


Help Topics
-----------

.. toctree::
   :glob:
   :maxdepth: 1

   help/*
   std/*

Common Syntax 
-------------

.. toctree::
   :glob:
   :maxdepth: 1

   syntax/*
   

Design Rationales
-----------------

.. toctree::
   :maxdepth: 1
   :glob:

   formats/gson
   design/*

Proposals
---------
.. toctree::
   :maxdepth: 1
   :glob:

   proposals/*


The Ginger Toolchain
--------------------
   
.. toctree::
   :maxdepth: 1
   :glob:

   help/toolchain
   tools/*
   formats/*

Low-Level Implementation
------------------------

.. toctree::
   :maxdepth: 1

   How Iterators Work <implementation/iterators>
   The Ginger VM Instruction Set <implementation/instruction_set>
   Multiple implementations  <implementation/multiple_implementations>

Release Notes
-------------

.. toctree::
   :maxdepth: 1

   Original News Update <news/news_naive_reverse>
   Version 0.8 <news/version_0.8>
   Version 0.8.1 <news/version_0.8.1>
   Version 0.8.2 <news/version_0.8.2>
   Version 0.9 <news/version_0.9>
   Version 0.9.1 <news/version_0.9.1>
   Version 0.9.2 <news/version_0.9.2>

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

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

.. toctree:: 
   :maxdepth: 1

   glossary
   references


.. _`Glossary`: glossary.html