No standard function header format

[Blecki]

[Blecki]

Suggestion:

;FUNCTION compiler calling_convention name entry_label parameter_count any additional comments

Example:

;FUNCTION dcpuc registercall itoa itoa_FUNCTION 2

[lifthrasiir]

@Blecki: Should it be ;#function? We already have a de facto header ;#include which indicates the dependency. (I don't think we should change it to #include as we don't need to include multiple copies of the same file.)

[Blecki]

This isn't for indicating a dependency, this is so that tools (for example, a compiler) can find the function and call it properly.

[Blecki]

Just realized you might be confusing 'function header' with a 'header file', such as C uses. To clarify, separate concepts. This is for meta data attached to the function that compilers would use to properly call the function. This is not about importing one source file into another.

[lifthrasiir]

@Blecki: ;#function does not indicate a dependency, right. But the compiler will require both ;#function and ;#include lines in order to link functions correctly anyway. My argument is that ;#function and ;#include are both metadata (not parsed by an assembler but a higher-level tool like a compiler) and their syntax has to be consistent.

[Blecki]

Oh, Alright. All that's important is that it include all the information, and start with ; so assemblers interpret it as a comment.

So how about
;#FUNCTION compiler call_conv name entry_label p_count