Code::Blocks - User contributions [en]

CB Clangd Client

2024-11-15T18:02:40Z

Pecan: /* Windows: Compiler Clangd/LLVM Package Installer */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==
clangd understands your C++ code and adds smart features to your editor

* code completion
* compile errors
* go-to-definition
* go-to-implementation
* find references

and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

* call tips
* function definitions
* parameter definitions
* previous and next function positioning
* symbols browser
* go-to-file
* go-to-function
* symbol renaming

NOTE: A CodeBlocks '''project is required''' for Clangd_client.

Clangd_client does not work with non-project translation units.

A project provides the necessary resources to interface between the Editor and the Clangd server.
----

=='''Configuring clangd_client'''==
Clangd_client requires the third-party binary clangd executable.

See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.

or '''Linux: Clangd executable install process'''

After a successful clangd executable install, perform the following:<blockquote>Disable the "CodeCompletion" plugin.

* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.

'''Restart Codeblocks'''.

Tell CodeBlocks (or verify) where the clangd executable resides:

* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
</blockquote>
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#:'''Windows Clangd executable install process'''
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
#: Some examples of this could be:
#:* C:\msys64\clang64\bin\clangd.exe
#:* C:\msys64\clang32\bin\clangd.exe
#:* C:\msys64\mingw64\bin\clangd.exe
#:* C:\msys64\mingw32\bin\clangd.exe
#:* C:\LLVM\bin\clangd.exe
#:* C:\comilers\clang\clangd.exe
----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
# If you want to reuse older code completion remember to re-enable the plugin and restart CodeBlocks.
----

== '''Windows: Clangd executable install process:''' ==
There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
The process for the three options above are detailed below.
----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page: https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.8
#: As of Jan 2022 the Windows files are named as follows:
#:* LLVM-<version>-win64.exe
#:* LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:
+------------------------------------------+------------------------+
<nowiki>| Package |</nowiki> Clangd executable |
+------------------------------------------+------------------------+
<nowiki>| mingw-w64-clang-x86_64-clang-tools-extra |</nowiki> clang64/bin/clangd.exe |
<nowiki>| mingw-w64-x86_64-clang-tools-extra |</nowiki> mingw64/bin/clangd.exe |
<nowiki>| mingw-w64-ucrt-x86_64-clang-tools-extra |</nowiki> ucrt64/bin/clangd.exe |
+------------------------------------------+------------------------+
<nowiki> </nowiki> To intall the package do the following:
<nowiki> </nowiki> a) Open the msys2.exe bash shell
<nowiki> </nowiki> b) Run the following command:
<nowiki> </nowiki> pacman -S <Package name in the table above>
<nowiki> </nowiki> <nowiki>'''</nowiki>OR<nowiki>'''</nowiki>
<nowiki> </nowiki> 2) The second option is to intall the full Clang tool chain as follows:
<nowiki> </nowiki> a) Open the msys2.exe bash shell
<nowiki> </nowiki> b) Run the following command:
<nowiki> </nowiki> pacman -S mingw-w64-clang-x86_64-toolchain
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>'''[https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412 Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables]'''

'''Don't mix mingw64 with clang64'''.

If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''), you should use "mingw-w64-x86_64-clang-tools-extra", (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe. If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''), you should use "mingw-w64-clang-x86_64-clang-tools-extra". I found that I just make a big mistake. That is: I used the gcc toolchain from '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''. The result is I got a lot of LSP diagnostics messages and errors. Luckily I found the reason, and fixed this issue. Hope this will help others.

'''A note from eckard_klotz:'''

I faced the same issue. But I'm using the build-suite under in the folder "msys64\'''ucrt64'''\bin" and thus, I had to install package '''mingw-w64-ucrt-x86_64-clang-tools-extra''' for adding the clangd tool to my compiler-suite.
-----
== '''Linux: Clangd executable install process:''' ==
NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.

Check your current clangd version by running '''clangd --version'''

If the version is less than 13 you will have to install a newer version.

See https://clangd.llvm.org/installation.html<blockquote>Installing the clangd package will usually give you a slightly older version.

Test this by issuing '''apt-get install --dry-run clangd'''

As of 2022/11/16, this suggest that clangd version 10 will be installed.</blockquote>If the clangd version shows less than version 13, you'll have to install a specific version as follows:<blockquote>Install a packaged release (''must be version 13 or greater''):

