update docs for clarity

Author: bacchanalia

doc/cabal-commands.rst

@@ -436,13 +436,15 @@ See `the v2-build section <#cabal-v2-build>`__ for the target syntax.
 
 When ``TARGET`` is one of the following:
 
-- A component target: execute the specified executable, benchmark or test suite
+- A component target: execute the specified executable, benchmark or test suite.
 
 - A package target:
    1. If the package has exactly one executable component, it will be selected.
    2. If the package has multiple executable components, an error is raised.
    3. If the package has exactly one test or benchmark component, it will be selected.
-   4. Otherwise an issue is raised
+   4. Otherwise an issue is raised.
+
+- The path to a script: execute the script at the path.
 
 - Empty target: Same as package target, implicitly using the package from the current
   working directory.
@@ -458,8 +460,8 @@ have to separate them with ``--``.
 
     $ cabal v2-run target -- -a -bcd --argument
 
-``v2-run`` also supports running script files that use a certain format. With
-a script that looks like:
+``v2-run`` supports running script files that use a certain format.
+Scripts look like:
 
 ::
 
@@ -484,13 +486,12 @@ Only some fields are supported in the metadata blocks, and these fields are
 currently not validated. See
 `#8024 <https://github.com/haskell/cabal/issues/8024>`__ for details.
 
-It can either be executed like any other script, using ``cabal`` as an
-interpreter, or through this command:
+A script can either be executed directly using `cabal` as an interpreter or
+with the command:
 
 ::
 
     $ cabal v2-run path/to/script
-    $ cabal v2-run path/to/script -- --arg1 # args are passed like this
 
 The executable is cached under the cabal directory, and can be pre-built with
 ``cabal v2-build path/to/script`` and the cache can be removed with