Document --file-delete for sqlq (#3788)

Author: weitzman

includes/drupal.inc

@@ -12,6 +12,8 @@ use Drush\Drush;
  * if any. Returns FALSE if there is no current Drupal installation,
  * or it is somehow broken.
  *
+ * @deprecated See \Drush\Boot\Boot::getVersion.
+ *
  * @return
  *   A string containing the version number of the current
  *   Drupal installation, if any. Otherwise, return FALSE.

src/Commands/sql/SqlCommands.php

@@ -150,6 +150,7 @@ public function cli($options = ['extra' => self::REQ])
      * @optionset_sql
      * @option result-file Save to a file. The file should be relative to Drupal root.
      * @option file Path to a file containing the SQL to be run. Gzip files are accepted.
+     * @option file-delete Delete the --file after running it.
      * @option extra Add custom options to the connect string (e.g. --extra=--skip-column-names)
      * @option db-prefix Enable replacement of braces in your query.
      * @validate-file-exists file
@@ -165,7 +166,7 @@ public function cli($options = ['extra' => self::REQ])
      * @bootstrap max configuration
      *
      */
-    public function query($query = '', $options = ['result-file' => null, 'file' => self::REQ, 'extra' => self::REQ, 'db-prefix' => false])
+    public function query($query = '', $options = ['result-file' => null, 'file' => self::REQ, 'file-delete' => false, 'extra' => self::REQ, 'db-prefix' => false])
     {
         $filename = $options['file'];
         // Enable prefix processing when db-prefix option is used.