'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.</blockquote>This will install clangd as '''/usr/bin/clangd-13'''.

You can now configure clangd_client plugin by following the above instructions at

[https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

If you prefer to install the entire LLVM/Clang package, for convenience, there is an automatic installation script available that installs LLVM for you.

To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.

Note that you can specify the version number with this script.
----

CB Clangd Client

2024-10-15T15:34:22Z

Pecan: /* What is Clangd */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==
clangd understands your C++ code and adds smart features to your editor

* code completion
* compile errors
* go-to-definition
* go-to-implementation
* find references

and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

* call tips
* function definitions
* parameter definitions
* previous and next function positioning
* symbols browser
* go-to-file
* go-to-function
* symbol renaming

NOTE: A CodeBlocks '''project is required''' for Clangd_client.

Clangd_client does not work with non-project translation units.

A project provides the necessary resources to interface between the Editor and the Clangd server.
----

=='''Configuring clangd_client'''==
Clangd_client requires the third-party binary clangd executable.

See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.

or '''Linux: Clangd executable install process'''

After a successful clangd executable install, perform the following:<blockquote>Disable the "CodeCompletion" plugin.

* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.

'''Restart Codeblocks'''.

Tell CodeBlocks (or verify) where the clangd executable resides:

* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
</blockquote>
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#:'''Windows Clangd executable install process'''
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
#: Some examples of this could be:
#:* C:\msys64\clang64\bin\clangd.exe
#:* C:\msys64\clang32\bin\clangd.exe
#:* C:\msys64\mingw64\bin\clangd.exe
#:* C:\msys64\mingw32\bin\clangd.exe
#:* C:\LLVM\bin\clangd.exe
#:* C:\comilers\clang\clangd.exe
----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
# If you want to reuse older code completion remember to re-enable the plugin and restart CodeBlocks.
----

== '''Windows: Clangd executable install process:''' ==
There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
The process for the three options above are detailed below.
----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page: https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.8
#: As of Jan 2022 the Windows files are named as follows:
#:* LLVM-<version>-win64.exe
#:* LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:
+------------------------------------------+------------------------+
<nowiki>| Package |</nowiki> Clangd executable |
+------------------------------------------+------------------------+
<nowiki>| mingw-w64-clang-x86_64-clang-tools-extra |</nowiki> clang64/bin/clangd.exe |
<nowiki>| mingw-w64-x86_64-clang-tools-extra |</nowiki> mingw64/bin/clangd.exe |
<nowiki>| mingw-w64-ucrt-x86_64-clang-tools-extra |</nowiki> ucrt64/bin/clangd.exe |
+------------------------------------------+------------------------+
<nowiki> </nowiki> To intall the package do the following:
<nowiki> </nowiki> a) Open the msys2.exe bash shell
<nowiki> </nowiki> b) Run the following command:
<nowiki> </nowiki> pacman -S <Package name in the table above>
<nowiki> </nowiki> <nowiki>'''</nowiki>OR<nowiki>'''</nowiki>
<nowiki> </nowiki> 2) The second option is to intall the full Clang tool chain as follows:
<nowiki> </nowiki> a) Open the msys2.exe bash shell
<nowiki> </nowiki> b) Run the following command:
<nowiki> </nowiki> pacman -S mingw-w64-clang-x86_64-toolchain
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>'''[https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412 Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables]'''

'''Don't mix mingw64 with clang64'''.

If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''), you should use "mingw-w64-x86_64-clang-tools-extra", (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe. If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''), you should use "mingw-w64-clang-x86_64-clang-tools-extra". I found that I just make a big mistake. That is: I used the gcc toolchain from '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''. The result is I got a lot of LSP diagnostics messages and errors. Luckily I found the reason, and fixed this issue. Hope this will help others.
-----
== '''Linux: Clangd executable install process:''' ==
NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.

Check your current clangd version by running '''clangd --version'''

If the version is less than 13 you will have to install a newer version.

See https://clangd.llvm.org/installation.html<blockquote>Installing the clangd package will usually give you a slightly older version.

Test this by issuing '''apt-get install --dry-run clangd'''

As of 2022/11/16, this suggest that clangd version 10 will be installed.</blockquote>If the clangd version shows less than version 13, you'll have to install a specific version as follows:<blockquote>Install a packaged release (''must be version 13 or greater''):

