Skip to content

Commit 471c729

Browse files
Updated documents for MVVS-2.7.1
1 parent eac8356 commit 471c729

File tree

4 files changed

+82
-5
lines changed

4 files changed

+82
-5
lines changed

docs/img/lang_mode.png

127 KB
Loading

docs/usage/CHANGELOG.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,10 @@
11
# Change Log
22

3+
## Version 2.7.1: June 04, 2025
4+
- Added VS Code language auto-detection (online mode)
5+
- Auto-close files on server disconnect in online mode
6+
- Customer bug fixes
7+
38
## Version 2.7.0: April 22, 2025
49
- Separate compile and catalog option
510
- Support for debugging BASIC program files in online editing mode. (support with UV 11.4.1 and upcoming 14.2.1)

docs/usage/Debugging.md

Lines changed: 19 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Versions: For offline mode debugging 8.2.4 or higher and for online mode debuggi
1616

1717
Platforms: Windows, Linux, AIX
1818

19+
**Note:** For more details, please refer [Rocket-MV-BASIC-Extension-features-support-matrix](https://my.rocketsoftware.com/RocketCommunity/s/article/Rocket-MV-BASIC-Extension-features-support-matrix).
20+
1921
### A high performance debugging feature
2022

2123
A high-performance debugging feature is supported on UniVerse 11.4.1 and UniData 8.3.1. To use this feature, you must upgrade to UniVerse 11.4.1 / UniData 8.3.1 or higher version. Please see [Debugging Binaries Releases](./DAPRelease.md) for more details.
@@ -40,7 +42,7 @@ Before debugging, open the BASIC program first.
4042

4143
### Debugging without a launch file
4244
> **Note** :
43-
> Debugging without a launch file works properly in offline mode only; in online mode, the behavior is uncertain.
45+
> Debugging without a launch file works properly in offline mode only; in online mode, please create launch file.
4446
4547
- Click the **Run and Debug** icon on from the left menu bar. The **Run and Debug** view will display if you have no `launch.json` file in your project.
4648

@@ -55,7 +57,17 @@ On successful compilation, the debugging process will stop at the first runnable
5557

5658
### Debug with launch file
5759

58-
You can also configure a `launch.json` file for debugging.
60+
You have the option to configure the type and task parameters in the launch.json file which helps VS Code know how to run and debug your code.
61+
62+
`launch.json` file helps VSCode know how to run and debug your code.
63+
64+
`launch.json` in MVVS has the type and task parameters, it means that VSCode is first running a task before starting the debugging process.
65+
66+
type: The type parameter tells VS Code what type of code you're working with. Valid values are: MVBasic, Python.
67+
68+
task: The task parameter is a step that needs to happen before debugging starts, like preparing your code.
69+
70+
You have the option to tell VS Code which debugging settings to use in the launch.json file.
5971

6072
In the **Run and Debug** view, click the create a `launch.json` file link.
6173

@@ -65,7 +77,7 @@ Select the **MVBasic Debug** from the Select environment dialog box.
6577

6678
![](../img/debug_type.png)
6779

68-
Then a default debugging configuration file launch.json will be generated in directory .vscode.
80+
A default debugging configuration file named launch.json is generated in directory .vscode and contains the following.
6981

7082
```
7183
{
@@ -94,7 +106,10 @@ Then a default debugging configuration file launch.json will be generated in dir
94106
- "dependencies": put other BASIC program files' absolute paths here if they need to be compiled before debugging. For example, "C:\U2\UV\XDEMO\TEST".
95107
- "arguments": put additional debugging online· here. Please refer to your UniVerse / UniData user documentation for more details. By default, this setting doesn’t appear in the configuration file, but can be added manually if needed.
96108

97-
For online mode create build task as mentioned in [Online Editing](./OnlineEditing.md)
109+
>#### To enable debugging in online mode, the `tasks.json` file is required.
110+
>For online mode, create a build task as shown in [Online Editing](./OnlineEditing.md).
111+
>
112+
>For more details on task refer [Compile](./Compile.md).
98113
99114
From the **Run and Debug** view, set the launch option to **Launch Program**. Then press the F5 button to start debugging.
100115

docs/usage/OnlineEditing.md

Lines changed: 58 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,64 @@ In the Search option, enter the file name pattern you want to match. Pattern mat
142142

143143
Once connected to a U2 server, you can expand the server node to access and view the BASIC program files stored on that server.
144144

145-
![](../img/online_editing_edit_open.png)
145+
When you open a program file for editing, the MVVS extension automatically detects the language based on the file extension:
146+
147+
- Files with a `.py` extension are recognized as **Python**.
148+
- Files with a `.json` extension are recognized as **JSON**.
149+
- **BASIC files**, however, are **not auto-detected** and you must manually set the language mode to **Rocket MV BASIC**.
150+
151+
There are **three ways** to set the language mode for BASIC files:
152+
153+
#### 1. Configure language association in `settings.json`
154+
155+
You can configure VS Code to recognize BASIC files by associating filepaths or names with the Rocket MV BASIC language.
156+
157+
- **To apply the language mode to all files under the `BP` folder**:
158+
```json
159+
"files.associations": {
160+
"**/BP/**": "rocket-mvbasic"
161+
}
162+
- **To apply it to a specific file, such as TESTSUM**:
163+
```json
164+
"files.associations": {
165+
"TESTSUM": "rocket-mvbasic"
166+
}
167+
- **Full example configuration:**:
168+
```json
169+
{
170+
"[rocket-mvbasic]": {
171+
"editor.codeLens": false
172+
},
173+
"files.associations": {
174+
"**/BP/**": "rocket-mvbasic",
175+
"**/.rmv/config/*.json": "jsonc"
176+
},
177+
"files.exclude": {
178+
"**/.git": true,
179+
"**/.svn": true,
180+
"**/.hg": true,
181+
"**/CVS": true,
182+
"**/.DS_Store": true,
183+
"**/Thumbs.db": true,
184+
"**/.rmv/catalog/**": true,
185+
"*/_*": false
186+
}
187+
}
188+
#### 2. Use the Command Palette
189+
You can manually change the language mode using the VS Code Command Palette:
190+
191+
1. Press Ctrl+Shift+P to open the Command Palette.
192+
2. Type and select “Change Language Mode”.
193+
3. Choose “Rocket MV BASIC” from the list of languages.
194+
195+
#### 3. Use the status bar language selector
196+
You can also change the language mode via the status bar.
197+
At the bottom-right of VS Code, you'll see the current language mode, for example, Plain Text, JSON.
198+
199+
1. Click on the current language mode. A language selection menu displays.
200+
2. Select Rocket MV BASIC from the list.
201+
202+
![](../img/lang_mode.png)
146203

147204
You can also Add or Delete BASIC files:
148205

0 commit comments

Comments
 (0)