Merge pull request #7189 from kenjis/fix-docs-spark_commands.rst

docs: improve spark_commands.rst

Author: kenjis

user_guide_src/source/cli/spark_commands.rst

@@ -12,13 +12,18 @@ CodeIgniter ships with the official command **spark** and built-in commands.
 Running Commands
 ****************
 
-The commands are run from the command line, in the root directory.
-A custom script, **spark** has been provided that is used to run any of the CLI commands::
+Running via CLI
+===============
+
+The commands are run from the command line, in the project root directory.
+The command file **spark** has been provided that is used to run any of the CLI commands::
 
     > php spark
 
 When called without specifying a command, a simple help page is displayed that also provides a list of
-available commands. You should pass the name of the command as the first argument to run that command::
+available commands.
+
+You should pass the name of the command as the first argument to run that command::
 
     > php spark migrate
 
@@ -33,8 +38,9 @@ You may always pass ``--no-header`` to suppress the header output, helpful for p
 For all of the commands CodeIgniter provides, if you do not provide the required arguments, you will be prompted
 for the information it needs to run correctly::
 
-    > php spark migrate:version
-    > Version?
+    > php spark make::controller
+
+    Controller class name :
 
 Calling Commands
 ================
@@ -54,9 +60,24 @@ so that you can choose to display it or not.
 Using Help Command
 ******************
 
-You can get help about any CLI command using the help command as follows::
+spark help
+==========
+
+You can get help about any CLI command using the ``help`` command as follows::
 
     > php spark help db:seed
 
-Use the **list** command to get a list of available commands and their descriptions, sorted by categories.
-You may also use ``spark list --simple`` to get a raw list of all available commands, sorted alphabetically.
+Since v4.3.0, you can also use the ``--help`` option instead of the ``help`` command::
+
+    > php spark db:seed --help
+
+spark list
+==========
+
+Use the ``list`` command to get a list of available commands and their descriptions, sorted by categories::
+
+    > php spark list
+
+You may also use the ``--simple`` option to get a raw list of all available commands, sorted alphabetically::
+
+    > php spark list --simple