'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.</blockquote>This will install clangd as '''/usr/bin/clangd-13'''.

You can now configure clangd_client plugin by following the above instructions at

[https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

If you prefer to install the entire LLVM/Clang package, for convenience, there is an automatic installation script available that installs LLVM for you.

To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.

Note that you can specify the version number with this script.
----

CB Clangd Client

2024-10-15T15:32:52Z

Pecan: /* What is Clangd */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==
clangd understands your C++ code and adds smart features to your editor

* code completion
* compile errors
* go-to-definition
* go-to-implementation
* find references

and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

* call tips
* function definitions
* parameter definitions
* previous and next function positioning
* symbols browser
* go-to-file
* go-to-function
* symbol renaming

NOTE: A CodeBlocks project is required for Clangd_client.

Clangd_client does not work with non-project translation units.

A project provides the necessary resources to interface between the Editor and the Clangd server.
----

=='''Configuring clangd_client'''==
Clangd_client requires the third-party binary clangd executable.

See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.

or '''Linux: Clangd executable install process'''

After a successful clangd executable install, perform the following:<blockquote>Disable the "CodeCompletion" plugin.

* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.

'''Restart Codeblocks'''.

Tell CodeBlocks (or verify) where the clangd executable resides:

* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
</blockquote>
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#:'''Windows Clangd executable install process'''
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
#: Some examples of this could be:
#:* C:\msys64\clang64\bin\clangd.exe
#:* C:\msys64\clang32\bin\clangd.exe
#:* C:\msys64\mingw64\bin\clangd.exe
#:* C:\msys64\mingw32\bin\clangd.exe
#:* C:\LLVM\bin\clangd.exe
#:* C:\comilers\clang\clangd.exe
----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
# If you want to reuse older code completion remember to re-enable the plugin and restart CodeBlocks.
----

== '''Windows: Clangd executable install process:''' ==
There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
The process for the three options above are detailed below.
----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page: https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.8
#: As of Jan 2022 the Windows files are named as follows:
#:* LLVM-<version>-win64.exe
#:* LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:
+------------------------------------------+------------------------+
<nowiki>| Package |</nowiki> Clangd executable |
+------------------------------------------+------------------------+
<nowiki>| mingw-w64-clang-x86_64-clang-tools-extra |</nowiki> clang64/bin/clangd.exe |
<nowiki>| mingw-w64-x86_64-clang-tools-extra |</nowiki> mingw64/bin/clangd.exe |
<nowiki>| mingw-w64-ucrt-x86_64-clang-tools-extra |</nowiki> ucrt64/bin/clangd.exe |
+------------------------------------------+------------------------+
<nowiki> </nowiki> To intall the package do the following:
<nowiki> </nowiki> a) Open the msys2.exe bash shell
<nowiki> </nowiki> b) Run the following command:
<nowiki> </nowiki> pacman -S <Package name in the table above>
<nowiki> </nowiki> <nowiki>'''</nowiki>OR<nowiki>'''</nowiki>
<nowiki> </nowiki> 2) The second option is to intall the full Clang tool chain as follows:
<nowiki> </nowiki> a) Open the msys2.exe bash shell
<nowiki> </nowiki> b) Run the following command:
<nowiki> </nowiki> pacman -S mingw-w64-clang-x86_64-toolchain
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>'''[https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412 Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables]'''

'''Don't mix mingw64 with clang64'''.

If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''), you should use "mingw-w64-x86_64-clang-tools-extra", (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe. If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''), you should use "mingw-w64-clang-x86_64-clang-tools-extra". I found that I just make a big mistake. That is: I used the gcc toolchain from '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''. The result is I got a lot of LSP diagnostics messages and errors. Luckily I found the reason, and fixed this issue. Hope this will help others.
-----
== '''Linux: Clangd executable install process:''' ==
NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.

Check your current clangd version by running '''clangd --version'''

If the version is less than 13 you will have to install a newer version.

See https://clangd.llvm.org/installation.html<blockquote>Installing the clangd package will usually give you a slightly older version.

Test this by issuing '''apt-get install --dry-run clangd'''

As of 2022/11/16, this suggest that clangd version 10 will be installed.</blockquote>If the clangd version shows less than version 13, you'll have to install a specific version as follows:<blockquote>Install a packaged release (''must be version 13 or greater''):

'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.</blockquote>This will install clangd as '''/usr/bin/clangd-13'''.

You can now configure clangd_client plugin by following the above instructions at

[https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

If you prefer to install the entire LLVM/Clang package, for convenience, there is an automatic installation script available that installs LLVM for you.

To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.

Note that you can specify the version number with this script.
----

CB Clangd Client

2024-10-15T15:31:27Z

Pecan: /* What is Clangd */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==
clangd understands your C++ code and adds smart features to your editor

* code completion
* compile errors
* go-to-definition
* go-to-implementation
* find references

and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

* call tips
* function definitions
* parameter definitions
* previous and next function positioning
* symbols browser
* go-to-file
* go-to-function
* symbol renaming

NOTE: A CodeBlocks project is required for Clangd_client.

Clangd_client does not work with non-project translation units.

A project provides the necessary resources to interface to the Editor and the Clangd server.
----

=='''Configuring clangd_client'''==
Clangd_client requires the third-party binary clangd executable.

See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.

or '''Linux: Clangd executable install process'''

After a successful clangd executable install, perform the following:<blockquote>Disable the "CodeCompletion" plugin.

* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.

'''Restart Codeblocks'''.

Tell CodeBlocks (or verify) where the clangd executable resides:

* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
</blockquote>
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#:'''Windows Clangd executable install process'''
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
#: Some examples of this could be:
#:* C:\msys64\clang64\bin\clangd.exe
#:* C:\msys64\clang32\bin\clangd.exe
#:* C:\msys64\mingw64\bin\clangd.exe
#:* C:\msys64\mingw32\bin\clangd.exe
#:* C:\LLVM\bin\clangd.exe
#:* C:\comilers\clang\clangd.exe
----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
# If you want to reuse older code completion remember to re-enable the plugin and restart CodeBlocks.
----

== '''Windows: Clangd executable install process:''' ==
There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
The process for the three options above are detailed below.
----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page: https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.8
#: As of Jan 2022 the Windows files are named as follows:
#:* LLVM-<version>-win64.exe
#:* LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:
+------------------------------------------+------------------------+
<nowiki>| Package |</nowiki> Clangd executable |
+------------------------------------------+------------------------+
<nowiki>| mingw-w64-clang-x86_64-clang-tools-extra |</nowiki> clang64/bin/clangd.exe |
<nowiki>| mingw-w64-x86_64-clang-tools-extra |</nowiki> mingw64/bin/clangd.exe |
<nowiki>| mingw-w64-ucrt-x86_64-clang-tools-extra |</nowiki> ucrt64/bin/clangd.exe |
+------------------------------------------+------------------------+
<nowiki> </nowiki> To intall the package do the following:
<nowiki> </nowiki> a) Open the msys2.exe bash shell
<nowiki> </nowiki> b) Run the following command:
<nowiki> </nowiki> pacman -S <Package name in the table above>
<nowiki> </nowiki> <nowiki>'''</nowiki>OR<nowiki>'''</nowiki>
<nowiki> </nowiki> 2) The second option is to intall the full Clang tool chain as follows:
<nowiki> </nowiki> a) Open the msys2.exe bash shell
<nowiki> </nowiki> b) Run the following command:
<nowiki> </nowiki> pacman -S mingw-w64-clang-x86_64-toolchain
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>'''[https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412 Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables]'''

'''Don't mix mingw64 with clang64'''.

