1 Language Server Configuration

Lukas Scheller edited this page 2025-11-29 19:24:28 +01:00

Table of Contents

• Overview
• Command-line Arguments
• --no-lint
• --silent
• --libraries or -l
• Initialization Options
• nonProjectFiles

Overview

VHDL-LS is configured through two mechanisms:

1. Command-line arguments - Passed when starting the server
2. Initialization options - Sent by the LSP client during server initialization

Command-line Arguments

When starting the VHDL Language Server, the following command-line options are available:

--no-lint

• Type: Flag (boolean)
• Default: false
• Description: Disables diagnostic messages and linting. When enabled, the server only provides navigation and hover features.

--silent

• Type: Flag (boolean)
• Default: false
• Description: Silences all warning and error messages sent via window/showMessage. Messages will only be sent via window/logMessage, which typically goes to the language server logs rather than the UI.

--libraries or -l

• Type: String (file path)
• Default: Automatic standard paths discovery
• Description: Path to the vhdl_ls.toml configuration file for the VHDL standard libraries (e.g., IEEE std_logic_1164). If omitted, the server will search for these libraries in a set of standard paths.

Initialization Options

Initialization options are sent by the LSP client during the initialize request.

nonProjectFiles

• Type: String
• Default: "analyze"
• Description: Defines how the language server handles VHDL files that are not explicitly listed in the project configuration file.
• Valid Values:
  • "ignore" - Ignore files not part of the project defined in vhdl_ls.toml
  • "analyze" - Add non-project files to an anonymous library and analyze them