File Editor

About File Editor

File editor is the Processor Expert internal editor allowing to

  • Edit files - All common text editor functions are available for comfortable work with the source code.
  • View files - Editor is opened in a read only mode (it's shown in the title of the window).
  • Compare files - A visual file-comparison mode with two panels showing a differences between two files.

 

Notice: The Edit and View modes of the internal editor are not used in the CodeWarrior plugin. Internal editor is for these operations fully replaced by the native CodeWarrior source code editor.

Meaning of Buttons:

 

  • Switches between module Extensions - switch between assembler implementation of the driver and header file of the module or implementation (body file) of the module.
    Note: it is available only if it is allowed in the Editor Options.
  • Open file - opens a file.
  • Save file - saves the currently displayed file.
  • Save all - saves all opened files (if they were edited).
  • Close file - closes the currently displayed module (file).
  • Print file - prints the currently displayed file on a printer.
  • Editor options - editor settings.
  • Help - opens Help.
  • Change font - changes the font of File Editor.
  • Undo - restores the state of a file before the last change.
  • Redo - restores the last change.
  • Find - finds a string in the currently displayed file.
  • Replace - replaces a string with another string.

 

Mouse Actions

  • To move editor cursor to a specific place, click the left button on the desired place in a text.
  • To select a text, move mouse and hold the left button.
  • To move the selected text to a different location, drag a selected text with left button pressed.
  • To invoke editor pop-up menu, click the right button.
  • To scroll editor view, move mouse with middle button pressed.
  • To close an opened file, click the middle button on the tab with a file name (when multiple files are open).
  • To select a square text block inside the window press and hold the ALT key and left mouse button while moving the mouse.
  • To jump on a specified line number, click the first status-bar field containing a line number information.
  • To place a method invocation to the source code, drag the method from the Project Panel. See chapter Project Panel for details.

File Editor Pop-up Menu

To open the File Editor pop-up menu, click the right mouse button on the text area of the File Editor window.

Meanings of items:

  • File
    • Open - opens a file.
    • Save - saves the currently displayed file.
    • Save As - saves the currently displayed file under a new name.
    • Save All - saves all opened files (if files were edited.
    • Close- closes the currently displayed file.
    • Close all - closes all files.
    • Delete - closes and deletes the currently displayed file.
    • Reopen - opens a list of used files.
    • Print - prints the currently displayed file on a printer.
    • Print Preview ... - opens a print preview dialog. The dialog allows the user to enter printer options, set zoom size for preview, display document margins and print the page.
  • Edit
    • Undo - Restores the state of a file before the last change.
    • Redo - Resumes the last change.
    • Cut - Cuts the selected text to the clipboard.
    • Copy - Copies the selected text to the clipboard.
    • Paste - Pastes the text from the clipboard.
    • Clear - Clears the selected text.
    • Select All - Selects all text.
    • Delete Line - Removes the current line.
    • Delete word - Removes characters from the current cursor position to the end of the word (including space).
  • Search
    • Find - Displays SearchReplace dialog
    • Find Next - Finds next position of a string in the currently displayed file.
    • Replace - Displays SearchReplace dialog
    • Go to Line - Moves the cursor to a line determined by its number.
  • Debug

    Notice: Internal debugger is not available in this version.

    • Toggle break - Set breakpoints on actual cursor position.
    • Add watch ... - Add watch to watches list in Watches window.
    • Evaluate/Modify ... - Open watch editor and enable to edit value of any variable.
    • Run - Runs application in target system.
    • Go to cursor- Runs application and it stops on actually selected row and breakpoint.
    • Stop - Stops running application.
    • Reset - Resets application in target system.
    • Step into - Steps program including subprogram call.
    • Step over - Steps program without subprogram call.
    • Step into in assembler - Steps program including subprogram call. After one assembler instruction execution actual program position is displayed in window.
    • Step over in assembler - Steps program without subprogram call. After one assembler instruction execution actual program position is displayed in window.
    • Go to Source Line - Opens window and goes to actual program position.
    • Modules - Shows modules list into ABS file.
    • Disassembler - Opens Disassembler for the current module.
    • Disassembler Whole Code - Opens Disassembler for the whole program memory.
  • Options
    • Editor Options... - setting of the File Editor (see Editor Options below).
    • Change Font... - change font of File Editor.
    • Disassembler Op-codes

      These commands in this submenu are not supported in this version of Processor Expert.
  • Editor Toolbar Visible - show or hide toolbar of the File Editor. The toolbar is visible as a part of the window or as a single panel. Clicking on the toolbar corner it is possible to place the toolbar to other side of the window or to any other place on the screen as a floating panel.
  • Help - opens documentation.

 

Figure 1 - File Editor

File Editor Options

  • Preserve cursor position during paste - keeps the current position of the cursor during a paste operation.
  • Use tab character - The editor will write tabulator character after TAB key is pressed and these characters will not be replaced by spaces.
  • Show modules in separate tabs - Displays tabs for each opened module (extension). When this option is not checked, it is possible to switch between module extensions by clicking the right mouse button on the tab of the file and choosing the appropriate extension or by clicking on the "Switch between module extensions" button in the toolbar menu.
  • Show line numbers - Displays line numbers in the editor window.
  • Syntax highlighting - Displays file content in specific colors with respect to file extension and compiler.
  • No horizontal scroll-bar - Disables horizontal scroll-bar when line is not longer than window.
  • Outline current line - Editor shows a frame around the current line.
  • Tab size - number of spaces for tabulator.
  • Number of backup copies - how many backup copies will be maintained for each saved document. The backup files are created within the same directory as the saved file. The name of file is the same, but there is '~' character added before the extension and a number of the backup copy is added at the end. The latest backup file has the number 0. The bigger the number is, the older is the backup.
  • Hint delay - how long will an editor hint stay on the screen.

 

Figure 2 - Editor Options

Search And Replace Dialog

This dialog window is invoked by the pop-up menu commands Search | Find... and Search | Replace.... It allows to specify the subject of search (or replace) and mode of operation.

 

Figure 3 - Search And Replace Dialog

Input Fields

  • Find what - searched text
  • Replace with - a new text that will replace the searched text in replace function.

Options

  • Case sensitive - When checked, the case of letter of the searched text has to match.
  • Whole words only - The searched text is found only as a whole word.
  • Backward - direction of the search.
  • Prompt on replace - specifies if the user will be asked about each item replacement during the replace process. (This option is available only if any replacement text is entered).

Scope

  • Entire text - Entire text will be scanned.
  • From cursor - Text from cursor to the end of file will be scanned only.
  • Selected text - The current selection will be scanned only.

Buttons

  • Find Next - Invokes the search process. The cursor will be placed on the next occurrence of the searched text. If the find/replace operations have not been done yet, the first occurrence of the text is found.
  • Find All Files - Invokes the search process within all opened files. Places cursor in each file on the last occurrence of the searched text within the file.
  • Replace - A next occurrence of the searched text is searched and if found, it is replaced by the replacement text.
  • Replace All - All occurrences of the text within the current file are replaced by the searched text.

Comparison Mode

File editor in this mode has two panels showing a differences between the compared files. The different lines are highlighted with the light-yellow color and the different characters are red. The lines added to the file have a green background. To speed-up navigation between changes, the editor offer the arrow buttons on the toolbar. Pressing the right/left arrow button will move the cursor to the next/previous difference in the file.
This mode can be invoked automatically by Processor Expert in a case of comparing a bean modules with previously generated ones ( See chapter Beans Pop-up Menus for details. ) or by a 'DIFF' button when a changes tracking is enabled ( See chapter Tracking Changes in Generated Code for details. )

 

Figure 4 - The comparison mode of editor

 

 

[top of page]