If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''), you should use "mingw-w64-x86_64-clang-tools-extra", (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe. If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''), you should use "mingw-w64-clang-x86_64-clang-tools-extra". I found that I just make a big mistake. That is: I used the gcc toolchain from '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''. The result is I got a lot of LSP diagnostics messages and errors. Luckily I found the reason, and fixed this issue. Hope this will help others.
-----
== '''Linux: Clangd executable install process:''' ==
NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.

Check your current clangd version by running '''clangd --version'''

If the version is less than 13 you will have to install a newer version.

See https://clangd.llvm.org/installation.html<blockquote>Installing the clangd package will usually give you a slightly older version.

Test this by issuing '''apt-get install --dry-run clangd'''

As of 2022/11/16, this suggest that clangd version 10 will be installed.</blockquote>If the clangd version shows less than version 13, you'll have to install a specific version as follows:<blockquote>Install a packaged release (''must be version 13 or greater''):

'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.</blockquote>This will install clangd as '''/usr/bin/clangd-13'''.

You can now configure clangd_client plugin by following the above instructions at

[https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

If you prefer to install the entire LLVM/Clang package, for convenience, there is an automatic installation script available that installs LLVM for you.

To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.

Note that you can specify the version number with this script.
----

CB Clangd Client

2024-08-05T17:53:10Z

Pecan: /* Windows: Install the LLVM compiler */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

.

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\msys64\mingw64\bin\clangd.exe
C:\msys64\mingw32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin and restart CodeBlocks.
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases/tag/llvmorg-18.1.8
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2024-07-31T18:11:18Z

Pecan: /* Windows: Install the LLVM compiler */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

.

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\msys64\mingw64\bin\clangd.exe
C:\msys64\mingw32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin and restart CodeBlocks.
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# The LLVM git hub project is no longer providing downloads for Windows other than those for Microsoft Visual C.
# This leaves only the Msys2 project as a source for clangd.exe for Windows CodeBlocks.
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2024-07-31T18:03:59Z

Pecan: /* Windows: Install the LLVM compiler */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

.

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\msys64\mingw64\bin\clangd.exe
C:\msys64\mingw32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin and restart CodeBlocks.
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# The LLVM git hub project is no longer providing downloads for Windows other than those for Microsoft Visual C.
# This leaves only the Msys2 project as a source for clangd.exe for Windows.
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2024-07-31T18:02:50Z

Pecan: /* Windows: Manually Extract File from LLVM compiler */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

.

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\msys64\mingw64\bin\clangd.exe
C:\msys64\mingw32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin and restart CodeBlocks.
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# The LLVM git hub project is no longer providing downloads for Windows other than those for Microsoft Visual C.
# This leaves only the Msys2 project as a source for clangd.exe
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2024-07-31T18:01:12Z

Pecan: /* Windows: Install the LLVM compiler */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

.

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\msys64\mingw64\bin\clangd.exe
C:\msys64\mingw32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin and restart CodeBlocks.
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# The LLVM git hub project is no longer providing downloads for Windows other than those for Microsoft Visual C.
# This leaves only the Msys2 project as a source for clangd.exe
----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# <s>Create a new directory to put the clangd.exe and dll's</s>
# <s>Copy the following files into a the new directory created from the unziped #::LLVM directory:</s>
#:: <s>bin\clangd.exe</s>
#:: <s>bin\msvcp140.dll</s>
#:: <s>bin\vcruntime140.dll</s>
#:: <s>bin\vcruntime140_1.dll</s>
#:I've found that copying the exe and dll's out of the LLVM folder causes Clangd to issue incorrect error messages. It's best to just point Clangd_client to the ...\LLMV\bin\clangd.exe @ CodeBlocks MainMenu->Settings->Editor->Clangd_client->C.C++ parser->Specify clangd executable to use.
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2024-07-31T17:58:56Z

Pecan: /* Windows: Install the LLVM compiler */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

.

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\msys64\mingw64\bin\clangd.exe
C:\msys64\mingw32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin and restart CodeBlocks.
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# The LLVM project is no longer providing downloads for Windows other than those for Microsoft Visual C.
----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# <s>Create a new directory to put the clangd.exe and dll's</s>
# <s>Copy the following files into a the new directory created from the unziped #::LLVM directory:</s>
#:: <s>bin\clangd.exe</s>
#:: <s>bin\msvcp140.dll</s>
#:: <s>bin\vcruntime140.dll</s>
#:: <s>bin\vcruntime140_1.dll</s>
#:I've found that copying the exe and dll's out of the LLVM folder causes Clangd to issue incorrect error messages. It's best to just point Clangd_client to the ...\LLMV\bin\clangd.exe @ CodeBlocks MainMenu->Settings->Editor->Clangd_client->C.C++ parser->Specify clangd executable to use.
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2024-07-31T17:52:44Z

Pecan: /* Manually Remove Clangd-Client Plugin */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

.

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\msys64\mingw64\bin\clangd.exe
C:\msys64\mingw32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin and restart CodeBlocks.
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# <s>Create a new directory to put the clangd.exe and dll's</s>
# <s>Copy the following files into a the new directory created from the unziped #::LLVM directory:</s>
#:: <s>bin\clangd.exe</s>
#:: <s>bin\msvcp140.dll</s>
#:: <s>bin\vcruntime140.dll</s>
#:: <s>bin\vcruntime140_1.dll</s>
#:I've found that copying the exe and dll's out of the LLVM folder causes Clangd to issue incorrect error messages. It's best to just point Clangd_client to the ...\LLMV\bin\clangd.exe @ CodeBlocks MainMenu->Settings->Editor->Clangd_client->C.C++ parser->Specify clangd executable to use.
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2024-07-31T17:51:20Z

Pecan: /* Installing Clangd_client from source or pre-built binary */

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

.

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\msys64\mingw64\bin\clangd.exe
C:\msys64\mingw32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# <s>Create a new directory to put the clangd.exe and dll's</s>
# <s>Copy the following files into a the new directory created from the unziped #::LLVM directory:</s>
#:: <s>bin\clangd.exe</s>
#:: <s>bin\msvcp140.dll</s>
#:: <s>bin\vcruntime140.dll</s>
#:: <s>bin\vcruntime140_1.dll</s>
#:I've found that copying the exe and dll's out of the LLVM folder causes Clangd to issue incorrect error messages. It's best to just point Clangd_client to the ...\LLMV\bin\clangd.exe @ CodeBlocks MainMenu->Settings->Editor->Clangd_client->C.C++ parser->Specify clangd executable to use.
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2024-03-15T22:08:16Z

Pecan:

The repository page of this plugin is: [https://svn.code.sf.net/p/codeblocks/code/trunk/src/plugins/contrib/clangd_client https://sourceforge.net/projects/cb-clangd-client/]

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

.

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# <s>Create a new directory to put the clangd.exe and dll's</s>
# <s>Copy the following files into a the new directory created from the unziped #::LLVM directory:</s>
#:: <s>bin\clangd.exe</s>
#:: <s>bin\msvcp140.dll</s>
#:: <s>bin\vcruntime140.dll</s>
#:: <s>bin\vcruntime140_1.dll</s>
#:I've found that copying the exe and dll's out of the LLVM folder causes Clangd to issue incorrect error messages. It's best to just point Clangd_client to the ...\LLMV\bin\clangd.exe @ CodeBlocks MainMenu->Settings->Editor->Clangd_client->C.C++ parser->Specify clangd executable to use.
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2024-03-14T18:00:02Z

Pecan: /* Windows: Manually Extract File from LLVM compiler */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

.

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# <s>Create a new directory to put the clangd.exe and dll's</s>
# <s>Copy the following files into a the new directory created from the unziped #::LLVM directory:</s>
#:: <s>bin\clangd.exe</s>
#:: <s>bin\msvcp140.dll</s>
#:: <s>bin\vcruntime140.dll</s>
#:: <s>bin\vcruntime140_1.dll</s>
#:I've found that copying the exe and dll's out of the LLVM folder causes Clangd to issue incorrect error messages. It's best to just point Clangd_client to the ...\LLMV\bin\clangd.exe @ CodeBlocks MainMenu->Settings->Editor->Clangd_client->C.C++ parser->Specify clangd executable to use.
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2023-03-08T19:29:39Z

Pecan: /* Installing Clangd_client from source or pre-built binary */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

.

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2023-03-08T19:28:34Z

Pecan: /* Installing Clangd_client from source or pre-built binary */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==
Note: Clangd_client is now included as a contrib plugin within the "Nightly" builds.

Using a "Nightly" build is the easiest way to update to clangd_client.

Simply install the "Nightly" and configure as specified below.

See the Nightly builds at https://forums.codeblocks.org/index.php/board,20.0.html

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2023-03-08T19:14:42Z

Pecan: /* Configuring clangd_client */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a successful clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the clangd executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the clangd executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a clangd executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that clangd version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2022-11-17T20:15:57Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2022-11-17T20:13:04Z

Pecan:

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, thereis
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see [https://apt.llvm.org/] '''Automatic installation script'''.
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2022-11-17T20:07:13Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''
:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see '''Automatic installation script''' at
:::: apt.llvm.org
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2022-11-17T20:06:02Z

Pecan:

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''
:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see '''Automatic installation script''' at
apt.llvm.org
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2022-11-17T20:03:25Z

Pecan:

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''
:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see '''Automatic installation script''' at
:: Note that you can specify the version number with this script.

----

CB Clangd Client

2022-11-17T20:01:05Z

Pecan:

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''
:: 
:: If you prefer to install the entire LLVM/Clang package, for convenience, there is
:: an automatic installation script available that installs LLVM for you.
:: To install the latest stable version: see
----

CB Clangd Client

2022-11-17T20:00:07Z

Pecan:

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''
:: 
----

CB Clangd Client

2022-11-17T19:14:59Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
:::: [https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

----

CB Clangd Client

2022-11-17T19:11:51Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

[https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] '''Configuring clangd_client'''

----

CB Clangd Client

2022-11-17T19:02:36Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

[https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client] Configuring clangd_client

----

CB Clangd Client

2022-11-17T18:58:19Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

[LinkToIt]: https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client

----

CB Clangd Client

2022-11-17T18:54:56Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

[LinkToIt](https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client)

----

CB Clangd Client

2022-11-17T18:53:11Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

<https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client>

----

CB Clangd Client

2022-11-17T18:47:19Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

https://wiki.codeblocks.org/index.php/CB_Clangd_Client#Configuring_clangd_client

----

CB Clangd Client

2022-11-17T18:39:42Z

Pecan: /* Configuring clangd_client */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
:: 
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

----

CB Clangd Client

2022-11-17T18:38:51Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
ConfigureClient
======================================
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

----

CB Clangd Client

2022-11-17T18:36:10Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
ConfigureClient
======================================
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

[ConfigureClient](./#configureclientID)
<!-- ConfigureClient

CB Clangd Client

2022-11-17T18:35:08Z

Pecan: /* Configuring clangd_client */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
ConfigureClient
======================================
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

[ConfigureClient](./#configure_client)
<!-- span id="configure_client">ConfigureClient

CB Clangd Client

2022-11-17T18:32:00Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
ConfigureClient
======================================
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

[ConfigureClient](./#configure_client)
<!-- span id="configure_client">ConfigureClient

CB Clangd Client

2022-11-17T18:27:29Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
ConfigureClient
======================================
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

[ConfigureClient](./#configure_client)
ConfigureClient

CB Clangd Client

2022-11-17T18:22:40Z

Pecan: /* Configuring clangd_client */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".
ConfigureClient
======================================
----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

CB Clangd Client

2022-11-17T18:04:55Z

Pecan: /* Configuring clangd_client */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows: Compiler Clangd/LLVM Package Installer''' below to install it.
:: or '''Linux: Clangd executable install process'''

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify or enter the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

