{"id":5849,"date":"2020-03-31T09:30:41","date_gmt":"2020-03-31T16:30:41","guid":{"rendered":"https:\/\/visualgdb.com\/w\/?p=5849"},"modified":"2021-04-13T17:21:41","modified_gmt":"2021-04-14T00:21:41","slug":"intellisense-and-code-formatting-settings","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/documentation\/intellisense\/","title":{"rendered":"IntelliSense and Code Formatting Settings"},"content":{"rendered":"

VisualGDB includes its own Clang-based IntelliSense engine. It is specifically optimized to work with gcc-based embedded and Linux code and works better with Linux projects. VisualGDB can also use the regular VC++ IntelliSense engine, however it will be less precise and will often miss Linux-specific language constructs.<\/p>\n

You can tell which IntelliSense engine is presently active by locating to “Go” button on the top source file bar:<\/p>\n

\"\"<\/a>The button will only be present when using Clang IntelliSense and will not be shown otherwise.<\/p>\n

<\/a>Switching IntelliSense Engines<\/h2>\n

You can switch between the Clang IntelliSense and the regular VC++ IntelliSense via VisualGDB Project Properties -> IntelliSense:\"\"<\/a>You can observe the global state of the engine and turn it on\/off globally via View->Clang IntelliSense Status<\/strong>:\"\"<\/a><\/p>\n

Note that the regular VC++ IntelliSense will only work for VC++-based project types (the ones that have the Visual C++ Icon in Solution Explorer):\"\"<\/a>Advanced CMake, Arduino, Mbed and ESP-IDF projects only support Clang-based IntelliSense.<\/p>\n

<\/a>Formatting Settings<\/h2>\n

Starting from VisualGDB 5.4, VisualGDB supports the clang-format<\/strong> formatting engine. It is recommended for all new projects and can be fine-tuned by clicking the “Format” button in the top source bar:\"\"<\/a><\/p>\n

If the “Format” button is not shown, the currently open file is not handled by Clang-format and its formatting can be configured via Tools->Options->Text Editor->C\/C++ (VisualGDB)->Formatting<\/a><\/strong>.<\/p>\n

You can switch between clang-format <\/strong>and the legacy formatting engine via the IntelliSense Settings page of VisualGDB Project Properties:\"\"<\/a>If you are using clang-format<\/strong>, VisualGDB will format your code based on the settings in a .clang-format<\/strong> file determined as follows:<\/p>\n

    \n
  1. If a project has the “Use a custom .clang-format file” setting enabled in VisualGDB Project Properties -> IntelliSense Settings<\/strong>, the format file specified there will be used.<\/li>\n
  2. If not, VisualGDB will search every parent directory (up to the root directory, such as c:\\<\/strong>) of each opened file for .clang-format<\/strong> files. Once the file is found, it will be used to control the formatting of that source file. This allows using different formatting settings for different file groups in your project.<\/li>\n
  3. If no .clang-format<\/strong> files were found, VisualGDB will use the %LOCALAPPDATA%\\VisualGDB\\.clang-format<\/strong> file that contains basic settings derived from the regular VS settings (advanced formatting settings are not auto-translated and must be specified manually).<\/li>\n<\/ol>\n

    VisualGDB includes a convenient interactive editor for the .clang-format<\/strong> files. Simply open a .clang-format<\/strong> file via the File->Open<\/strong> command, or click the “Format” button in the upper right corner of your source file, and VisualGDB will open the corresponding .clang-format<\/strong> file in the interactive editor:\"\"<\/a>If you prefer editing the .clang-format<\/strong> files manually, you can find a detailed reference on their format here: https:\/\/clang.llvm.org\/docs\/ClangFormatStyleOptions.html<\/a><\/p>\n

    Warning: clang-format it slower than the legacy Sysprogs Formatting Engine. If you are working with large source files and automatic formatting (or newline indentation) works too slowly, please consider switching to the legacy formatting engine.<\/p>\n

    <\/a>CodeJumps<\/h2>\n

    CodeJumps are interactive annotations shown for functions, types, variables and other code entities. They are only supported when using Clang IntelliSense and can be temporarily suspended via the button in the top right corner of the source file editor:\"\"<\/a><\/p>\n

    \n
    \n
    \n
    \n

    You can also use the “Settings” button in the CodeJumps popups to customize various CodeJumps settings.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

    VisualGDB includes its own Clang-based IntelliSense engine. It is specifically optimized to work with gcc-based embedded and Linux code and<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[199],"tags":[],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/5849"}],"collection":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/comments?post=5849"}],"version-history":[{"count":8,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/5849\/revisions"}],"predecessor-version":[{"id":7281,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/5849\/revisions\/7281"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=5849"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=5849"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=5849"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}