Delphi-RAG-Lint

drag-lint help

ghost-recover

Since: 0.64.1-alpha

Scans a project's hidden D-RAG folder for recovery journals left behind when a ghost-check overlay was interrupted by a crash.

Read this after a crash during a buffer compile (ghost-check), so no unit is left holding unsaved-buffer content. ghost-recover finds leftover recovery journals under the project D-RAG folder and restores each file; it prints that nothing is pending when all is clean.

How to run it

Full flag list: ghost-recover in the CLI reference.

Where to click

  • drag-lint About window, button Recover Buffer-Compile Files

Details

Scans a project's hidden _D-RAG folder for recovery journals left behind when a ghost-check overlay was interrupted by a crash, and restores each affected file to its saved original content. Reach for it (or let the IDE run it automatically) after a crash during a buffer-compile, so no unit is left holding overlaid (unsaved-buffer) content.

Running it from the CLI

Running the verb bare (no arguments) does not print a usage banner; it runs immediately and prints ghost-recover: nothing pending. (exit 0) when there is no recovery journal, or ghost-recover: N file(s) restored. after acting. Passing --help or any unrecognized flag produces FATAL: Exception: Unknown argument: <flag> -- no other flags are documented.

The plugin invokes it as:

drag-lint ghost-recover "<path-to-.dproj-or-folder>"

The single positional argument is optional; if omitted it defaults to the current directory.

Reaching it in the IDE

No menu item calls this by name directly; the feature map's "Recover Buffer-Compile Files" menu item is the user-facing action for it. The plugin's editor code (Editor.pas:2522) shells out to this verb, both on demand and automatically after a project loads, to restore any file left overlaid by a crashed ghost-check.

What it needs

Not needed, per the feature map's Index column.

Example

Illustrative only:

drag-lint ghost-recover C:\Projects\MyApp\MyApp.dproj

This would scan C:\Projects\MyApp\_D-RAG for ghost-check recovery journals and restore any affected file to its saved original content.


All features | CLI reference | IDE menus