|
|
@@ -92,6 +92,35 @@ Host prerequisites (not bundled): GNU Modula-2 (`gm2`), `gdb` and `readelf`
|
|
|
for build/run/debug. On Debian/Ubuntu the IDE itself needs only FUSE (or
|
|
|
`APPIMAGE_EXTRACT_AND_RUN=1`) to launch the AppImage.
|
|
|
|
|
|
+## Standalone language plugin (`modula2-language-0.1.5.zip`)
|
|
|
+
|
|
|
+For editors other than the packaged IDE, the VS Code-compatible language
|
|
|
+extension ships as a self-contained zip (compiled server, grammars,
|
|
|
+snippets, docs, plus its runtime dependencies — no dev files, no
|
|
|
+`gm2`/`gdb` required for editing features):
|
|
|
+
|
|
|
+```bash
|
|
|
+unzip modula2-language-0.1.5.zip -d /tmp/m2plugin # yields modula2-language/
|
|
|
+```
|
|
|
+
|
|
|
+- **VS Code / VSCodium**: copy (not the zip itself) into the extensions
|
|
|
+ folder and restart:
|
|
|
+ ```bash
|
|
|
+ cp -r /tmp/m2plugin/modula2-language ~/.vscode/extensions/
|
|
|
+ # VSCodium: ~/.vscode-oss/extensions/
|
|
|
+ ```
|
|
|
+- **Any Theia application**: point it at the *parent* folder:
|
|
|
+ ```bash
|
|
|
+ THEIA_PLUGINS=local-dir:/tmp/m2plugin <theia-launch-command>
|
|
|
+ ```
|
|
|
+
|
|
|
+You get `.mod`/`.def` highlighting, outline, completion, hover,
|
|
|
+go-to-definition, references, rename, formatting (document + selection),
|
|
|
+semantic highlighting and zero-false-positive diagnostics. Building,
|
|
|
+running and debugging Modula-2 programs additionally need `gm2`
|
|
|
+(and `gdb` for debugging) on `PATH`; the optional external validator
|
|
|
+(`modula2.cocoR.validatorCommand`) stays off unless configured.
|
|
|
+
|
|
|
## Roadmap
|
|
|
|
|
|
1. Stabilize the GNU Modula-2/Coco/R grammar against `gm2` (see `GNU-grammar`).
|