CB Clangd Client

2022-11-17T18:01:18Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows Compiler Clangd/LLVM Package Installer''' below to install it.

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.
:: 
:: You can now configure clangd_client plugin by following the above instructions at
::::'''Configuring clangd_client'''

CB Clangd Client

2022-11-17T17:57:47Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows Compiler Clangd/LLVM Package Installer''' below to install it.

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
:::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
:: 
::Install a packaged release (''must be version 13 or greater''):
::::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''.

CB Clangd Client

2022-11-17T17:46:04Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows Compiler Clangd/LLVM Package Installer''' below to install it.

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.
::See https://clangd.llvm.org/installation.html
:: 
::Installing the clangd package will usually give you a slightly older version.
::Test this by issuing '''apt-get install --dry-run clangd'''
::As of 2022/11/16, this suggest that cland version 10 will be installed.
::If the clangd version shows less than version 13, you'll have to install a specific version as follows:
::
::Try to install a packaged release (''must be version 13 or greater''):
:::'''sudo apt-get install clangd-13''' ''(Must be version 13 or greater)''.

::This will install clangd as '''/usr/bin/clangd-13'''. You can make it the default clangd with command
:::'''sudo update-alternatives --install /usr/bin/clangd clangd /usr/bin/clangd-13 100''' .
::This is not necessary for the CodeBlocks clangd_client plugin. You can tell the plugin to use '''/usr/bin/clangd-13''' without making it the system default.

CB Clangd Client

2022-11-17T17:11:04Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows Compiler Clangd/LLVM Package Installer''' below to install it.

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.
::
::Check your current clangd version by running '''clangd --version'''
::If the version is less than 13 you will have to install a newer version.

