Skip to content

Commit dd224b0

Browse files
committed
deploy: 5b60ab8
1 parent ff637b4 commit dd224b0

File tree

8 files changed

+403
-131
lines changed

8 files changed

+403
-131
lines changed

.doctrees/cli_args.doctree

6.21 KB
Binary file not shown.

.doctrees/environment.pickle

4.22 KB
Binary file not shown.

_sources/cli_args.rst.txt

Lines changed: 72 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,37 @@
1-
Command Line Interface Options
2-
==============================
31

4-
.. std:option:: -v, --verbosity
2+
Command Line Interface
3+
======================
54

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.
1031

1132

1233
:Default:
13-
``"info"``
34+
``"boost-*,bugprone-*,performance-*,readability-*,portability-*,modernize-*,clang-analyzer-*,cppcoreguidelines-*"``
1435
.. std:option:: -p, --database
1536
1637
The path that is used to read a compile command database.
@@ -21,6 +42,27 @@ Command Line Interface Options
2142
https://clang.llvm.org/docs/HowToSetupToolingForLLVM.html for an
2243
example of setting up Clang Tooling on a source tree.
2344

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+
2466
.. std:option:: -s, --style
2567
2668
The style rules to use.
@@ -33,25 +75,26 @@ Command Line Interface Options
3375

3476
:Default:
3577
``"llvm"``
36-
.. std:option:: -c, --tidy-checks
78+
.. std:option:: -M, --ignore-format
3779
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.
5194

5295

5396
:Default:
54-
``"boost-*,bugprone-*,performance-*,readability-*,portability-*,modernize-*,clang-analyzer-*,cppcoreguidelines-*"``
97+
``"info"``
5598
.. std:option:: -V, --version
5699
57100
The desired version of the clang tools to use. Accepted options are
@@ -66,6 +109,10 @@ Command Line Interface Options
66109

67110
:Default:
68111
``""``
112+
113+
Source options
114+
--------------
115+
69116
.. std:option:: -e, --extensions
70117
71118
A comma-separated list of file extensions to analyze.
@@ -131,16 +178,9 @@ Command Line Interface Options
131178

132179
:Default:
133180
``"false"``
134-
.. std:option:: -x, --extra-arg
135181

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+
----------------
144184

145185
.. std:option:: -g, --thread-comments
146186

0 commit comments

Comments
 (0)