Comment parsing to improve code information

[guilherme-gm]

Implementing some kind of parser on code comments could give usefull information to improve general usage and documentation (e.g. Java/Javadocs).

Some use-cases:

Var documentation

.@itemCount = 10; //< how many apples player should get

so later on, when you use auto-complete, .@itemCount would show "how many apples player should get" on its documentation.

Function / Routine docs

More or less related to: #4

/**
 * @param int number number to format
 * @param str comma symbol to be used
 */
function	script	F_InsertComma	{
   // ...

When using callfunc, signature helper could find out that F_InsertComma receives 2 parameters and their types.

"External" function reference

A feature to give the parser information that a function exists, even though it may not find it. This is usefull when writting a script that uses Hercules' global functions.

//#external F_InsertComma(number: int, comma: str): str