chore: prepare release v0.33.0

docs/CLI.md

@@ -22,7 +22,7 @@ one token per line. FILE may be `-` to read standard input.
 Parse FILE and report syntax errors on stderr. On success, prints how
 many declarations and TEXT functions the file contains.
 
-## `gasm fmt [-w] [path...]`
+## `gasm fmt [-w|-l|-d] [path...]`
 
 Canonicalise the formatting of Plan 9 assembly sources: indentation,
 operand spacing, per-function mnemonic alignment, and blank-line layout.
@@ -30,6 +30,8 @@ operand spacing, per-function mnemonic alignment, and blank-line layout.
 | Flag | Description |
 |------|-------------|
 | `-w` | Write result to the source file (default: print to stdout) |
+| `-l` | List files whose formatting differs, one per line; write nothing |
+| `-d` | Print a unified diff of the canonical formatting instead |
 
 With no arguments, or with a directory argument, every `.s` file below
 it is reformatted in place and the names of changed files are listed
@@ -62,6 +64,21 @@ Assemble FILE to machine code (amd64, arm64, riscv64, loong64).
 | `-p` | Package path (required for `--format goobj`) |
 | `-o` | Write output to file (default: hex dump to stdout) |
 
+## `gasm dis [-a arch] <file>`
+
+Disassemble machine code to instruction text (via `golang.org/x/arch`).
+
+With a `.s` file, the file is assembled first and the listing follows the
+real layout: one block per `TEXT` function, local labels printed at their
+offsets.  The architecture comes from the file name suffix, or from `-a`.
+With any other file, or `-` for standard input, the bytes are
+disassembled linearly and `-a` selects the architecture (amd64, arm64,
+riscv64 or loong64).
+
+| Flag | Description |
+|------|-------------|
+| `-a` | Architecture for raw input without a `_arch.s` name |
+
 ## `gasm verify [flags] <file.s>`
 
 Assemble FILE, map it into executable memory, and run dynamic checks.