Merge pull request #1423 from ArhanChaudhary/docs-elaboration

Be more explicit with available wasm-opt flags in documentation

Author: drager

docs/src/cargo-toml-configuration.md

@@ -18,6 +18,10 @@ The available configuration options and their default values are shown below:
 # be set to an array of strings which are explicit arguments to pass to
 # `wasm-opt`. For example `['-Os']` would optimize for size while `['-O4']`
 # would execute very expensive optimizations passes
+#
+# In most cases, the `-O[X]` flag is enough. However, if you require extreme
+# optimizations, see the full list of `wasm-opt` optimization flags
+# https://github.com/WebAssembly/binaryen/blob/version_117/test/lit/help/wasm-opt.test
 wasm-opt = ['-O']
 
 [package.metadata.wasm-pack.profile.dev.wasm-bindgen]

src/install/mod.rs

@@ -203,7 +203,7 @@ pub fn prebuilt_url_for(tool: &Tool, version: &str, arch: &Arch, os: &Os) -> Res
         Tool::WasmOpt => {
             Ok(format!(
         "https://github.com/WebAssembly/binaryen/releases/download/{vers}/binaryen-{vers}-{target}.tar.gz",
-        vers = "version_117",
+        vers = "version_117", // Make sure to update the version in docs/src/cargo-toml-configuration.md as well
         target = target,
             ))
         }