CB Clangd Client

2022-11-17T17:08:34Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows Compiler Clangd/LLVM Package Installer''' below to install it.

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client plugin requires a cland executable version 13 or greater.

CB Clangd Client

2022-11-17T17:08:02Z

Pecan: /* Linux: Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows Compiler Clangd/LLVM Package Installer''' below to install it.

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==
::
::NOTE: Clangd_client requires a cland executable version 13 or greater.

CB Clangd Client

2022-11-17T17:05:47Z

Pecan:

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows Compiler Clangd/LLVM Package Installer''' below to install it.

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----
== '''Linux: Clangd executable install process:''' ==

CB Clangd Client

2022-11-17T17:04:06Z

Pecan: /* Windows Compiler Clangd/LLVM Package Installer */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows Compiler Clangd/LLVM Package Installer''' below to install it.

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows: Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----

CB Clangd Client

2022-11-17T17:03:34Z

Pecan: /* Windows Clangd executable install process: */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows Compiler Clangd/LLVM Package Installer''' below to install it.

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows: Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----

CB Clangd Client

2022-11-17T17:02:22Z

Pecan: /* Manually Extract File from LLVM compiler */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows Compiler Clangd/LLVM Package Installer''' below to install it.

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Windows: Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----

CB Clangd Client

