Source Editor Options

The Options > Editor command activates a dialog box containing options that determine various Editor parameters. This dialog box is divided into five tabs: 

General

Source

Text

Coding

Structure Highlighting

General

This tab specifies the general Editor parameters.

Editor Options General tab

Read-only notify

Determines if you should be informed about read-only files by an appropriate dialog box or only by a remark within the status bar.

Force fixed window size

Determines if the initial size of the Editor will be set by the "Window Height" and "Window Width" parameters. If this check box has not been selected, the size of the Editor is determined by the operating system according to its algorithms.

Previous size

Determines if the size and position of Editors will be remembered (after closing the Editor), and used for initial size and position of Editors for that file.

Editor's states buffered

After each change to the source file, the contents of the Symbols database, Message Logs, Browser, and so on will no longer reflect the current state in Editor, as the order of lines in the edited file will have changed. For example, if there is an error in the Message Logs which the analyzer has located in line 20, and two new lines are inserted before the line in question, the error will actually appear in line 22. Editor can mitigate this effect by registering all changes which bring about a change in line ordering. This option specifies the number of such changes which is to be registered - after this number, Editor no longer registers changes. A new analysis is considered necessary if this number of file changes is exceeded.

Save kills Undo

Determines if "File > Save" will destroy all Undo information.

Undo limit

Determines the maximum number of Undo operations that can be performed using the "Edit > Undo" menu command. Only the most recent "Undo Limit" operations can be undone.

Make backup file

Determines if the backup of the file in the Editor will be created while saving the file to the disk. The backup file has the original file name with the .BAK extension appended.

Insert mode

Determines if the starting edit state of the Editor will be Insert or Overwrite.

Persistent blocks

Determines which type of marking blocks will be used in Editor. If this check box is selected, marked blocks will remain selected until deleted or unmarked, or until another block is selected. This means that typed or pasted text is added at the insertion point position, instead of the contents of the selection being deleted. When this check box is cleared, if you move the insertion point after a block has been selected, the text does not stay selected.

Remove trailing spaces

Determines if the white spaces at the end of the line will be removed.

Show line numbers

This option enables or disables the line number display on the left margin of the window. The font size is automatically adjusted based on the current font size in the Editor. Line numbers are truncated to 5 least significant digits.

Smart line ends

If Smart line ends is on, DA-C tries to distinguish (based on file content) which combination of CR/ LF, CR, LF or LF/CR to put at the end of line.

EOL mark

EOL Mark sets the CR/LF combination if the Smart line ends parameter is off, or the new file has been edited.

Cursor beyond EOF

Determines if the text insertion point will move beyond the last line of the file.

Brief cursor

Determines if the shape of the text insertion point will correspond to the Brief text insertion point.

Auto-save time

The Auto-save feature periodically saves changes to disk to avoid substantial loss of data that could otherwise result from software malfunction, a power failure, or other minor malfunction. This entry sets the inactivity interval that will trigger Auto-save. Enter the desired number of minutes here. Zero value turns Auto-save off.

Auto-reload on file alert

Determines if a file in the Editor gets automatically reloaded (without asking) when changed outside DA-C Editor.

Source

In this tab you can change Editor parameters for source files.

Editor Options Source tab

Unanalyzed lines / Mark

If the check box is selected, Editor shows the lines of code conditionally excluded from the analysis by preprocessor directives in a special color. The Bold, Underline and Italic attributes of the colored text are not changed in order to keep the code readable. The color of the unanalyzed lines can be chosen in the Options > Editor / C source / Colors & Font dialog box.

Unanalyzed lines / Hide

If this check box is selected, all parts of code conditionally excluded from the analysis by preprocessor directives are automatically hidden. The hiding is performed automatically when each file is opened, and after C source analysis is completed.

Comment / Zoom with prefix

Comments with this prefix will be hidden - the text of a comment will be represented by series of "~" signs. In the edit boxes "Zoom with prefix" and "Exception" you can enter up to five prefixes and exceptions separated by ';' (semicolon). Prefixes that include space character should be surrounded by double quotes.

Comment / Exception

Comments with this prefix will not be hidden, although they start with a hide prefix.

Text width

Determines the maximum number of characters of the source code line and the position of vertical line. 

Word wrap

If this check box has been selected, the formatted text will not exceed the specified maximal line length in Editor - long lines will be wrapped if Word Wrap is on. Turning the Word Wrap option on does not have any effect on existing file text; lines are wrapped only during typing or file formatting.

Hide prefix

Determines the text describing the hidden lines within the Editor.

Use TAB character

Determines if pressing the Tab key generates a TAB character or the appropriate number of spaces.

