clarify solver <-> specs interaction (#738)

conda · Dec 19, 2023 · 446e596 · 446e596
1 parent 09eb532
commit 446e596
Show file tree

Hide file tree

Showing 3 changed files with 15 additions and 9 deletions.
diff --git a/CONSTRUCT.md b/CONSTRUCT.md
@@ -95,9 +95,11 @@ by an exact URL; e.g.,
 `https://repo.anaconda.com/pkgs/main/osx-64/openssl-1.0.2o-h26aff7b_0.tar.bz2`.
 This key can also take a `str` pointing to a requirements file with the same syntax.
 
-The specs will be solved with the solver configured for your `base` conda installation,
-if any. Starting with conda 22.11, this behavior can be overriden with the
-`CONDA_SOLVER` environment variable.
+Note: `constructor` relies on `conda`'s Python API to solve the passed
+specifications. You can still set the `CONDA_SOLVER` environment variable
+to override system-wide settings for `constructor`. If you are using
+`constructor` from a non-`base` environment, make sure the
+configured solver plugin is also installed in that environment.
 
 ### `user_requested_specs`
 

diff --git a/constructor/construct.py b/constructor/construct.py
@@ -61,9 +61,11 @@
 `https://repo.anaconda.com/pkgs/main/osx-64/openssl-1.0.2o-h26aff7b_0.tar.bz2`.
 This key can also take a `str` pointing to a requirements file with the same syntax.
 
-The specs will be solved with the solver configured for your `base` conda installation,
-if any. Starting with conda 22.11, this behavior can be overriden with the
-`CONDA_SOLVER` environment variable.
+Note: `constructor` relies on `conda`'s Python API to solve the passed
+specifications. You can still set the `CONDA_SOLVER` environment variable
+to override system-wide settings for `constructor`. If you are using
+`constructor` from a non-`base` environment, make sure the
+configured solver plugin is also installed in that environment.
 '''),
 
     ('user_requested_specs',                  False, (list, str), '''

diff --git a/docs/source/construct-yaml.md b/docs/source/construct-yaml.md
@@ -95,9 +95,11 @@ by an exact URL; e.g.,
 `https://repo.anaconda.com/pkgs/main/osx-64/openssl-1.0.2o-h26aff7b_0.tar.bz2`.
 This key can also take a `str` pointing to a requirements file with the same syntax.
 
-The specs will be solved with the solver configured for your `base` conda installation,
-if any. Starting with conda 22.11, this behavior can be overriden with the
-`CONDA_SOLVER` environment variable.
+Note: `constructor` relies on `conda`'s Python API to solve the passed
+specifications. You can still set the `CONDA_SOLVER` environment variable
+to override system-wide settings for `constructor`. If you are using
+`constructor` from a non-`base` environment, make sure the
+configured solver plugin is also installed in that environment.
 
 ### `user_requested_specs`