14.14. Control Hex Conversion Utility Diagnostics¶
The hex conversion utility uses certain C/C++ compiler options to control hex-converter-generated diagnostics.
-
--diag_error
¶
Syntax: –diag_error=id
Categorizes the diagnostic identified by id as an error. To determine the numeric identifier of a diagnostic message, use the –display_error_number option first in a separate link. Then use –diag_error=id to recategorize the diagnostic as an error. You can only alter the severity of discretionary diagnostics.
-
--diag_remark
¶
Syntax: –diag_remark=id
Categorizes the diagnostic identified by id as a remark. To determine the numeric identifier of a diagnostic message, use the –display_error_number option first in a separate link. Then use –diag_remark=id to recategorize the diagnostic as a remark. You can only alter the severity of discretionary diagnostics.
-
--diag_suppress
¶
Syntax: –diag_suppress=id
Suppresses the diagnostic identified by id. To determine the numeric identifier of a diagnostic message, use the –display_error_number option first in a separate link. Then use –diag_suppress=id to suppress the diagnostic. You can only suppress discretionary diagnostics.
-
--diag_warning
¶
Syntax: –diag_warning=id
Categorizes the diagnostic identified by id as a warning. To determine the numeric identifier of a diagnostic message, use the –display_error_number option first in a separate link. Then use –diag_warning=id to recategorize the diagnostic as a warning. You can only alter the severity of discretionary diagnostics.
-
--display_error_number
¶
Syntax: –display_error_number
Displays a diagnostic message’s numeric identifier along with its text. Use this option in determining which arguments you need to supply to the diagnostic suppression options (–diag_suppress, –diag_error, –diag_remark, and –diag_warning). This option also indicates whether a diagnostic is discretionary. A discretionary diagnostic is one whose severity can be overridden. A discretionary diagnostic includes the suffix -D; otherwise, no suffix is present. See Diagnostic Options for more information on diagnostic messages.
-
--issue_remarks
¶
Syntax: –issue_remarks
Issues remarks (nonserious warnings), which are suppressed by default.
-
--no_warnings
¶
Syntax: –no_warnings
Suppresses warning diagnostics (errors are still issued).
-
--set_error_limit
¶
Syntax: –set_error_limit=count
Sets the error limit to count, which can be any decimal value. The linker abandons linking after this number of errors. (The default is 100.)
-
--verbose_diagnostics
¶
Syntax: –verbose_diagnostics
Provides verbose diagnostics that display the original source with line-wrap and indicate the position of the error in the source line.