Editing insertion options

You can use the Insertion tab to edit the options that dictate where autocomments are inserted into changed lines.

1. In the dialog box (for the type of language profile that you want to edit), click the Insertion tab.
2. To specify a style for inserting autocomments into changed lines, do one of the following:
   • From the Style drop-down list drop-down list, select the style that you want to use.
   • Click Hints to open the Insertion Option Wizard. This wizard helps you to determine the best insertion style for the target programming language.
3. For all insertion styles (excluding Insert at the end of the changed line), the start column is used to align all autocomments in the same location. Specify Start column.
   Tip: Depending on the Alignment setting, the first character of the autocomment is either placed in or after the start column.
4. Optional. If the insertion style you selected requires a range of columns to be specified, the end column determines the column where the last character of the autocomment can appear. Specify End column.
   
   Note, the range described by the Start column and End column must equal the maximum comment length specified on the Formation page.
5. In the Alignment group, do one of the following:
   • To insert the first character of the autocomment in the start column, click the Left radio button.
   • To center the autocomment in the column range, click the Center radio button.
   • To insert the last character of the autocomment in the end column, click the Right radio button.
6. Optional. To insert an autocomment on the same line each time that line is changed, select the Insert duplicates check box.
   Clear the checkbox if you do not want to insert the same autocomment on the same line multiple times.
7. Optional. To insert an autocomment at the end of a changed line (if it cannot be inserted into the desired column range), select the Insert at end checkbox.
   Clear the checkbox if you do not want to overwrite the existing text.
8. Optional. To overwrite any text that is in the column range where the autocomment will be inserted, select the Overwrite existing checkbox.
   Note: If you select this option, you might overwrite source code with the autocomment. This option is only recommended for programming languages that do not allow source code in the autocomment range.
9. Optional. To ignore leading-edge white-space changes, like tabs or carriage returns, select the Ignore leading white space checkbox.
10. Optional. To ignore trailing white-space changes, like tabs or carriage returns, select the Ignore trailing white space checkbox.
11. Optional. To insert autocomments into lines that only contain comment text, select the Insert on lines that only contain comments checkbox. Clear the checkbox if you do not want to insert an autocomment into changed comment lines.
12. Optional. To insert autocomments into lines that are blank after changes have been made to the line, select the Insert on blank lines checkbox. Clear the checkbox if you do not want to insert an autocomment into blank changed comment lines.
    Note: When you create a new line in a file, it is considered a blank line. If you select the Insert on blank lines check box, an autocomment will be inserted into every line that you insert into this file.
13. Optional. If you are using High Level Assembler and want to insert autocomments into changed lines even if these lines contain invalid instructions (such as, SPACE, EJECT, or TITLE), select the insert on lines that contain invalid instructions check box. Clear the checkbox if you do not want to insert autocomments into lines that continue.
14. Optional. If you are using High Level Assembler and want to insert autocomments into lines that continue, select the Insert on lines that continue in column 72 checkbox. Clear the check box if you do not want to insert autocomments into lines that continue.
15. Click Apply to save your selections in the Insertion tab.