pawn-lang/compiler

Pawndoc and deprecation messages collide

Y-Less opened this issue · 1 comments

#pragma option -r

/**
 * - documentation
 */
#pragma deprecated - message
Func() {}

main()
{
	Func();
}

Output:

warning 234: function is deprecated (symbol "Func") - message
#pragma option -r

main()
{
	Func();
}

/**
 * - documentation
 */
#pragma deprecated - message
Func() {}

Output:

warning 234: function is deprecated (symbol "Func") - documentation 

They both use the ->documentation field in the symbol struct, and clearly order matters.

Furthermore:

//#pragma option -r

main()
{
	Func();
}

/**
 * - documentation
 */
#pragma deprecated - message
Func() {}

Output:

warning 234: function is deprecated (symbol "Func") 

Disabling pawndoc means neither get used.