A.3.3. Edit

Settings in this group control general editor behavior when working with source files in the File Editor pane. These settings can also be used to control the operation of a standalone editor if specified for use outside RealView Debugger.

These settings can be overridden dynamically using the menus and toggles in the File Editor.

The Edit group contains three third-level groups and a series of settings:

Backup

These settings control the backup behavior when working with source files in the File Editor pane.

Table A.8 describes these settings.

Table A.8. Backup settings

NameProperties
DisableBy default, a backup file is created when a file is edited. This provides a useful safety feature. Use this to disable this feature if required.
Backup_dirBy default, backup files are saved in the same directory as the original file. Use this to specify a pathname to a new location, for example to keep all backup files in one special directory.
Backup_extBy default, backup files are saved with the .bak extension appended to the original filename.
Tab_conv

Settings in this group control the display behavior when working with source files in the File Editor pane. These settings are used to handle tabs and spaces.

Tabs are allowed in files and are left untouched, by default. Use these settings to convert tabs to spaces when writing to the file, that is saving, and to convert spaces to tabs when reading the file.

Spaces are not converted to tabs inside “ and “ quoting blocks on a line.

Table A.9 describes these settings.

Table A.9. Tab_conv settings

NameProperties
Tabs_to_spacesConverts tabs to spaces when the file is saved.
Spaces_to_tabsConverts spaces to tabs when the file is read.
To_spaces_extUse this to specify file extensions where tab conversions take place. Specify a list separated by semi-colons (;).
To_tabs_extUse this to specify file extensions where space conversions take place. Specify a list separated by semi-colons (;).
Src_ctrl

Settings in this group control source control access tools when working in the File Editor pane and in RealView Debugger. The editor attempts to detect any source control system in use, where possible, but you might have to specify it before RealView Debugger can use it.

Use these settings to specify complete source control commands, and to override commands for known systems.

The Src_ctrl group contains a low-level group and a series of settings:

Cmds

Use these to specify source control commands for use with RealView Debugger.

Src_ctrl settings

Use these to specify the source control system to be used with RealView Debugger to control access to files.

Edit settings

Settings in this group configure editor behavior when working with source files in the File Editor pane.

Table A.10 describes these settings.

Table A.10. Edit settings

NameProperties
Drag_drop_disUse this to disable drag-and-drop editing when working in the File Editor pane.
ViRunning the editor in vi mode enables you to access all the vi commands and most ex commands. You can configure RealView Debugger to start the File Editor in vi mode using this setting. When in insert mode, all Common User Access (CUA) editing features are available. You can also enable this option from the File Editor pane menu bar.
IndentUse this to set indenting so that a specified number of spaces are inserted as you open a new line. By default, auto-indent inserts the same number of spaces as on the previous line. If the previous line is a left curly bracket ({) the shift is increased. If the previous line is a right curly bracket (}), shift spaces are subtracted.
UndoUse this to specify the levels of undo and redo. By default, this is set to 64.
TabUse this to specify the size of TAB settings when working in the File Editor. By default, this is set to 8. Use a value between 1 and 16.
ShiftUse this to specify the size of shift spaces as used in the Indent rule and accessed through the File Editor menu options. By default, this is set to 2. Use a value between 2 and 32.
Line_numberBy default, line numbering is disabled in RealView Debugger and the File Editor. Use this to change the editor default to show line numbers at start-up.
No_tooltipBy default, tooltip evaluation of variables and registers is enabled. Change this setting to True to disable this feature.
Timer

During file editing, the editor periodically checks to see if another tool has edited or deleted the files being tested. A warning is shown if an update is detected.

Use this to specify the number of seconds between checks. The default is 60 seconds. Use values greater than 30 seconds. Set to -1 to disable this feature.

Tool_saveWhen performing a build, you are prompted to resave any files that have been edited. Use this to specify automatic resaving of changed files at build time to ensure that your latest sources are included. You can also set a no-save, no-ask value.
Startup

The default start-up file, that is rvdebug.sav in your home directory, contains a list of previously edited files and information from previous debugging or editing sessions. This enables historical information to be separated from your current session.

Use this to specify a different start-up file, in a new location. Set this to - (dash) to specify that no start-up file is used.

Template

During file editing, you can use templates to speed up code development. The template file contains templates that you can use or edit as required.

By default, the file is named rvdebug.tpl and is saved in your home directory, or in the default settings directory \etc. Use this to change this pathname.

Restore_state

This setting applies only to a standalone editor. Use this to start the standalone editor in the same state it was in when you last exited.

Copyright © 2003, 2004 ARM Limited. All rights reserved.ARM DUI 0234B
Non-Confidential