Merge pull request godotengine#8586 from jonri/patch-1

Clarify path usage for command line options

Author: mhilbrunner

tutorials/editor/command_line_tutorial.rst

@@ -264,14 +264,14 @@ Depending on where your Godot binary is located and what your current
 working directory is, you may need to set the path to your project
 for any of the following commands to work correctly.
 
-This can be done by giving the path to the ``project.godot`` file
+When running the editor, this can be done by giving the path to the ``project.godot`` file
 of your project as either the first argument, like this:
 
 ::
 
     godot path_to_your_project/project.godot [other] [commands] [and] [args]
 
-Or by using the ``--path`` argument:
+For all commands, this can be done by using the ``--path`` argument:
 
 ::
 
@@ -283,6 +283,17 @@ For example, the full command for exporting your game (as explained below) might
 
     godot --headless --path path_to_your_project --export-release my_export_preset_name game.exe
 
+When starting from a subdirectory of your project, use the ``--upwards`` argument for Godot to 
+automatically find the ``project.godot`` file by recursively searching the parent directories.
+
+For example, running a scene (as explained below) nested in a subdirectory might look like this 
+when your working directory is in the same path:
+
+::
+
+    godot --upwards nested_scene.tscn 
+
+
 ..
 
 Creating a project
@@ -307,13 +318,15 @@ Running the editor
 ------------------
 
 Running the editor is done by executing Godot with the ``-e`` flag. This
-must be done from within the project directory or a subdirectory,
+must be done from within the project directory or by setting the project path as explained above,
 otherwise the command is ignored and the Project Manager appears.
 
 ::
 
     godot -e
 
+When passing in the full path to the ``project.godot`` file, the ``-e`` flag may be omitted.
+
 If a scene has been created and saved, it can be edited later by running
 the same code with that scene as argument.
 
@@ -335,15 +348,15 @@ Otherwise, an error will be thrown upon opening the project.
 Running the game
 ----------------
 
-To run the game, simply execute Godot within the project directory or
-subdirectory.
+To run the game, execute Godot within the project directory or with the project path as explained above.  
 
 ::
 
     godot
 
-When a specific scene needs to be tested, pass that scene to the command
-line.
+Note that passing in the ``project.godot`` file will always run the editor instead of running the game.
+
+When a specific scene needs to be tested, pass that scene to the command line.
 
 ::