User manual

Your STVD graphical environment UM0036
50/385 Doc ID 7705 Rev 11
Note: To edit source files during a debugging session, ensure that the Read-only source files
feature has been disabled. To do this, select Tools>Options and click on the Edit/Debug
tab, then uncheck the Read-only source files option. Then click on Apply and OK. Note
that while this allows you to modify the application source files, you must recompile the
executable file so that your changes are taken into account when running the application.
Syntax highlighting
STVD offers configurable syntax highlighting to improve the readability of your C and
Assembly source files. This feature allows you to define the source code display conditions
(text color, background color, character style) for a syntactic group. In addition to highlighting
for commands, variables and comments, the Editor recognizes language-specific keywords
for C and Assembler source files.
Note: Language-specific highlighting is established at the file level, therefore no language-specific
highlighting is applied to Assembler code in C language files (*.c, *.h or *.ssp).
A basic highlighting configuration is set by default, which you can modify to meet your
specific needs or preferences by using the Styles/Languages tab of the Options window
(Tools>Options). For more information about modifying the syntax highlighting
configuration, refer to Section 3.7.1: Customizing editor features on page 61.
Auto-completion
While typing your code, use the auto-completion feature to see a list of language-specific
keywords that match what you have started typing. For example, when typing a command in
a C source file, type the first letters followed by CTRL+Space, or select Edit>Complete
Word. A pop-up window opens with the alphabetical listing of C language keywords, at the
section of the list that matches what you have started typing. Highlight the keyword you want
and press enter (see Figure 25).
Figure 25. Auto completion pop-up list
If you have just created a new C or Assembler source file, the auto-completion feature is not
available until you have saved the file with the file extension that is appropriate to the
language (for C: *.c, *.h, or for Assembly: *.asm, *.s, *.S or *.inc).
Parameter information
While typing your code in Assembly, the parameter information tips prompt you with the
syntax for the instruction that you are typing. Syntax information is provided for the ST ASM
instruction set.
For example, when typing an instruction in an Assembler source file, type the instruction
then press CTRL+Shift+Space, or select Edit>Parameter Info. A tip window appears with
the syntax of the instruction that you have named (see Figure 26).