[pkg/vm_snapshot_analysis] update the readme for tool name changes

Change-Id: I0ea1f228d7d3405b0da24858fd5f03aa7e2c8ce9
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/289442
Reviewed-by: Slava Egorov <vegorov@google.com>
Commit-Queue: Devon Carew <devoncarew@google.com>

pkg/vm_snapshot_analysis/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.7.3-dev
+
+- Update the readme to document the current way to generate Dart AOT snapshots.
+- Spelling corrections in dartdoc comments.
+
 ## 0.7.2
 
 - Upgrade to `package:lints` 2.0.

pkg/vm_snapshot_analysis/README.md

@@ -20,25 +20,25 @@ impossible to attribute of every single byte from the snapshot to a particular
 place in the program with a 100% accuracy.
 
 * `--print-instructions-sizes-to` attributes _executable code_ from the snapshot
-to a particular Dart function (or internal stub) from which this code
-originated (ignoring deduplication). Executable code usually constitutes around
-half of the snapshot, those this varies depending on the application.
+  to a particular Dart function (or internal stub) from which this code
+  originated (ignoring deduplication). Executable code usually constitutes
+  around half of the snapshot, those this varies depending on the application.
 * `--write-v8-snapshot-profile-to` is a graph representation of the snapshot,
-it attributes bytes written into a snapshot to a node in the heap graph. This
-format covers both data and code sections of the snapshot.
+  it attributes bytes written into a snapshot to a node in the heap graph. This
+  format covers both data and code sections of the snapshot.
 * `--trace-precompiler-to` gives information about dependencies between
-compiled functions, allowing to determine why certain function was pulled into
-the snapshot.
+  compiled functions, allowing to determine why certain function was pulled into
+  the snapshot.
 
 ### Passing flags to the AOT compiler
 
-Both in `dart2native` and Flutter you can use `--extra-gen-snapshot-options` to
-pass flags to the AOT compiler:
+In both Flutter and `dart compile exe` / `dart compile aot-snapshot` you can use
+`--extra-gen-snapshot-options` to pass flags to the AOT compiler:
 
 ```console
 $ flutter build aot --release --extra-gen-snapshot-options=--write-v8-snapshot-profile-to=profile.json
 
-$ dart2native --extra-gen-snapshot-options=--write-v8-snapshot-profile-to=profile.json -o binary input.dart
+$ dart compile exe --extra-gen-snapshot-options=--write-v8-snapshot-profile-to=profile.json -o binary input.dart
 ```
 
 Similarly with `--print-instructions-sizes-to`.

pkg/vm_snapshot_analysis/pubspec.yaml

@@ -1,5 +1,5 @@
 name: vm_snapshot_analysis
-version: 0.7.2
+version: 0.7.3-dev
 description: Utilities for analysing AOT snapshot size.
 repository: https://github.com/dart-lang/sdk/tree/main/pkg/vm_snapshot_analysis