Skip to content

Commit

Permalink
[Changelog] Update the changelog for the 0.11.2 release.
Browse files Browse the repository at this point in the history
Signed-off-by: YiYing He <yiying@secondstate.io>
  • Loading branch information
q82419 committed Nov 3, 2022
1 parent 38fbc1b commit e19b597
Show file tree
Hide file tree
Showing 5 changed files with 66 additions and 32 deletions.
8 changes: 4 additions & 4 deletions .CurrentChangelog.md
@@ -1,4 +1,4 @@
### 0.11.2-rc.3 (2022-11-01)
### 0.11.2 (2022-11-03)

Features:

Expand All @@ -14,7 +14,7 @@ Features:
* Users can refer to the [WASI-NN document](https://wasmedge.org/book/en/write_wasm/rust/wasinn.html) for the information.
* For building with enabling WASI-NN with TensorFlow-Lite backend, please add the `-DWASMEDGE_PLUGIN_WASI_NN_BACKEND="TensorFlowLite"` in `cmake`.
* Bump the `fmt` format of logging to `9.0.0`.
* Add the new experimental edge-triggered epoll API `epollOneoff` in the WASI component.
* Added the new experimental edge-triggered epoll API `epollOneoff` in the WASI component.

Fixed issues:

Expand Down Expand Up @@ -60,6 +60,6 @@ Tests:

Thank all the contributors that made this release possible!

Abhinandan Udupa, Gustavo Ye, HangedFish, Harry Chiang, Hiroaki Nakamura, Kenvi Zhu, LFsWang, Shen-Ta Hsieh, Shreyas Atre, Xin Liu, YiYing He, abhinandanudupa, dm4, he11c, hydai, vincent, yyy1000, zhlhahaha
Abhinandan Udupa, Gustavo Ye, HangedFish, Harry Chiang, Hiroaki Nakamura, Kenvi Zhu, LFsWang, MediosZ, Shen-Ta Hsieh, Shreyas Atre, Xin Liu, YiYing He, abhinandanudupa, dm4, he11c, hydai, vincent, yyy1000, zhlhahaha

If you want to build from source, please use WasmEdge-0.11.2-rc.3-src.tar.gz instead of the zip or tarball provided by GitHub directly.
If you want to build from source, please use WasmEdge-0.11.2-src.tar.gz instead of the zip or tarball provided by GitHub directly.
8 changes: 4 additions & 4 deletions Changelog.md
@@ -1,4 +1,4 @@
### 0.11.2-rc.2 (2022-10-31)
### 0.11.2 (2022-11-03)

Features:

Expand All @@ -14,7 +14,7 @@ Features:
* Users can refer to the [WASI-NN document](https://wasmedge.org/book/en/write_wasm/rust/wasinn.html) for the information.
* For building with enabling WASI-NN with TensorFlow-Lite backend, please add the `-DWASMEDGE_PLUGIN_WASI_NN_BACKEND="TensorFlowLite"` in `cmake`.
* Bump the `fmt` format of logging to `9.0.0`.
* Add the new experimental edge-triggered epoll API `epollOneoff` in the WASI component.
* Added the new experimental edge-triggered epoll API `epollOneoff` in the WASI component.

Fixed issues:

Expand Down Expand Up @@ -60,9 +60,9 @@ Tests:

Thank all the contributors that made this release possible!

Abhinandan Udupa, Gustavo Ye, HangedFish, Harry Chiang, Hiroaki Nakamura, Kenvi Zhu, LFsWang, Shen-Ta Hsieh, Shreyas Atre, Xin Liu, YiYing He, abhinandanudupa, dm4, he11c, hydai, vincent, yyy1000, zhlhahaha
Abhinandan Udupa, Gustavo Ye, HangedFish, Harry Chiang, Hiroaki Nakamura, Kenvi Zhu, LFsWang, MediosZ, Shen-Ta Hsieh, Shreyas Atre, Xin Liu, YiYing He, abhinandanudupa, dm4, he11c, hydai, vincent, yyy1000, zhlhahaha

If you want to build from source, please use WasmEdge-0.11.2-rc.3-src.tar.gz instead of the zip or tarball provided by GitHub directly.
If you want to build from source, please use WasmEdge-0.11.2-src.tar.gz instead of the zip or tarball provided by GitHub directly.

### 0.11.1 (2022-10-03)

Expand Down
2 changes: 1 addition & 1 deletion docs/book/en/book.toml
Expand Up @@ -162,4 +162,4 @@ copy-js = true
"/extend/build_for_android.html" = "/book/en/contribute/build_from_src/android.html"

[preprocessor.variables.variables]
wasmedge_version = "0.11.1"
wasmedge_version = "0.11.2"
28 changes: 22 additions & 6 deletions docs/book/en/src/sdk/c/ref.md
@@ -1,12 +1,12 @@
# WasmEdge C 0.11.1 API Documentation
# WasmEdge C 0.11.2 API Documentation

[WasmEdge C API](https://github.com/WasmEdge/WasmEdge/blob/master/include/api/wasmedge/wasmedge.h) denotes an interface to access the WasmEdge runtime. The followings are the guides to working with the C APIs of WasmEdge.

**Please notice that the WasmEdge C API provides SONAME and SOVERSION after the `0.11.0` release.**

**Please notice that `libwasmedge_c.so` is renamed to `libwasmedge.so` after the `0.11.0` release. Please use `-lwasmedge` instead of `-lwasmedge_c` for the linker option.**

**This document is for the `0.11.1` version. For the older `0.10.1` version, please refer to the [document here](0.10.1/ref.md).**
**This document is for the `0.11.2` version. For the older `0.10.1` version, please refer to the [document here](0.10.1/ref.md).**

**Developers can refer to [here to upgrade to 0.11.0](0.10.1/upgrade_to_0.11.0.md).**

Expand Down Expand Up @@ -56,7 +56,7 @@
The easiest way to install WasmEdge is to run the following command. Your system should have `git` and `wget` as prerequisites.

```bash
curl -sSf https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install.sh | bash -s -- -v 0.11.1
curl -sSf https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install.sh | bash -s -- -v 0.11.2
```

For more details, please refer to the [Installation Guide](../../quick_start/install.md) for the WasmEdge installation.
Expand Down Expand Up @@ -86,7 +86,7 @@ After the installation of WasmEdge, the following guide can help you to test for

```bash
$ ./a.out
WasmEdge version: 0.11.1
WasmEdge version: 0.11.2
```

### ABI Compatibility
Expand Down Expand Up @@ -120,6 +120,8 @@ printf("WasmEdge version patch: %u\n", WasmEdge_VersionGetPatch());
The `WasmEdge_LogSetErrorLevel()` and `WasmEdge_LogSetDebugLevel()` APIs can set the logging system to debug level or error level. By default, the error level is set, and the debug info is hidden.
Developers can also use the `WasmEdge_LogOff()` API to disable all logging. (`0.11.2` or upper only)
### Value Types
In WasmEdge, developers should convert the values to `WasmEdge_Value` objects through APIs for matching to the WASM value types.
Expand Down Expand Up @@ -646,7 +648,21 @@ Developers can adjust the settings about the proposals, VM host pre-registration
WasmEdge_ConfigureDelete(ConfCxt);
```

4. AOT compiler options
4. Forcibly interpreter mode (`0.11.2` or upper only)

If developers want to execute the WASM file or the AOT compiled WASM in interpreter mode forcibly, they can turn on the configuration.

```c
WasmEdge_ConfigureContext *ConfCxt = WasmEdge_ConfigureCreate();
bool IsForceInterp = WasmEdge_ConfigureIsForceInterpreter(ConfCxt);
/* By default, The `IsForceInterp` will be `FALSE`. */
WasmEdge_ConfigureSetForceInterpreter(ConfCxt, TRUE);
IsForceInterp = WasmEdge_ConfigureIsForceInterpreter(ConfCxt);
/* The `IsForceInterp` will be `TRUE`. */
WasmEdge_ConfigureDelete(ConfCxt);
```

5. AOT compiler options

The AOT compiler options configure the behavior about optimization level, output format, dump IR, and generic binary.

Expand Down Expand Up @@ -697,7 +713,7 @@ Developers can adjust the settings about the proposals, VM host pre-registration
WasmEdge_ConfigureDelete(ConfCxt);
```

5. Statistics options
6. Statistics options

The statistics options configure the behavior about instruction counting, cost measuring, and time measuring in both runtime and AOT compiler.
These configurations are effective in `Compiler`, `VM`, and `Executor` contexts.
Expand Down
52 changes: 35 additions & 17 deletions docs/book/en/src/sdk/go/ref.md
@@ -1,8 +1,8 @@
# WasmEdge Go v0.11.1 API references
# WasmEdge Go v0.11.2 API references

The followings are the guides to working with the WasmEdge-Go SDK.

**This document is for the `v0.11.1` version. For the older `v0.10.1` version, please refer to the [document here](0.10.1/ref.md).**
**This document is for the `v0.11.2` version. For the older `v0.10.1` version, please refer to the [document here](0.10.1/ref.md).**

**Developers can refer to [here to upgrade to v0.11.0](0.10.1/upgrade_to_0.11.0.md).**

Expand Down Expand Up @@ -59,13 +59,13 @@ go version go1.16.5 linux/amd64
Developers must [install the WasmEdge shared library](../../quick_start/install.md) with the same `WasmEdge-go` release or pre-release version.

```bash
curl -sSf https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install.sh | bash -s -- -v 0.11.1
curl -sSf https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install.sh | bash -s -- -v 0.11.2
```

For the developers need the `TensorFlow` or `Image` extension for `WasmEdge-go`, please install the `WasmEdge` with extensions:

```bash
curl -sSf https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install.sh | bash -s -- -e tf,image -v 0.11.1
curl -sSf https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install.sh | bash -s -- -e tf,image -v 0.11.2
```

Noticed that the `TensorFlow` and `Image` extensions are only for the `Linux` platforms.
Expand All @@ -76,7 +76,7 @@ After installation, developers can use the `source` command to update the includ
After the WasmEdge installation, developers can get the `WasmEdge-go` package and build it in your Go project directory.

```bash
go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.1
go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.2
go build
```

Expand Down Expand Up @@ -147,6 +147,8 @@ verpatch := wasmedge.GetVersionPatch() // Will be `uint` of WasmEdge patch versi

The `wasmedge.SetLogErrorLevel()` and `wasmedge.SetLogDebugLevel()` APIs can set the logging system to debug level or error level. By default, the error level is set, and the debug info is hidden.

Developers can also use the `wasmedge.SetLogOff()` API to disable all logging. (`v0.11.2` or upper only)

### Value Types

In WasmEdge-go, the APIs will automatically do the conversion for the built-in types, and implement the data structure for the reference types.
Expand Down Expand Up @@ -535,13 +537,29 @@ Developers can adjust the settings about the proposals, VM host pre-registration
pagesize := conf.GetMaxMemoryPage()
// By default, the maximum memory page size in each memory instances is 65536.
conf.SetMaxMemoryPage(1234)
pagesize := conf.GetMaxMemoryPage()
pagesize = conf.GetMaxMemoryPage()
// `pagesize` will be 1234.

conf.Release()
```

4. AOT compiler options
4. Forcibly interpreter mode (`v0.11.2` or upper only)

If developers want to execute the WASM file or the AOT compiled WASM in interpreter mode forcibly, they can turn on the configuration.

```go
conf := wasmedge.NewConfigure()

is_forceinterp := conf.IsForceInterpreter()
// By default, the `is_forceinterp` will be `false`.
conf.SetForceInterpreter(true)
is_forceinterp = conf.IsForceInterpreter()
/* The `is_forceinterp` will be `true`. */

conf.Release()
```

5. AOT compiler options

The AOT compiler options configure the behavior about optimization level, output format, dump IR, and generic binary.

Expand Down Expand Up @@ -586,7 +604,7 @@ Developers can adjust the settings about the proposals, VM host pre-registration
conf.Release()
```

5. Statistics options
6. Statistics options

The statistics options configure the behavior about instruction counting, cost measuring, and time measuring in both runtime and AOT compiler.
These configurations are effective in `Compiler`, `VM`, and `Executor` objects.
Expand Down Expand Up @@ -760,7 +778,7 @@ This example uses the [fibonacci.wasm](https://raw.githubusercontent.com/WasmEdg
Then you can build and run the Golang application with the WasmEdge Golang SDK: (the 21 Fibonacci number is 17711 in 0-based index)

```bash
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.1
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.2
$ go build
$ ./wasmedge_test
Get fibonacci[21]: 17711
Expand Down Expand Up @@ -1100,7 +1118,7 @@ WasmEdge VM provides APIs for developers to register and export any WASM modules
Then you can build and run: (the 25th Fibonacci number is 121393 in 0-based index)

```bash
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.1
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.2
$ go build
$ ./wasmedge_test
Get fibonacci[25]: 121393
Expand Down Expand Up @@ -1150,7 +1168,7 @@ WasmEdge VM provides APIs for developers to register and export any WASM modules
Then you can build and run: (the 20th Fibonacci number is 10946 in 0-based index)

```bash
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.1
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.2
$ go build
$ ./wasmedge_test
Get the result: 10946
Expand Down Expand Up @@ -1217,7 +1235,7 @@ WasmEdge VM provides APIs for developers to register and export any WASM modules
Then you can build and run: (the 25th Fibonacci number is 121393 in 0-based index)

```bash
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.1
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.2
$ go build
$ ./wasmedge_test
Get the result: 121393
Expand Down Expand Up @@ -1319,7 +1337,7 @@ The `VM` object supplies the APIs to retrieve the instances.
Then you can build and run: (the only exported function in `fibonacci.wasm` is `fib`)

```bash
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.1
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.2
$ go build
$ ./wasmedge_test
Exported function name: fib
Expand Down Expand Up @@ -1477,7 +1495,7 @@ func main() {
Then you can build and run: (the 18th Fibonacci number is 1346269 in 30-based index)

```bash
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.1
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.2
$ go build
$ ./wasmedge_test
Exported function name: fib
Expand Down Expand Up @@ -2088,7 +2106,7 @@ In WasmEdge-go, developers can create the `Function`, `Memory`, `Table`, and `Gl
Then you can build and run the Golang application with the WasmEdge Golang SDK:

```bash
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.1
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.2
$ go build
$ ./wasmedge_test
[2022-08-26 15:06:40.384] [error] user defined failed: user defined error code, Code: 0x15be
Expand Down Expand Up @@ -2304,7 +2322,7 @@ In WasmEdge-go, developers can create the `Function`, `Memory`, `Table`, and `Gl
Then you can build and run the Golang application with the WasmEdge Golang SDK:

```bash
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.1
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.2
$ go build
$ ./wasmedge_test
Get the result: 6912
Expand Down Expand Up @@ -2408,7 +2426,7 @@ In WasmEdge-go, developers can create the `Function`, `Memory`, `Table`, and `Gl
Then you can build and run the Golang application with the WasmEdge Golang SDK:

```bash
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.1
$ go get github.com/second-state/WasmEdge-go/wasmedge@v0.11.2
$ go build
$ ./wasmedge_test
Get the result: 6912
Expand Down

0 comments on commit e19b597

Please sign in to comment.