[libcalamares] Tidy up documentation for System::runCommand

- Make explicit which one runs in the host, which one is selectable.
- Document *location* parameter in the selectable version.
- Tidy up alignment of apidox.

src/libcalamares/utils/CalamaresUtilsSystem.h

@@ -139,8 +139,9 @@ public:
         RunInTarget
     };
 
-    /**
-      * Runs the specified command in the chroot of the target system.
+    /** @brief Runs a command in the host or the target (select explicitly)
+     *
+     * @param location whether to run in the host or the target
      * @param args the command with arguments, as a string list.
      * @param workingPath the current working directory for the QProcess
      *        call (optional).
@@ -162,9 +163,9 @@ public:
                                                const QString& stdInput = QString(),
                                                std::chrono::seconds timeoutSec = std::chrono::seconds( 0 ) );
 
-    /** @brief Convenience wrapper for runCommand()
+    /** @brief Convenience wrapper for runCommand() in the host
      *
-     * Runs the given command-line @p args in the host in the current direcory
+     * Runs the given command-line @p args in the **host** in the current direcory
      * with no input, and the given @p timeoutSec for completion.
      */
     static inline ProcessResult runCommand( const QStringList& args, std::chrono::seconds timeoutSec )
@@ -173,6 +174,7 @@ public:
     }
 
     /** @brief Convenience wrapper for runCommand().
+     *
      * Runs the command in the location specified through the boolean
      * doChroot(), which is what you usually want for running commands
      * during installation.