Skip to content

Commit bf9e44a

Browse files
committedNov 4, 2020
update docs for release v0.6.0
1 parent 12d4e70 commit bf9e44a

File tree

4 files changed

+22
-5
lines changed

4 files changed

+22
-5
lines changed
 

‎CHANGELOG.md

+5
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,11 @@
22

33
## A VSCode Extension for learning DOS assembly(MASM/TASM) via DOSBox
44

5+
## 0.6.0
6+
7+
- 通过终端命令`open -a DOSBox --args `支持在MAC(darwin)中打开dosbox
8+
- 支持通过设置`masmtasm.dosbox.command`自定义用来打开DOSBox的命令
9+
510
## 0.5.x
611

712
- MASM插件更新到 `6.11`,最近在想如何支持`masm6.x`语法

‎README.md

+12-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# DOS assembly (MASM/TASM) via DOSBox(and msdos-player)
22

3-
[中文](https://github.com/xsro/masm-tasm/blob/main/doc/README_zh.md)|[English](https://github.com/xsro/masm-tasm/blob/main/README.md)
3+
[中文](https://github.com/xsro/masm-tasm/blob/main/doc/README_zh.md)|[English](https://github.com/xsro/masm-tasm/blob/main/README.md)|[more versions](https://github.com/xsro/masm-tasm/releases)
44

55
Language support for DOS assembly,may be suitable for studying MASM/TASM and the course <*principles& peripheral technology of microprocessor*>.
66

@@ -49,13 +49,23 @@ The extension offer some programmatic features like "hover","formate","jump to d
4949

5050
## For other system
5151

52-
The extension is packaged with all needed [tools](#about-tools) inside,but some of these tools are for windows. So **Linux and other OS** users *should* make sure DOSBox can be opened by shell command `dosbox` (node: child_process.exec("dosbox")). Use command like
52+
The extension is packaged with needed [tools](#about-tools) for windows inside while **other OS** users *should* make sure DOSBox can be opened by shell command.We can download DOSBox from its website:[DOSBox](https://www.dosbox.com)
53+
54+
For MacOS (Darwin),the extension will use command `open -a DOSBox --args` to open DOSBox. So you need to
55+
56+
1. download dmg file from [DOSBox's website](https://www.dosbox.com)
57+
2. Double-click the `.DMG` file to mount it. A new Finder window showing its contents should appear.
58+
3. double-click the mounted volume on your desktop and drag the app icon from there to the “Applications” icon in the Finder sidebar.
59+
60+
For Ubuntu and other linux system user,The extension will use shell command `dosbox` to open DOSBox. We can use command like this:
5361

5462
```sh
5563
sudo apt install dosbox #install dosbox
5664
dosbox #if successfully opened the dosbox, it is largely possible for the extension to use dosbox
5765
```
5866

67+
You can also use the setting ID `masmtasm.dosbox.command` to set your command for the extension to open DOSBox.
68+
5969
## Extension Settings
6070

6171
for more,please see the `preference->settings`

‎doc/README_zh.md

+4-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# 16位/32位汇编语言开发工具
22

3-
[中文](https://github.com/xsro/masm-tasm/blob/main/doc/README_zh.md)|[English](https://github.com/xsro/masm-tasm/blob/main/README.md)
3+
[中文](https://github.com/xsro/masm-tasm/blob/main/doc/README_zh.md)|[English](https://github.com/xsro/masm-tasm/blob/main/README.md)|[其他版本](https://github.com/xsro/masm-tasm/releases)
44

55
:raising_hand:在学习《微型计算机原理与接口技术》的**汇编语言**部分时,苦于没有比较顺手的编程环境,此插件实现了在VSCode中对DOSBox等汇编工具的快速调用。主要功能特性如下:
66

@@ -56,7 +56,9 @@ sudo apt install dosbox #安装dosbox
5656
dosbox #打开dosbox,假如成功打开dosbox则安装成功,那么插件插件也能调用
5757
```
5858

59-
理论上说只要能在命令行执行`dosbox`命令打开dosbox(nodejs 的child_process.exec(dosbox)命令),就可以使用本插件。
59+
- 对于MAC系统,安装DOSBox需要将下载的dmg文件双击打开,并把里面的文件DOSBox程序文件拖到mac的应用程序(application)文件夹中。插件将使用终端命令`open -a DOSBox --args`来启动DOSBox
60+
- 对于其他系统,理论上说只要能在命令行执行`dosbox`命令打开DOSBox(nodejs 的child_process.exec(dosbox)命令),就可以使用本插件了
61+
- 也可以设置`masmtasm.dosbox.command`来自定义打开DOSBox的命令
6062

6163
## :point_right:Extension Settings主要拓展设置
6264

‎package.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
"displayName": "MASM/TASM",
44
"publisher": "xsro",
55
"description": "DOS汇编语言开发环境和语法支持,win下安装即用,自带DOSBox.exe和TASM/MASM工具",
6-
"version": "0.5.4-webpack",
6+
"version": "0.6.0",
77
"keywords": [
88
"dosbox",
99
"16位",

0 commit comments

Comments
 (0)
Failed to load comments.