aboutsummaryrefslogtreecommitdiffstats
path: root/doc/mason.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/mason.txt')
-rw-r--r--doc/mason.txt39
1 files changed, 23 insertions, 16 deletions
diff --git a/doc/mason.txt b/doc/mason.txt
index 5c6452e6..8bb8b762 100644
--- a/doc/mason.txt
+++ b/doc/mason.txt
@@ -239,15 +239,10 @@ Example:
---@type '"prepend"' | '"append"' | '"skip"'
PATH = "prepend",
- pip = {
- -- Whether to upgrade pip to the latest version in the virtual environment before installing packages.
- upgrade_pip = false,
-
- -- These args will be added to `pip install` calls. Note that setting extra args might impact intended behavior
- -- and is not recommended.
- --
- -- Example: { "--proxy", "https://proxyserver" }
- install_args = {},
+ -- The registries to source packages from. Accepts multiple entries. Should a package with the same name exist in
+ -- multiple registries, the registry listed first will be used.
+ registries = {
+ "lua:mason-registry.index",
},
-- Controls to which degree logs are written to the log file. It's useful to set this to vim.log.levels.DEBUG when
@@ -258,6 +253,16 @@ Example:
-- packages that are requested to be installed will be put in a queue.
max_concurrent_installers = 4,
+ -- The provider implementations to use for resolving supplementary package metadata (e.g., all available versions).
+ -- Accepts multiple entries, where later entries will be used as fallback should prior providers fail.
+ -- Builtin providers are:
+ -- - mason.providers.registry-api - uses the https://api.mason-registry.dev API
+ -- - mason.providers.client - uses only client-side tooling to resolve metadata
+ providers = {
+ "mason.providers.registry-api",
+ "mason.providers.client",
+ },
+
github = {
-- The template URL to use when downloading assets from GitHub.
-- The placeholders are the following (in order):
@@ -267,13 +272,15 @@ Example:
download_url_template = "https://github.com/%s/releases/download/%s/%s",
},
- -- The provider implementations to use for resolving package metadata (latest version, available versions, etc.).
- -- Accepts multiple entries, where later entries will be used as fallback should prior providers fail.
- -- Builtin providers are:
- -- - mason.providers.registry-api (default) - uses the https://api.mason-registry.dev API
- -- - mason.providers.client - uses only client-side tooling to resolve metadata
- providers = {
- "mason.providers.registry-api",
+ pip = {
+ -- Whether to upgrade pip to the latest version in the virtual environment before installing packages.
+ upgrade_pip = false,
+
+ -- These args will be added to `pip install` calls. Note that setting extra args might impact intended behavior
+ -- and is not recommended.
+ --
+ -- Example: { "--proxy", "https://proxyserver" }
+ install_args = {},
},
ui = {