update command output

src/reference/cli/forge.md

@@ -44,7 +44,7 @@ Commands:
   script             Run a smart contract as a script, building transactions
                      that can be sent onchain
   selectors          Function selector utilities [aliases: se]
-  snapshot           Create a snapshot of each test's gas usage [aliases: s]
+  snapshot           Create a gas snapshot of each test's gas usage [aliases: s]
   soldeer            Soldeer dependency manager
   test               Run the project's tests [aliases: t]
   tree               Display a tree visualization of the project's dependency

src/reference/cli/forge/coverage.md

@@ -37,45 +37,38 @@ Options:
           Print help (see a summary with '-h')
 
 Test options:
-      --debug <TEST_FUNCTION>
-          Run a test in the debugger.
-          
-          The argument passed to this flag is the name of the test function you
-          want to run, and it works the same as --match-test.
-          
-          If more than one test matches your specified criteria, you must add
-          additional filters until only one test is found (see --match-contract
-          and --match-path).
+      --debug [<DEPRECATED_TEST_FUNCTION_REGEX>]
+          Run a single test in the debugger.
           
           The matching test will be opened in the debugger regardless of the
           outcome of the test.
           
           If the matching test is a fuzz test, then it will open the debugger on
           the first failure case. If the fuzz test does not fail, it will open
           the debugger on the last fuzz case.
-          
-          For more fine-grained control of which fuzz case is run, see forge
-          run.
 
       --flamegraph
-          Generate a flamegraph for a single test. Implies `--decode-internal`
+          Generate a flamegraph for a single test. Implies `--decode-internal`.
+          
+          A flame graph is used to visualize which functions or operations
+          within the smart contract are consuming the most gas overall in a
+          sorted manner.
 
       --flamechart
-          Generate a flamechart for a single test. Implies `--decode-internal`
-
-      --decode-internal [<TEST_FUNCTION>]
-          Whether to identify internal functions in traces.
+          Generate a flamechart for a single test. Implies `--decode-internal`.
           
-          If no argument is passed to this flag, it will trace internal
-          functions scope and decode stack parameters, but parameters stored in
-          memory (such as bytes or arrays) will not be decoded.
+          A flame chart shows the gas usage over time, illustrating when each
+          function is called (execution order) and how much gas it consumes at
+          each point in the timeline.
+
+      --decode-internal [<DEPRECATED_TEST_FUNCTION_REGEX>]
+          Identify internal functions in traces.
           
-          To decode memory parameters, you should pass an argument with a test
-          function name, similarly to --debug and --match-test.
+          This will trace internal functions and decode stack parameters.
           
-          If more than one test matches your specified criteria, you must add
-          additional filters until only one test is found (see --match-contract
-          and --match-path).
+          Parameters stored in memory (such as bytes or arrays) are currently
+          decoded only when a single function is matched, similarly to
+          `--debug`, for performance reasons.
 
       --gas-report
           Print a gas report

src/reference/cli/forge/create.md

@@ -305,7 +305,7 @@ Wallet options - raw:
           [default: 5]
 
       --delay <DELAY>
-          Optional delay to apply inbetween verification attempts, in seconds
+          Optional delay to apply in between verification attempts, in seconds
           
           [default: 5]
 

src/reference/cli/forge/script.md

@@ -471,7 +471,7 @@ Executor environment config:
           [default: 5]
 
       --delay <DELAY>
-          Optional delay to apply inbetween verification attempts, in seconds
+          Optional delay to apply in between verification attempts, in seconds
           
           [default: 5]