doc: update about arguments

documentation.md

@@ -31,8 +31,7 @@ from the configuration file are combined when bazel-compile-commands is called
 
 -a, --arguments
 
-: Also write the array of arguments for each entry in the
-`compile_commands.json` file.
+: Provided only for backwards compatibility.
 
 -B, --bazel-command **BAZEL**
 
@@ -48,6 +47,11 @@ from the configuration file are combined when bazel-compile-commands is called
 : Same as `--bazelopt "--config=CONFIG"`. A config option from `.bazelrc` to
 apply when querying Bazel for build actions.
 
+--command
+
+: Generate a `compile_commands.json` file with `command` entries instead of
+`arguments` entries.
+
 -c, --compiler **FILE**
 
 : Replace the internal Bazel compiler wrapper script with this compiler (useful

tests/self_test.cpp

@@ -88,6 +88,7 @@ TEST(self_test, run)
 
     ASSERT_THAT(cu_obj.find("file"), Not(Eq(end)));
     EXPECT_THAT(cu_obj.find("directory"), Not(Eq(end)));
+    EXPECT_THAT(cu_obj.find("command"), Eq(end));
     EXPECT_THAT(cu_obj.find("arguments"), Not(Eq(end)));
     EXPECT_THAT(cu_obj.find("output"), Not(Eq(end)));