Optimal fill

Determines if the "Auto Indent" option will use only spaces, or TAB characters as well.

Cursor through TAB’s

Determines if the text insertion point will move through a TAB character, or jump over it.

TAB length

Determines the distance between two tab stops. Pressing the Tab key will position the text insertion point at the nearest tab stop to the right.

Backspace unindents

Determines if deleting characters using the Backspace key will move the text insertion point to the previous indent level. This is possible only if the insertion point is positioned at the first non-blank character in the line.

Auto-indent

Determines if pressing the Enter key positions the insertion point under the first non-space character of the preceding line.

Auto-indent length

Specifies the number of characters for which the line to be indented will be indented in relation to the preceding line. This value is used in automatic text formatting, automatic line indentation, as well as in EML macro primitives concerned with indentation ("InsertIndent", "BlockIndent" and so on).

Special identifiers

Determines a set of a maximum of 150 identifiers, separated by white space characters. The "@" character preceding a name, marks a file name containing identifiers. The prefix "@" is also used in the Project file ".DCP" to specify included files. Therefore, you should avoid using the character "@" at the beginning of the names of files and folders that are to be used in the project. A file containing identifiers can also be specified using the Browse button. Identifiers in a file are separated by white space characters or newline characters. Identifiers specified in this box will appear in the Editor in a special color, set in the Colors & Font dialog box.

Comment keywords

Determines a set of maximum of 25 comment keywords, separated by white space characters. Words entered into this box will appear in comments in a special color, set in the Colors & Font dialog box.

Colors & Font

Editor Options Source tab Colors & Font

Element

Click the element whose color you want to change.

FG (Foreground) Color, BKG (Background) Color, Mark FG, Mark BKG, Smart FG, Smart BKG

Click the desired color rectangle to select text foreground and background, color-marked text foreground, and background color, and use check boxes to set text attributes.

Font

Determines the font used in Editors and Browsers.

Font Style

Determines text attributes of the font used in Editors and Browsers.

Font Size

Determines the size of the font used in Editors and Browsers.

Color patterns

Click the desired button to select a predefined color pattern.

Text

This tab sets Editor parameters for text files.

Editor Options Text tab

Backspace unindents

Determines if deleting characters using the Backspace key will move the insertion point to the previous indent level. This is possible only if the insertion point is positioned at the first non-blank character in the line.

Auto-indent

Determines if pressing the Enter key positions the text insertion point under the first non-space character of the preceding line.

Auto-indent length

Determines the indentation level depth.

Use TAB character

Determines if pressing the Tab key generates a TAB character or the appropriate number of spaces.

Optimal fill

Determines if the "Auto Indent" option will use only spaces, or TAB characters as well.

insertion point through Tab’s

Determines if the text insertion point will move through a TAB character, or jump over it.

Tab length

Determines the distance between two tab stops. Pressing the Tab key will position the text insertion point at the nearest tab stop to the right.

Colors & Font

Opens the dialog box for choosing text file: color, size, style, and font.

Editor Options Text tab Colors & Font

Foreground Color

Click the desired color rectangle to select text foreground color.

Background Color

Click the desired color rectangle to select text background color.

Font

Determines the font used in Editors for text files.

Font size

Determines the size of the font used in Editors for text files.

Style

Determines text attributes of the font used in Editors for text files.

Coding

This tab sets Editor parameters for keyboard.

Editor Options Keyboard tab

Conversion

Unless the "None" option has been selected, when reading a file, the translation of the file content is done from the original character set into the OEM character set. In a file in which this conversion occurred during reading, reverse conversion takes place during writing. Thus, if this check box has been selected, the presentation in DA-C is in the OEM, and the content in the file in the original character set.

Structure Highlighting

This tab sets Editor parameters for Structure Highlighting.

Editor Options Structure Highlighting tab

Show structure highlighting at startup

Displays Structure Highlighting on opening the C Source module.

Browse while holding a key

Specifies whether the display will be updated while insertion points are held down in Editor.

Minimal highlight width

Minimal width of the Structure Highlighting rectangle. In case the code demands it, width can be increased.

The choice of options for highlighting program structure is given via:

Frame

Presence of frame around the program code block

Colors color frame

Lines line frame

Background

Use of background colors for highlighting

None no background colors

Full coloring of rectangular area encompassing the code block

Text - only background color for text only

Unstructured

Selection of ways to highlight non-structured jumps

None no graphical shapes

Around graphical shapes around the non-structured parts

Next to graphical shapes next to the non-structured parts

Default

Reset to initial setting .

Background colors used to highlight program structure are taken over from Options > Flowchart options.