Update CodeQL CLI manual (#58723)

Co-authored-by: Óscar San José <oscarsj@github.com>

Author: docs-bot

content/code-security/codeql-cli/codeql-cli-manual/bqrs-diff.md

@@ -65,6 +65,13 @@ corresponding output instead of comparing. If --both is given, that
 output is taken from `file1`. Defaults to 'nodes,edges,subpaths' to
 simplify handling of path-problem results.
 
+#### `--result-sets=<name1>,<name2>`
+
+Compare only the specified result sets. The format is
+\<name1>,\<name2> where \<name1> is the result set name in `file1`
+and \<name2> is the result set name in `file2`. The two result sets
+must be compatible. The option can be repeated.
+
 #### `--[no-]compare-internal-ids`
 
 \[Advanced] Include internal entity IDs in the comparison. Entity IDs

content/code-security/codeql-cli/codeql-cli-manual/database-analyze.md

@@ -328,9 +328,7 @@ thread).
 
 #### `--[no-]save-cache`
 
-\[Advanced] Aggressively write intermediate results to the disk cache.
-This takes more time and uses (much) more disk space, but may speed up
-the subsequent execution of similar queries.
+\[Deprecated] \[Advanced] This flag does nothing.
 
 #### `--[no-]expect-discarded-cache`
 

content/code-security/codeql-cli/codeql-cli-manual/database-run-queries.md

@@ -170,9 +170,7 @@ thread).
 
 #### `--[no-]save-cache`
 
-\[Advanced] Aggressively write intermediate results to the disk cache.
-This takes more time and uses (much) more disk space, but may speed up
-the subsequent execution of similar queries.
+\[Deprecated] \[Advanced] This flag does nothing.
 
 #### `--[no-]expect-discarded-cache`
 

content/code-security/codeql-cli/codeql-cli-manual/database-upgrade.md

@@ -129,9 +129,7 @@ thread).
 
 #### `--[no-]save-cache`
 
-\[Advanced] Aggressively write intermediate results to the disk cache.
-This takes more time and uses (much) more disk space, but may speed up
-the subsequent execution of similar queries.
+\[Deprecated] \[Advanced] This flag does nothing.
 
 #### `--[no-]expect-discarded-cache`
 

content/code-security/codeql-cli/codeql-cli-manual/dataset-upgrade.md

@@ -125,9 +125,7 @@ thread).
 
 #### `--[no-]save-cache`
 
-\[Advanced] Aggressively write intermediate results to the disk cache.
-This takes more time and uses (much) more disk space, but may speed up
-the subsequent execution of similar queries.
+\[Deprecated] \[Advanced] This flag does nothing.
 
 #### `--[no-]expect-discarded-cache`
 

content/code-security/codeql-cli/codeql-cli-manual/execute-queries.md

@@ -153,9 +153,7 @@ thread).
 
 #### `--[no-]save-cache`
 
-\[Advanced] Aggressively write intermediate results to the disk cache.
-This takes more time and uses (much) more disk space, but may speed up
-the subsequent execution of similar queries.
+\[Deprecated] \[Advanced] This flag does nothing.
 
 #### `--[no-]expect-discarded-cache`
 

content/code-security/codeql-cli/codeql-cli-manual/execute-query-server2.md

@@ -78,9 +78,7 @@ thread).
 
 #### `--[no-]save-cache`
 
-\[Advanced] Aggressively write intermediate results to the disk cache.
-This takes more time and uses (much) more disk space, but may speed up
-the subsequent execution of similar queries.
+\[Deprecated] \[Advanced] This flag does nothing.
 
 #### `--[no-]expect-discarded-cache`
 

content/code-security/codeql-cli/codeql-cli-manual/execute-upgrades.md

@@ -128,9 +128,7 @@ thread).
 
 #### `--[no-]save-cache`
 
-\[Advanced] Aggressively write intermediate results to the disk cache.
-This takes more time and uses (much) more disk space, but may speed up
-the subsequent execution of similar queries.
+\[Deprecated] \[Advanced] This flag does nothing.
 
 #### `--[no-]expect-discarded-cache`
 

content/code-security/codeql-cli/codeql-cli-manual/query-run.md

@@ -108,9 +108,7 @@ thread).
 
 #### `--[no-]save-cache`
 
-\[Advanced] Aggressively write intermediate results to the disk cache.
-This takes more time and uses (much) more disk space, but may speed up
-the subsequent execution of similar queries.
+\[Deprecated] \[Advanced] This flag does nothing.
 
 #### `--[no-]expect-discarded-cache`