Rename Symbol
Renames a symbol across the whole indexed project.
How to run it
Full flag list: rename in the CLI reference.
Flags
| Flag | Argument | Meaning | Default |
|---|---|---|---|
--kind | |||
--name | <QName> | ||
--to | <New> | ||
--json | |||
--apply | |||
--no-backup | |||
--db | <db> |
Where to click
- RAD Studio main menu: drag-lint > Rename Symbol...
Needs: index
Details
Renames a symbol across the whole indexed project. Reach for it instead of a text find/replace when a symbol appears in many units, so every reference is updated together.
Reaching it in the IDE
drag-lint > Rename Symbol...
Keyboard shortcut: Ctrl+Alt+R.
Running it from the CLI
The feature map's Mechanism column marks this row "delegates" -- the menu
item runs the CLI rename verb rather than an in-process edit:
drag-lint rename --kind symbol --name <QName> --to <New> [--json|--apply|--no-backup] --db <db>Two related forms also exist: --kind param --file <F> --line <L> --col <C> --to <New> [...] for a routine-local parameter/var rename, and
--qname <Foo.TBar.Baz> --to <NewName> [--db PATH] [--dry-run] [--no-backup].
Without --apply (or with --dry-run), the run is a preview only.
Include files. The index records no references inside {$I} included
text yet (extractor 1.22). So when the old name is used as an identifier in an
.inc file the index holds (comments and string literals are ignored), both
the preview and --apply REFUSE with exit 2 and name the .inc file(s),
instead of renaming the declaration and leaving those uses stale. Rename the
include's uses by hand together with the declaration.
What it needs
An index IS required. The project's DB lives at
<project folder>\_D-RAG\<project file>.sqlite; run
drag-lint resolve-dbs --project <X.dproj> if unsure.
Example
Illustrative only:
drag-lint rename --kind symbol --name CustomerOrder.TCustomerOrder.Total --to GrandTotal --db C:\Projects\MyApp\_D-RAG\MyApp.sqlite --applyThis would rename Total to GrandTotal everywhere it is referenced in
the index.