From 16c9b3042d925270d1536429a239261b5a7df9b8 Mon Sep 17 00:00:00 2001 From: Alon Zakai Date: Wed, 5 Jan 2022 11:42:13 -0800 Subject: Add categories to --help text (#4421) The general shape of the --help output is now: ======================== wasm-foo Does the foo operation ======================== wasm-foo opts: -------------- --foo-bar .. Tool opts: ---------- .. The options are now in categories, with the more specific ones - most likely to be wanted by the user - first. I think this makes the list a lot less confusing. In particular, in wasm-opt all the opt passes are now in their own category. Also add a script to make it easy to update the help tests. --- test/lit/help/tool-opts.test | 105 ------------------------------------------- 1 file changed, 105 deletions(-) delete mode 100644 test/lit/help/tool-opts.test (limited to 'test/lit/help/tool-opts.test') diff --git a/test/lit/help/tool-opts.test b/test/lit/help/tool-opts.test deleted file mode 100644 index 100f5705d..000000000 --- a/test/lit/help/tool-opts.test +++ /dev/null @@ -1,105 +0,0 @@ -;; RUN: wasm-as --help | filecheck %s -;; RUN: wasm-ctor-eval --help | filecheck %s -;; RUN: wasm-dis --help | filecheck %s -;; RUN: wasm-emscripten-finalize --help | filecheck %s -;; RUN: wasm-metadce --help | filecheck %s -;; RUN: wasm-reduce --help | filecheck %s -;; RUN: wasm-split --help | filecheck %s - -wasm-as INFILE - -;; CHECK: Options: -;; CHECK-NEXT: -;; CHECK-NEXT: --version Output version information and exit -;; CHECK-NEXT: -;; CHECK-NEXT: --help,-h Show this help message and exit -;; CHECK-NEXT: -;; CHECK-NEXT: --debug,-d Print debug information to stderr -;; CHECK-NEXT: -;; CHECK-NEXT: --mvp-features,-mvp Disable all non-MVP features -;; CHECK-NEXT: -;; CHECK-NEXT: --all-features,-all Enable all features -;; CHECK-NEXT: -;; CHECK-NEXT: --detect-features (deprecated - this flag does nothing) -;; CHECK-NEXT: -;; CHECK-NEXT: --quiet,-q Emit less verbose output and hide trivial -;; CHECK-NEXT: warnings. -;; CHECK-NEXT: -;; CHECK-NEXT: --experimental-poppy Parse wast files as Poppy IR for testing -;; CHECK-NEXT: purposes. -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-sign-ext Enable sign extension operations -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-sign-ext Disable sign extension operations -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-threads Enable atomic operations -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-threads Disable atomic operations -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-mutable-globals Enable mutable globals -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-mutable-globals Disable mutable globals -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-nontrapping-float-to-int Enable nontrapping float-to-int -;; CHECK-NEXT: operations -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-nontrapping-float-to-int Disable nontrapping float-to-int -;; CHECK-NEXT: operations -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-simd Enable SIMD operations and types -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-simd Disable SIMD operations and types -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-bulk-memory Enable bulk memory operations -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-bulk-memory Disable bulk memory operations -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-exception-handling Enable exception handling operations -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-exception-handling Disable exception handling operations -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-tail-call Enable tail call operations -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-tail-call Disable tail call operations -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-reference-types Enable reference types -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-reference-types Disable reference types -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-multivalue Enable multivalue functions -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-multivalue Disable multivalue functions -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-gc Enable garbage collection -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-gc Disable garbage collection -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-memory64 Enable memory64 -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-memory64 Disable memory64 -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-typed-function-references Enable typed function references -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-typed-function-references Disable typed function references -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-gc-nn-locals Enable GC non-null locals -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-gc-nn-locals Disable GC non-null locals -;; CHECK-NEXT: -;; CHECK-NEXT: --enable-relaxed-simd Enable relaxed SIMD -;; CHECK-NEXT: -;; CHECK-NEXT: --disable-relaxed-simd Disable relaxed SIMD -;; CHECK-NEXT: -;; CHECK-NEXT: --no-validation,-n Disables validation, assumes inputs are -;; CHECK-NEXT: correct -;; CHECK-NEXT: -;; CHECK-NEXT: --pass-arg,-pa An argument passed along to optimization -;; CHECK-NEXT: passes being run. Must be in the form -;; CHECK-NEXT: KEY@VALUE -;; CHECK-NEXT: -;; CHECK-NEXT: --nominal Force all GC type definitions to be -;; CHECK-NEXT: parsed as nominal. -;; CHECK-NEXT: -;; CHECK-NEXT: --structural Force all GC type definitions to be -;; CHECK-NEXT: parsed as structural (i.e. -;; CHECK-NEXT: equirecursive). This is the default. -- cgit v1.2.3