The Comments field

The Comments field supplies the comments that appear at the top of the p4 job form. Because p4 job does not automatically tell your users the valid values of select fields, which fields are required, and so on, your comments must tell your users everything they need to know about each field.

Each line of the Comments field must be indented by at least one tab stop from the left margin, and must begin with the comment character #.

The comments for the default p4 job template appear as:

Comments:
      # A Perforce Job Specification.
      # Job: The job name. 'new' generates a sequenced job number.
      # Status: Either 'open', 'closed', or 'suspended'. Can be changed
      # User: The user who created the job. Can be changed.
      # Date: The date this specification was last modified.
      # Description: Comments about the job. Required.

These fields are also used by P4V, the Helix Core Visual Client, to display tooltips.