NAME

       clangd - manual page for clangd 10

DESCRIPTION

       OVERVIEW: clangd is a language server that provides IDE-like features to editors.

   It should be used via an editor plugin rather than invoked directly. For more information, see:
              https://clang.llvm.org/extra/clangd/ https://microsoft.github.io/language-server-protocol/

       clangd accepts flags on the commandline, and in the CLANGD_FLAGS environment variable.

       USAGE: clangd [options]

       OPTIONS:

       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

       clangd compilation flags options:

       --compile-commands-dir=<string>  -  Specify a path to look for compile_commands.json. If path is invalid,
              clangd will look in the current directory and parent paths of each source file

       --query-driver=<string>         - Comma separated list of globs for white-listing gcc-compatible  drivers
              that  are  safe  to  execute.  Drivers  matching any of these globs will be used to extract system
              includes. e.g. /usr/bin/**/clang-*,/path/to/repo/**/g++-*

       clangd feature options:

       --all-scopes-completion         - If set to true, code completion will include index symbols that are not
              defined  in  the scopes (e.g. namespaces) visible from the code completion point. Such completions
              can insert scope qualifiers

       --background-index              - Index project code in the background and persist index on disk.

       --clang-tidy                    - Enable clang-tidy diagnostics

       --clang-tidy-checks=<string>    - List of clang-tidy  checks  to  run  (this  will  override  .clang-tidy
              files). Only meaningful when -clang-tidy flag is on

       --completion-style=<value>      - Granularity of code completion suggestions

       =detailed
              -   One completion item for each semantically distinct completion, with full type information

       =bundled
              -    Similar completion items (e.g. function overloads) are combined. Type information shown where
              possible

       --fallback-style=<string>       - clang-format style to apply by default when no  .clang-format  file  is
              found

       --header-insertion=<value>      - Add #include directives when accepting code completions

       =iwyu  -    Include  what  you  use. Insert the owning header for top-level symbols, unless the header is
              already directly included or the symbol is forward-declared

       =never -   Never insert #include directives as part of code completion

       --header-insertion-decorators   - Prepend a circular dot or space before the completion label,  depending
              on whether an include line will be inserted or not

       --limit-results=<int>            -  Limit  the  number  of  results  returned by clangd. 0 means no limit
              (default=100)

       --suggest-missing-includes      - Attempts to fix diagnostic errors  caused  by  missing  includes  using
              index

       clangd miscellaneous options:

       -j=<uint>                       - Number of async workers used by clangd. Background index also uses this
              many workers.

       --pch-storage=<value>           - Storing PCHs  in  memory  increases  memory  usages,  but  may  improve
              performance

       =disk  -   store PCHs on disk

       =memory
              -   store PCHs in memory

       clangd protocol and logging options:

       --log=<value>                   - Verbosity of log messages written to stderr

       =error
              -   Error messages only

       =info  -   High level execution tracing

       =verbose
              -   Low level details

       --offset-encoding=<value>        -  Force  the offsetEncoding used for character positions. This bypasses
              negotiation via client capabilities

       =utf-8
              -   Offsets are in UTF-8 bytes

       =utf-16
              -   Offsets are in UTF-16 code units

       =utf-32
              -   Offsets are in unicode codepoints

       --path-mappings=<string>        - Translates between client paths (as seen by a remote editor) and server
              paths  (where  clangd  sees  files on disk). Comma separated list of '<client_path>=<server_path>'
              pairs,     the     first     entry     matching     a     given     path     is     used.     e.g.
              /home/project/incl=/opt/include,/home/project=/workarea/project

       --pretty                        - Pretty-print JSON output