Skip to content
This repository was archived by the owner on May 23, 2022. It is now read-only.

DRAFT 0.6.12 release notes #247

Merged
lsgunnlsgunn merged 3 commits into from
Oct 15, 2020
Merged

DRAFT 0.6.12 release notes #247

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
16a35bc
DRAFT 0.6.12 release notes
lsgunnlsgunn Oct 14, 2020
0272d6a
Change 0.6.11 to 0.6.12
lsgunnlsgunn Oct 15, 2020
ef27066
Formatting of command
lsgunnlsgunn Oct 15, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion modules/developers-guide/examples/define-actor-dfx.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
"packtool": ""
}
},
"dfx": "0.6.11",
"dfx": "0.6.12",
"networks": {
"local": {
"bind": "127.0.0.1:8000",
Expand Down
2 changes: 1 addition & 1 deletion modules/developers-guide/examples/multiple-actors/dfx.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
"packtool": ""
}
},
"dfx": "0.6.11",
"dfx": "0.6.12",
"networks": {
"local": {
"bind": "127.0.0.1:8000",
Expand Down
2 changes: 1 addition & 1 deletion modules/developers-guide/examples/sample-0.6.2-dfx.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
"packtool": ""
}
},
"dfx": "0.6.11",
"dfx": "0.6.12",
"networks": {
"local": {
"bind": "127.0.0.1:8000",
Expand Down
2 changes: 1 addition & 1 deletion modules/developers-guide/examples/sample-dfx.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@
}
},

