Tests added to traffic annotation extractor clang tool.
Test suit is added to network traffic annotation extractor clang tool.
Bug: 656607
Bug: 690323
Change-Id: Ie7adc46694eba1bf1dc05bd08ccacf4c8e42743b
Reviewed-on: https://chromium-review.googlesource.com/590236
Commit-Queue: Ramin Halavati <[email protected]>
Reviewed-by: Martin Šrámek <[email protected]>
Reviewed-by: Daniel Cheng <[email protected]>
Cr-Commit-Position: refs/heads/master@{#491276}diff --git a/docs/clang_tool_refactoring.md b/docs/clang_tool_refactoring.md
index 4168145..8ee26f09 100644
--- a/docs/clang_tool_refactoring.md
+++ b/docs/clang_tool_refactoring.md
@@ -208,11 +208,16 @@
Synposis:
```shell
-tools/clang/scripts/test_tool.py <tool name>
+tools/clang/scripts/test_tool.py <tool name> [--apply-edits]
```
The name of the tool binary and the subdirectory for the tool in
`//tools/clang` must match. The test runner finds all files that match the
-pattern `//tools/clang/<tool name>/tests/*-original.cc`, runs the tool across
-those files, and compared it to the `*-expected.cc` version. If there is a
-mismatch, the result is saved in `*-actual.cc`.
+pattern `//tools/clang/<tool name>/tests/*-original.cc`, and runs the tool
+across those files.
+If `--apply-edits` switch is presented, tool outputs are applied to respective
+files and compared to the `*-expected.cc` version. If there is a mismatch, the
+result is saved in `*-actual.cc`.
+When `--apply-edits` switch is not presented, tool outputs are compared to
+`*-expected.txt` and if different, the result is saved in `*-actual.txt`. Note
+that in this case, only one test file is expected.
