NAME

       clang-format - manual page for clang-format 12

DESCRIPTION

       OVERVIEW: A tool to format C/C++/Java/JavaScript/Objective-C/Protobuf/C# code.

       If  no  arguments  are  specified,  it formats the code from standard input and writes the
       result to the standard output.  If <file>s are given, it reformats the  files.  If  -i  is
       specified  together  with <file>s, the files are edited in-place. Otherwise, the result is
       written to the standard output.

       USAGE: clang-format [options] [<file> ...]

       OPTIONS:

       Clang-format options:

       --Werror                   - If set, changes formatting warnings to errors

       --Wno-error=<value>        - If set don't error out on the specified warning type.

       =unknown
              -   If set, unknown format options are only warned about.

       This can be used to enable formatting, even if the
              configuration contains unknown (newer) options.  Use with caution,  as  this  might
              lead  to  dramatically  differing  format depending on an option being supported or
              not.

       --assume-filename=<string> - Override filename used to determine the language.
              When reading from stdin,  clang-format  assumes  this  filename  to  determine  the
              language.

       --cursor=<uint>            - The position of the cursor when invoking
              clang-format from an editor integration

       --dry-run                  - If set, do not actually make the formatting changes

       --dump-config              - Dump configuration options to stdout and exit.
              Can be used with -style option.

       --fallback-style=<string>  - The name of the predefined style used as a
              fallback  in  case  clang-format  is invoked with -style=file, but can not find the
              .clang-format file to use.  Use -fallback-style=none to skip formatting.

       --ferror-limit=<uint>      - Set the maximum number of clang-format errors to emit  before
              stopping (0 = no limit). Used only with --dry-run or -n

       -i                         - Inplace edit <file>s, if specified.

       --length=<uint>            - Format a range of this length (in bytes).
              Multiple  ranges  can be formatted by specifying several -offset and -length pairs.
              When only a single -offset is specified without -length, clang-format  will  format
              up to the end of the file.  Can only be used with one input file.

       --lines=<string>           - <start line>:<end line> - format a range of
              lines  (both  1-based).   Multiple  ranges  can  be formatted by specifying several
              -lines arguments.  Can't be used with -offset and -length.  Can only be  used  with
              one input file.

       -n                         - Alias for --dry-run

       --offset=<uint>            - Format a range starting at this byte offset.
              Multiple  ranges  can be formatted by specifying several -offset and -length pairs.
              Can only be used with one input file.

       --output-replacements-xml  - Output replacements as XML.

       --sort-includes            - If set, overrides the include sorting behavior determined  by
              the SortIncludes style flag

       --style=<string>           - Coding style, currently supports:
              LLVM, GNU, Google, Chromium, Microsoft, Mozilla, WebKit.

       Use -style=file to load style configuration from
              .clang-format  file located in one of the parent directories of the source file (or
              current directory for stdin).  Use  -style="{key:  value,  ...}"  to  set  specific
              parameters, e.g.:

              -style="{BasedOnStyle: llvm, IndentWidth: 8}"

       --verbose                  - If set, shows the list of processed files

       Generic Options:

       --help                     - Display available options (--help-hidden for more)

       --help-list                 -  Display  list  of available options (--help-list-hidden for
              more)

       --version                  - Display the version of this program