"dfx": "0.6.11",
"dfx": "0.6.12",
"networks": {
"local": {
"bind": "127.0.0.1:8000",
Expand Down
2 changes: 1 addition & 1 deletion modules/developers-guide/pages/install-upgrade-remove.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ The following table describes the development environment components that the in

The `~/.cache/dfinity/versions` directory stores one or more versioned subdirectories of the {sdk-short-name}.
Each versioned subdirectory contains the all of the directories and files required for a specific version of the {sdk-short-name}.
For example, if you list the contents of the `~/.cache/dfinity/versions/0.6.11` directory you would see the following core components:
For example, if you list the contents of the `~/.cache/dfinity/versions/0.6.12` directory you would see the following core components:

....
total 338216
Expand Down
2 changes: 1 addition & 1 deletion modules/quickstart/pages/dfx-deploy-quickstart.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ The command displays version information for the developer command-line interfac
+
[source,bash]
----
dfx 0.6.11
dfx 0.6.12
----
. Preview usage information for the developer command-line interface (`+dfx+`) commands by running the following command:
+
Expand Down
2 changes: 1 addition & 1 deletion modules/quickstart/pages/quickstart.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ dfx --version
The command displays version information for the `+dfx+` command-line executable similar to the following:
+
....
dfx 0.6.11
dfx 0.6.12
....
. Preview usage information for the other `+dfx+` command-line sub-commands by running the following command:
+
Expand Down
55 changes: 48 additions & 7 deletions modules/release-notes/pages/sdk-release-notes.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
:page-layout: releasenotes
:sdk-short-name: DFINITY Canister SDK
:sdk-long-name: DFINITY Canister Software Development Kit (SDK)
:release: 0.6.11
:release: 0.6.12
ifdef::env-github,env-browser[:outfilesuffix:.adoc]

The {sdk-long-name} enables developers to develop applications for the {IC} using the {proglang} programing language.
Expand All @@ -33,15 +33,56 @@ This {release} version of the software and programming language should not be us

== Highlights of what's new in {release}

The {release} release includes both user-visible new features and internal enhancements and fixes. The most significant new features and capabilities include the following:
The {release} release includes both user-visible new features and internal enhancements and fixes. The most significant new features and fixes include the following:

* You can now access the {IC} network running remotely without user name and password credentials using the new `+ic+` network alias.
+
In previous releases, the network alias `+tungsten+` was pre-configured in the project `+dfx.json+` file.
With authorized credentials, you could then use this network alias to access to the {IC} network when running `+dfx+` commands by using the `+--network=tungsten+` option.
Copy link
Contributor

@ggreif ggreif Oct 14, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shouldn't tungsten be ic here?

Copy link
Contributor Author

@lsgunnlsgunn lsgunnlsgunn Oct 15, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One paragraph is about the previous state of affairs (using tungsten) and one paragraph is about the new state of affairs (ic), so that (hopefully) people who had been on tungsten see the difference.

BTW, I was expecting the Random.mo module to be in either 0.6.11 or 0.6.12, but it doesn't seem like it has been picked up. I just installed 0.6.12, for example, and ExperimentalFunds.mo is there but Random.mo isn't:

-r-x------   1 lisagunn  staff    811 Dec 31  1969 Prelude.mo
-r-x------   1 lisagunn  staff   1332 Dec 31  1969 Principal.mo
-r-x------   1 lisagunn  staff   5815 Dec 31  1969 RBTree.mo
-r-x------   1 lisagunn  staff   4325 Dec 31  1969 Result.mo
-r-x------   1 lisagunn  staff    886 Dec 31  1969 Stack.mo

It seems like it should have been picked up by now. Maybe this is worth looking into?

Copy link
Contributor

@ggreif ggreif Oct 15, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@chenyan-dfinity Random.mo is on both the master and next-moc branches. Maybe the dfx build didn't bump the base lib?

Copy link
Contributor

@chenyan-dfinity chenyan-dfinity Oct 15, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It was merged in motoko repo today: caffeinelabs/motoko#2044. Probably because mergify was not working last week.

+
In this release, the `+ic+` network alias is pre-configured in the project `+dfx.json+` file to replace the `+tungsten+` alias.
In addition, you are no longer required to provide a user name and password as credentials to authenticate your identity.
Instead, you can access the {IC} network when running `+dfx+` commands simply by using the new `+ic+` network alias.
For example, to register, build, and deploy an application on the {IC}, you can run the following command:
+
....
dfx deploy --network=ic
....
+
Note that the `+ic+` network alias is a reserved alias.
Although you can add other network providers to your `+dfx.json+` file, you cannot use the `+ic+` alias for those providers.
You can, however, use variations on the reserved name such as `+ic-pubs+` or `+ic-examplenet+`.

* Error and status messages are decoded and displayed as human-readable text.
+
Previously, some agent and HTTP error and status messages were returned in an encoded format.
With this release, these agent and HTTP status messages are properly decoded and displayed as human-readable plain text.

* This release of {proglang} improves stability of +`Blob+` and `+Text+` iterators when garbage collection happens.

* This release of {proglang} fixes some erroneous-reported type errors related to using `+break+` in the context of an unconditional `+loop+`.
+
For example, {proglang} supports the following to break out of a loop without type errors:
+
....
label l : Int loop { break l(42) };
....

For information about breaking changes that were introduced in previous releases, see <<Breaking changes>>.

For information about known issues that were introduced in previous releases, see <<Known issues and limitations>>.

=== Highlights of what's new in 0.6.11

The 0.6.11 release includes both user-visible new features and internal enhancements and fixes. The most significant new features and capabilities include the following:

* You can now specify arguments on the command-line when you deploy a **single** canister using an actor class with the `+dfx deploy+` command.

* Improved handling of `+SIGINT+` and `+SIGTERM+` events ensures that Ctrl-C can now reliably shut down the {IC} network `+replica+` process when running the {IC} locally.
* Improved handling of `+SIGINT+` and `+SIGTERM+` events ensures that Ctrl-C can now reliably shut down the {IC} network `+replica+` process when running the {IC} locally.

* Enable the `+dfx start+` and `+dfx bootstrap+` commands to start the {IC} using a randomly-selected webserver port.
+
To use a randomly-selected port, you can specify `+0+` as the port when running `+dfx start+` or `+dfx bootstrap+` commands.
To use a randomly-selected port, you can specify `+0+` as the port when running `+dfx start+` or `+dfx bootstrap+` commands.
For example:
+
....
Expand Down Expand Up @@ -170,7 +211,7 @@ This new support for multiple identities enables you to test role-based access c
+
** Support for polymorphic equality that enables the `==` and `!=` operators to work on all shareable types.
** Improvements to catch clashing function and class declarations.
** Language support to enable canisters to take installation arguments. An actor **class** defines a canister that takes an argument on installation.
** Language support to enable canisters to take installation arguments. An actor **class** defines a canister that takes an argument on installation.
** Optimized backend handling for `Bool` data types.

=== Highlights of what's new in 0.6.6
Expand Down Expand Up @@ -198,7 +239,7 @@ The 0.6.3 release only included minor fixes and enhancements including the follo
- The `+dfx start --clean+` command has been improved to no longer crash if you run the command in a project that is already in a clean state.
+
Without this fix, manually removing the directories the command is intended to delete would result in `+dfx+` exiting without restarting the {IC}.
- The parsing logic for the `+dfx canister call+` command has been improved to more consistently recognize arguments in Candid format and to return better error messages when argument formats are not recognized.
- The parsing logic for the `+dfx canister call+` command has been improved to more consistently recognize arguments in Candid format and to return better error messages when argument formats are not recognized.
- The Welcome page displayed when you create a new project has been updated to reflect the current location of SDK and Motoko documentation.

[[highlights]]
Expand Down Expand Up @@ -261,7 +302,7 @@ The following sections describe the key features and enhancements that were intr
+
** The `+motoko+` canister type uses the `+motoko+` (`+moc+`) compiler to build a canister.
+
** The `+assets+` canister type uses `+npm run build+` by default to build files and uploads them to an asset canister.
** The `+assets+` canister type uses `+npm run build+` by default to build files and uploads them to an asset canister.
+
** The `+custom+` canister type uses a custom builder that should output WebAssembly (WASM) and Candid (DID) files.
- The `+dfx.json+` file includes network mapping for `+local+` and the {IC} network. The local network defaults to `+127.0.0.1:8000+`.
Expand Down