Differences between version #15089 and #15092

129a130,168
> ===== Context API and macro Context =====
> 
> The [[/api/haxe/macro/Context]] class gives you access to a lot of informations, such as compilation parameters, but also the ability to load type or even create new classes.
> 
> The Context API operates on the "application context", which is the unit in which the compilation of your code occurs. There is another context which is the "macro context" which compiles and run the macro code. Please note that these two contexts are separated.
> 
> For instance, if you compile a Javascript file :
> 	* the application context will contain your Haxe/Javascript code, it will have access to the Javascript API
> 	* the macro context will contain your macro code (the classes in which @:macro methods are declared) and it will not be able to access the Javascript API. It can however access the [[/api/sys]] API and the [[/api/neko]] API as well. It can still interact and modify the application context by using the [[/api/haxe/macro/Context]] class.
> 
> It is important to understand that some code sometimes get compiled twice : once inside the application context and once inside the macro context.
> 
> In general, it is recommended to completely separate your macro code (classes contaiting @:macro statements) from your application code, in order to prevent expected issues due to some code being included in the wrong context.
> 
> ===== Type Reification =====
> 
> It is possible to use ''macro : Type'' to build a type instead of an expression.
> 
> The following example will declare a new typed variable when called :
> 
> <code haxe>
> import haxe.macro.Expr;
> class Test {
> 	@:macro static function decl( vname : String ) {
> 		var str : ComplexType = macro : String;
> 		var arr : ComplexType = macro : Array<Array<$str>>;
> 		return macro var $vname : $arr = [];
> 	}
> 	#if !macro
> 	static function main() {
> 		decl("table");
> 		trace(table);
> 	}
> 	#end
> }
> </code>
> 
> Please note that in that case we need to make sure that the ''main()'' code is not compiled as part of the macro context.
>