HowTo.txt

How to add a new Generic Expansion Token
========================================

1.	Edit CodeGenParser\Tokenizer.cs
	- In the constructor, add the new token to the metaLookup collection
	  with TokenValidity.Anywhere

2.	Edit CodeGenEngineShared\TokenExpanders\TokenExpanderGeneric.dbl
	- Add a new expander method
	- Add the new method to the genericTokenExpanders collection

3.	Document the new token

How to add a new Generic Expression Token
========================================

1.	Edit CodeGenParser\Tokenizer.cs
	- In the constructor, add the new token to the expressions collection
	with TokenValidity.Anywhere

2.	Edit CodeGenEngineShared\ExpressionEvaluators\ExpressionEvaluatorGeneric.dbl
	- Add a new evaluator method
	- Add the new method to the genericExpressionEvaluators collection

3.	Document the new token

How to add a new "Requires XXX token" file header token
=======================================================

1.	Edit CodeGenParser\Tokenizer.cs 
	- In the constructor, add the new token to the metaLookup collection

2.	Edit CodeGenParser\Parser.cs 
	- In the overload of the Parse method, add a new entry to the switch
	  statement to process the token the same way the other ones are
	  processed, specifying the appropriate TokenValidity.

How to add a new "Requires XXX expression" file header token
=======================================================

1.	Edit CodeGenParser\Tokenizer.cs 
	- In the constructor, add the new token to the metaLookup collection

2.	Edit CodeGenParser\Parser.cs 
	- In the overload of the Parse method, add a new entry to the switch
	  statement to process the token the same way the other ones are
	  processed, specifying the appropriate TokenValidity.


How to add a new Loop Type
==========================

1.	Edit CodeGenEngine\Tokenizer.dbl
	- In the constructor, add the new loop token to the metaLookup collection

2.	Edit CodeGenEngine\TreeNodes.dbl
	- Add a new class to represent the type of node.

3.	Edit CodeGenEngine\Parser.dbl
	- In the processLoop method, add a new entry to the USING statement.

4.	Edit CodeGenEngine\LoopExpander.dbl
	- In the constructor add a new item to loopProcessors to declare the
	  method to be used to process the loop, and implement the method.