2022-11-17T17:01:25Z

Pecan: /* Windows: Install the LLVM compiler */

The repository page of this plugin is: https://sourceforge.net/projects/cb-clangd-client/

It uses [https://clangd.llvm.org/ clangd] through [https://en.wikipedia.org/wiki/Language_Server_Protocol Language Server Protocol].

The related forum discussion is: — [https://forums.codeblocks.org/index.php/topic,24357.html Code completion using LSP and clangd]
== '''What is Clangd'''==

clangd understands your C++ code and adds smart features to your editor:
:::* code completion
:::* compile errors
:::* go-to-definition
:::* go-to-implementation
:::* find references
::: and more.

clangd is a language server that can work with your editor via a plugin.
CodeBlocks provides Clangd_client as the needed plugin.

Clangd_client additionally enhances the clangd server by providing:

:::* call tips
:::* function definitions
:::* parameter definitions
:::* previous and next function positioning
:::* symbols browser
:::* go-to-file
:::* go-to-function
:::* symbol renaming

----

=='''Configuring clangd_client'''==
:: Clangd_client requires the third-party binary clangd executable.
:: See '''Windows Compiler Clangd/LLVM Package Installer''' below to install it.

:: After a success clangd executable install, perform the following:
:::Disable the "CodeCompletion" plugin.
::::* Navigate to Setting->Plugins->Manage Plugins and '''disable''' CodeCompletion.
::::* Navigate to Setting->Plugins->Manage Plugins and '''enable''' Clangd_client.
:::'''Restart Codeblocks'''.

:::Tell CodeBlocks (or verify) where the cland executable resides:
::::* Navigate to Setting->Editor->Clangd_client->C/C++ parser(tab) and verify the location of the cland executable in the box labeled "Specify clangd executable to use".

----

== '''Installing Clangd_client from source or pre-built binary ''' ==

# Install the LLVM or Clangd.exe as documented in the section below entitled:
#: '''Windows Clangd executable install process'''
#:: 
# Disable the Code completion plugin as follows:
#: a) Open the Plugin manager via Code::Blocks menu
#:: "MainMenu=>Plugins=>Manage plugins..."
#: b) In the Manage Plugin dialog do the following:
#:: i ) Find and select the "Code completion" plugin via it's title
#:: ii ) Press the "Disable" button on the right near the top
#:: iii) If you get any errors please try again.
#:: 
# Install the Clangd-Client Plugin using one of the following options, which are documented below:
#: a) Install via the Plugin Manager
#: b) Manually install the plugin files
#: 
# Configure the Clangd-Client Plugin for use as follows:
#: a) Select the CodeBlocks menu item "Settings->Editor..."
#: b) In the list on the left click/select the "clangd_client" option.
#: c) In the "C/C++ parser" tab change the "Specify clangd executable to use" to reference the clangd.exe you installed via step 1) above.
Some examples of this could be:
C:\msys64\clang64\bin\clangd.exe
C:\msys64\clang32\bin\clangd.exe
C:\LLVM\bin\clangd.exe
C:\comilers\clang\clangd.exe

----

== '''Manually Remove Clangd-Client Plugin''' ==

# Exit Code::Blocks!
#: 
# If you manually installed the files or used the Plugin manager then you can do the following:
#: a) In the Code::Blocks '''...\share\CodeBlocks''' folder delete the clangd_client.zip file
#: b) In the Code::Blocks '''...\share\CodeBlocks\plugins''' folder delete the clangd_client.dll file
#: 
# If you installed via the Plugin manager then you can delete the files with the following commands:
#: a) del '''%APPDATA%\CodeBlocks\share\codeblocks\plugins\clangd_client.dll'''
#: b) del '''%APPDATA%\CodeBlocks\share\codeblocks\clangd_client.zip'''
#: 
# If you want to reuse older code completion remember to re-enable the plugin
#: 
----

== '''Windows Clangd executable install process:''' ==

::There are three main options to install the clangd.exe:
# Install the LLVM compiler.
# Manully extract the required files from the LLVM compiler.
# Install the Clangd package for the Windows compiler you are using if it is available.
: 
::The process for the three options above are detailed below.

----

== '''Windows: Install the LLVM compiler''' ==

# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#: Github LLVM download page:
#: https://github.com/llvm/llvm-project/releases
#: 
#: As of Jan 2022 the Windows files are named as follows:
#: LLVM-<version>-win64.exe
#: LLVM-<version>-win32.exe
#: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#: 
# Run the LLVM-<version>-win<xx>.exe you downloaded to install the LLVM compiler.

----

== '''Manually Extract File from LLVM compiler''' ==
# Download the latest (non RC/Beta) LLVM Windows executable for your OS (Win32 or Win64) from the following
#:: Github LLVM download page:
#:: https://github.com/llvm/llvm-project/releases
#::
#:: As of Jan 2022 the Windows files are names as follows:
#:: LLVM-<version>-win64.exe
#:: LLVM-<version>-win32.exe
#:: where <version> is the LLVM version, like 13.0.0 or 13.0.1.
#::
# Unzip the LLVM-<version>-win<xx>.exe file you downloaded using 7zip or your prefered ZIP program into a sub directory
# Create a new directory to put the clangd.exe and dll's
# Copy the following files into a the new directory created from the unziped #::LLVM directory:
#:: bin\clangd.exe
#:: bin\msvcp140.dll
#:: bin\vcruntime140.dll
#:: bin\vcruntime140_1.dll
#::
----

== '''Windows Compiler Clangd/LLVM Package Installer''' ==
Due to the number of different compilers available for Windows not all of the compilers will have either/both the Clang or LLVM required files.

If you want to install the specific package(s) for the Windows compiler you are using in order to use it's clangd.exe file please follow the instructions below for the specific compiler you have installed:

'''MSYS2 Compiler - MinGW64'''
<pre>
There are two main options to install the clangd.exe as follows:
1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-x86_64-clang-tools-extra | clang64/bin/clangd.exe |
| mingw-w64-x86_64-clang-tools-extra | mingw64/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to intall the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-x86_64-toolchain
</pre>
'''MSYS2 Compiler - MinGW32'''
<pre>
There are two main options to install the clangd.exe as follows:

1) The first option in order to minimise disk space is to install the Clang extra
tools using one of the following packages:

+------------------------------------------+------------------------+
| Package | Clangd executable |
+------------------------------------------+------------------------+
| mingw-w64-clang-i686-clang-tools-extra | clang32/bin/clangd.exe |
| mingw-w64-i686-clang-tools-extra | mingw32/bin/clangd.exe |
+------------------------------------------+------------------------+

To intall the package do the following:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S <Package name in the table above>

'''OR'''

2) The second option is to install the full Clang tool chain as follows:
a) Open the msys2.exe bash shell
b) Run the following command:
pacman -S mingw-w64-clang-i686-toolchain
</pre>

-------------------------------------------------------------------------------------
'''Notes from the CodeBlocks forum to avoid mixing incompatible gcc/clangd executables.'''
-------------------------------------------------------------------------------------
https://forums.codeblocks.org/index.php/topic,24357.msg169412.html#msg169412

::: '''Don't mix mingw64 with clang64'''.

:: If you are using the gcc from msys2, (the compilers in the folder '''msys64\mingw64\bin'''),
:: you should use "mingw-w64-x86_64-clang-tools-extra",
:: (the clangd.exe is under the folder '''msys64\mingw64\bin''') the same folder as your gcc.exe.
:: 
:: If you are using the clang tool chain, (the folder '''msys64\clang64\bin'''),
:: you should use "mingw-w64-clang-x86_64-clang-tools-extra".

:: I found that I just make a big mistake. That is: I used the gcc toolchain from
:: '''msys64\mingw64\bin''', but I used the clangd.exe from '''msys64\clang64\bin'''.
:: The result is I got a lot of LSP diagnostics messages and errors.
:: Luckily I found the reason, and fixed this issue. Hope this will help others.
:: 
-----