Rename Refactoring

To rename an entity (type, method, macro etc.) in the source code along with all its references, place the cursor on the desired element, then right click and select Refactor > Rename (or use the shortcut combination Shift + Alt + R).

You will be prompted for the new name of the entity:

../../_images/vlogdt-refactoring-rename-newname.png

Click OK to perform the refactoring, or Preview to see the changes that are about to be performed in the source code. In the Preview page you can select the changes that should be performed. After you click Finish the changes are performed, and the project is rebuilt.

../../_images/vlogdt-refactoring-rename-preview.png
  1. Select a file/change to see the source differences produced by the refactoring.

  2. Uncheck a file/change to prevent those changes from being applied.

Tip

Matches hidden inside a macro call cannot be automatically renamed. Instead, DVT will insert a FIXME comment above the macro call to indicate that it should be refactored by hand.

Hidden matches are those matches found inside a macro call expansion, but not among the macro call parameters.

../../_images/vlogdt-refactoring-rename-macro-call.png

Tip

DVT can also rename matches found in JavaDoc-like annotations, such as @link, @param and @see. This feature is disabled by default, to enable it go to Window > Preferences > DVT > SystemVerilog > Refactoring and untick the Ignore JavaDoc comments box.

Tip

You can limit the scope of Rename Refactoring to the current file, see Rename in File.