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"