cmake-lint(1) General Commands Manual cmake-lint(1)
NAME
cmake-lint - Check cmake listfile for lint
SYNOPSIS
cmake-lint [-h] [--dump-config {yaml,json,python} | -o OUTFILE_PATH]
[-c CONFIG_FILE] infilepath [infilepath ...]
DESCRIPTION
Check cmake listfile for lint
OPTIONS
infilepaths
-v, --version
show program's version number and exit
-l {error,warning,info,debug}, --log-level {error,warning,info,debug}
--dump-config [{yaml,json,python}]
If specified, print the default configuration to stdout and exit
-o OUTFILE_PATH, --outfile-path OUTFILE_PATH
Write errors to this file. Default is stdout.
--no-help
When used with --dump-config, will omit helptext comments in the
output
--no-default
When used with --dump-config, will omit any unmodified configu-
ration value.
--suppress-decorations
Suppress the file title decoration and summary statistics
-c CONFIG_FILES [CONFIG_FILES ...], --config-files CONFIG_FILES [CON-
FIG_FILES ...]
path to configuration file(s)
--vartags [VARTAGS [VARTAGS ...]]
Specify variable tags.
--proptags [PROPTAGS [PROPTAGS ...]]
Specify property tags.
--disable [DISABLE]
Disable formatting entirely, making cmake-format a no-op
--line-width LINE_WIDTH
How wide to allow formatted cmake files
--tab-size TAB_SIZE
How many spaces to tab for indent
--use-tabchars [USE_TABCHARS]
If true, lines are indented using tab characters (utf-8 0x09)
instead of <tab_size> space characters (utf-8 0x20). In cases
where the layout would require a fractional tab character, the
behavior of the fractional indentation is governed by <frac-
tional_tab_policy>
--fractional-tab-policy {use-space,round-up}
If <use_tabchars> is True, then the value of this variable indi-
cates how fractional indentions are handled during whitespace
replacement. If set to 'use-space', fractional indentation is
left as spaces (utf-8 0x20). If set to `round-up` fractional in-
dentation is replaced with a single tab character (utf-8 0x09)
effectively shifting the column to the next tabstop
--max-subgroups-hwrap MAX_SUBGROUPS_HWRAP
If an argument group contains more than this many sub-groups
(parg or kwarg groups) then force it to a vertical layout.
--max-pargs-hwrap MAX_PARGS_HWRAP
If a positional argument group contains more than this many ar-
guments, then force it to a vertical layout.
--max-rows-cmdline MAX_ROWS_CMDLINE
If a cmdline positional group consumes more than this many lines
without nesting, then invalidate the layout (and nest)
--separate-ctrl-name-with-space [SEPARATE_CTRL_NAME_WITH_SPACE]
If true, separate flow control names from their parentheses with
a space
--separate-fn-name-with-space [SEPARATE_FN_NAME_WITH_SPACE]
If true, separate function names from parentheses with a space
--dangle-parens [DANGLE_PARENS]
If a statement is wrapped to more than one line, than dangle the
closing parenthesis on its own line.
--dangle-align {prefix,prefix-indent,child,off}
If the trailing parenthesis must be 'dangled' on its on line,
then align it to this reference: `prefix`: the start of the
statement, `prefix-indent`: the start of the statement, plus
one indentation level, `child`: align to the column of the ar-
guments
--min-prefix-chars MIN_PREFIX_CHARS
If the statement spelling length (including space and parenthe-
sis) is smaller than this amount, then force reject nested lay-
outs.
--max-prefix-chars MAX_PREFIX_CHARS
If the statement spelling length (including space and parenthe-
sis) is larger than the tab width by more than this amount, then
force reject un-nested layouts.
--max-lines-hwrap MAX_LINES_HWRAP
If a candidate layout is wrapped horizontally but it exceeds
this many lines, then reject the layout.
--line-ending {windows,unix,auto}
What style line endings to use in the output.
--command-case {lower,upper,canonical,unchanged}
Format command names consistently as 'lower' or 'upper' case
--keyword-case {lower,upper,unchanged}
Format keywords consistently as 'lower' or 'upper' case
--always-wrap [ALWAYS_WRAP [ALWAYS_WRAP ...]]
A list of command names which should always be wrapped
--enable-sort [ENABLE_SORT]
If true, the argument lists which are known to be sortable will
be sorted lexicographicall
--autosort [AUTOSORT]
If true, the parsers may infer whether or not an argument list
is sortable (without annotation).
--require-valid-layout [REQUIRE_VALID_LAYOUT]
By default, if cmake-format cannot successfully fit everything
into the desired linewidth it will apply the last, most aggres-
sive attempt that it made. If this flag is True, however,
cmake-format will print error, exit with non-zero status code,
and write-out nothing
--bullet-char BULLET_CHAR
What character to use for bulleted lists
--enum-char ENUM_CHAR
What character to use as punctuation after numerals in an enu-
merated list
--first-comment-is-literal [FIRST_COMMENT_IS_LITERAL]
If comment markup is enabled, don't reflow the first comment
block in each listfile. Use this to preserve formatting of your
copyright/license statements.
--literal-comment-pattern LITERAL_COMMENT_PATTERN
If comment markup is enabled, don't reflow any comment block
which matches this (regex) pattern. Default is `None` (dis-
abled).
--fence-pattern FENCE_PATTERN
Regular expression to match preformat fences in comments de-
fault= ``r'^\s*([`~]{3}[`~]*)(.*)$'``
--ruler-pattern RULER_PATTERN
Regular expression to match rulers in comments default=
``r'^\s*[^\w\s]{3}.*[^\w\s]{3}$'``
--explicit-trailing-pattern EXPLICIT_TRAILING_PATTERN
If a comment line matches starts with this pattern then it is
explicitly a trailing comment for the preceding argument. De-
fault is '#<'
--hashruler-min-length HASHRULER_MIN_LENGTH
If a comment line starts with at least this many consecutive
hash characters, then don't lstrip() them off. This allows for
lazy hash rulers where the first hash char is not separated by
space
--canonicalize-hashrulers [CANONICALIZE_HASHRULERS]
If true, then insert a space between the first hash char and re-
maining hash chars in a hash ruler, and normalize its length to
fill the column
--enable-markup [ENABLE_MARKUP]
enable comment markup parsing and reflow
--disabled-codes [DISABLED_CODES [DISABLED_CODES ...]]
a list of lint codes to disable
--function-pattern FUNCTION_PATTERN
regular expression pattern describing valid function names
--macro-pattern MACRO_PATTERN
regular expression pattern describing valid macro names
--global-var-pattern GLOBAL_VAR_PATTERN
regular expression pattern describing valid names for variables
with global (cache) scope
--internal-var-pattern INTERNAL_VAR_PATTERN
regular expression pattern describing valid names for variables
with global scope (but internal semantic)
--local-var-pattern LOCAL_VAR_PATTERN
regular expression pattern describing valid names for variables
with local scope
--private-var-pattern PRIVATE_VAR_PATTERN
regular expression pattern describing valid names for privatedi-
rectory variables
--public-var-pattern PUBLIC_VAR_PATTERN
regular expression pattern describing valid names for public di-
rectory variables
--argument-var-pattern ARGUMENT_VAR_PATTERN
regular expression pattern describing valid names for func-
tion/macro arguments and loop variables.
--keyword-pattern KEYWORD_PATTERN
regular expression pattern describing valid names for keywords
used in functions or macros
--max-conditionals-custom-parser MAX_CONDITIONALS_CUSTOM_PARSER
In the heuristic for C0201, how many conditionals to match
within a loop in before considering the loop a parser.
--min-statement-spacing MIN_STATEMENT_SPACING
Require at least this many newlines between statements
--max-statement-spacing MAX_STATEMENT_SPACING
Require no more than this many newlines between statements
--max-returns MAX_RETURNS
--max-branches MAX_BRANCHES
--max-arguments MAX_ARGUMENTS
--max-localvars MAX_LOCALVARS
--max-statements MAX_STATEMENTS
--emit-byteorder-mark [EMIT_BYTEORDER_MARK]
If true, emit the unicode byte-order mark (BOM) at the start of
the file
--input-encoding INPUT_ENCODING
Specify the encoding of the input file. Defaults to utf-8
--output-encoding OUTPUT_ENCODING
Specify the encoding of the output file. Defaults to utf-8. Note
that cmake only claims to support utf-8 so be careful when using
anything else
AUTHORS
cmake-lint was written by Josh Bialkowski <josh.bialkowski@gmail.com>.
DISTRIBUTION
The latest version of cmake-lint may be downloaded from
⟨https://github.com/cheshirekow/cmake_format⟩
Manual cmake-lint(1)
Generated by dwww version 1.14 on Fri Oct 24 09:49:50 CEST 2025.