1
- Command Line Interface Options
2
- ==============================
3
1
4
- .. std :option :: -v, --verbosity
2
+ Command Line Interface
3
+ ======================
5
4
6
- This controls the action's verbosity in the workflow's logs.
7
- Supported options are defined by the `logging-level <logging-levels >`_.
8
- This option does not affect the verbosity of resulting
9
- thread comments or file annotations.
5
+ Commands
6
+ --------
7
+
8
+ .. std :option :: version
9
+
10
+ Display the cpp-linter version and exit.
11
+
12
+
13
+ Clang-tidy options
14
+ ------------------
15
+
16
+ .. std :option :: -c, --tidy-checks
17
+
18
+ A comma-separated list of globs with optional ``- `` prefix.
19
+ Globs are processed in order of appearance in the list.
20
+ Globs without ``- `` prefix add checks with matching names to the set,
21
+ globs with the ``- `` prefix remove checks with matching names from the set of
22
+ enabled checks. This option's value is appended to the value of the 'Checks'
23
+ option in a .clang-tidy file (if any).
24
+
25
+ - It is possible to disable clang-tidy entirely by setting this option to
26
+ ``'-*' ``.
27
+ - It is also possible to rely solely on a .clang-tidy config file by
28
+ specifying this option as a blank string (``'' ``).
29
+
30
+ See also clang-tidy docs for more info.
10
31
11
32
12
33
:Default:
13
- ``"info " ``
34
+ ``"boost-*,bugprone-*,performance-*,readability-*,portability-*,modernize-*,clang-analyzer-*,cppcoreguidelines-* " ``
14
35
.. std :option :: -p, --database
15
36
16
37
The path that is used to read a compile command database.
@@ -21,6 +42,27 @@ Command Line Interface Options
21
42
https://clang.llvm.org/docs/HowToSetupToolingForLLVM.html for an
22
43
example of setting up Clang Tooling on a source tree.
23
44
45
+ .. std :option :: -x, --extra-arg
46
+
47
+ A string of extra arguments passed to clang-tidy for use as
48
+ compiler arguments. This can be specified more than once for each
49
+ additional argument. Recommend using quotes around the value and
50
+ avoid using spaces between name and value (use ``= `` instead):
51
+
52
+ .. code-block :: shell
53
+
54
+ cpp-linter --extra-arg=" -std=c++17" --extra-arg=" -Wall"
55
+
56
+ .. std :option :: -D, --ignore-tidy
57
+
58
+ Similar to `--ignore ` but applied exclusively to files analyzed by clang-tidy.
59
+
60
+ :Default:
61
+ ``"" ``
62
+
63
+ Clang-format options
64
+ --------------------
65
+
24
66
.. std :option :: -s, --style
25
67
26
68
The style rules to use.
@@ -33,25 +75,26 @@ Command Line Interface Options
33
75
34
76
:Default:
35
77
``"llvm" ``
36
- .. std :option :: -c , --tidy-checks
78
+ .. std :option :: -M , --ignore-format
37
79
38
- A comma-separated list of globs with optional ``- `` prefix.
39
- Globs are processed in order of appearance in the list.
40
- Globs without ``- `` prefix add checks with matching names to the set,
41
- globs with the ``- `` prefix remove checks with matching names from the set of
42
- enabled checks. This option's value is appended to the value of the 'Checks'
43
- option in a .clang-tidy file (if any).
44
-
45
- - It is possible to disable clang-tidy entirely by setting this option to
46
- ``'-*' ``.
47
- - It is also possible to rely solely on a .clang-tidy config file by
48
- specifying this option as a blank string (``'' ``).
49
-
50
- See also clang-tidy docs for more info.
80
+ Similar to `--ignore ` but applied exclusively to files analyzed by clang-format.
81
+
82
+ :Default:
83
+ ``"" ``
84
+
85
+ General options
86
+ ---------------
87
+
88
+ .. std :option :: -v, --verbosity
89
+
90
+ This controls the action's verbosity in the workflow's logs.
91
+ Supported options are defined by the `logging-level <logging-levels >`_.
92
+ This option does not affect the verbosity of resulting
93
+ thread comments or file annotations.
51
94
52
95
53
96
:Default:
54
- ``"boost-*,bugprone-*,performance-*,readability-*,portability-*,modernize-*,clang-analyzer-*,cppcoreguidelines-* " ``
97
+ ``"info " ``
55
98
.. std :option :: -V, --version
56
99
57
100
The desired version of the clang tools to use. Accepted options are
@@ -66,6 +109,10 @@ Command Line Interface Options
66
109
67
110
:Default:
68
111
``"" ``
112
+
113
+ Source options
114
+ --------------
115
+
69
116
.. std :option :: -e, --extensions
70
117
71
118
A comma-separated list of file extensions to analyze.
@@ -131,16 +178,9 @@ Command Line Interface Options
131
178
132
179
:Default:
133
180
``"false" ``
134
- .. std :option :: -x, --extra-arg
135
181
136
- A string of extra arguments passed to clang-tidy for use as
137
- compiler arguments. This can be specified more than once for each
138
- additional argument. Recommend using quotes around the value and
139
- avoid using spaces between name and value (use ``= `` instead):
140
-
141
- .. code-block :: shell
142
-
143
- cpp-linter --extra-arg=" -std=c++17" --extra-arg=" -Wall"
182
+ Feedback options
183
+ ----------------
144
184
145
185
.. std :option :: -g, --thread-comments
146
186
0 commit comments