doc(wasi) Improve documentation of WasiVersion::Latest.

wasmerio · Dec 4, 2019 · c12dd85 · c12dd85
1 parent c916f0e
commit c12dd85
Showing 1 changed file with 11 additions and 1 deletion.
diff --git a/lib/wasi/src/utils.rs b/lib/wasi/src/utils.rs
@@ -15,7 +15,17 @@ pub enum WasiVersion {
     Snapshot0,
     /// `wasi_snapshot_preview1`.
     Snapshot1,
-    /// Latest version (for the moment, an alias to `Snapshot1`).
+
+    /// Latest version.
+    ///
+    /// It's a “floating” version, i.e. it's an alias to the latest
+    /// version (for the moment, `Snapshot1`). Using this version is a
+    /// way to ensure that modules will run only if they come with the
+    /// latest WASI version (in case of security issues for instance),
+    /// by just updating the runtime.
+    ///
+    /// Note that this version is never returned by an API. It is
+    /// provided only by the user.
     Latest,
 }