WRITES0COMMENT

Inserts an S0 comment record into an S-record file.

WRITES0COMMENT "comment"
  

comment

Comment text: a string of alphanumerical characters 0-9 , A-Z , and a-z , plus space, underscore, and dash characters. Double quotes must enclose the comment string. (If you omit the closing double-quote character, the linker tries to put the entire LCF into the S0 comment.)

This command, valid only in an LCF sections segment, creates an S0 record of the form:

S0aa0000bbbbbbbbbbbbbbbbdd 

• aa - hexadecimal number of bytes that follow
• bb - ASCII equivalent of comment
• dd - the checksum

This command does not null-terminate the ASCII string.

Within a comment string, do not use these character sequences, which are reserved for LCF comments: # /* */ //

This example shows that multi-line S0 comments are valid:

WRITES0COMMENT "Line 1 comment

Line 2 comment"