Docs for new powershell conf

reference/tools/env/envvars.rst

@@ -28,8 +28,17 @@ method.
 
 It will generate automatically a ``my_env_file.bat`` for Windows systems or ``my_env_file.sh`` otherwise.
 
-It's possible to opt-in to generate Powershell ``.ps1`` scripts instead of ``.bat`` ones, using the
-conf ``tools.env.virtualenv:powershell=True``.
+It is possible to opt-in to generate PowerShell ``.ps1`` scripts instead of ``.bat`` ones, 
+by using the configuration ``tools.env.virtualenv:powershell``. This configuration should 
+be set with the value corresponding to the desired PowerShell executable: 
+``powershell.exe`` for versions up to 5.1, and ``pwsh`` for PowerShell versions starting 
+from 7. Note that setting ``tools.env.virtualenv:powershell`` to ``True`` or ``False`` is 
+deprecated as of Conan 2.11.0.
+
+You can also include additional arguments in the ``tools.env.virtualenv:powershell``
+configuration. For example, you can set the value to ``powershell.exe -NoProfile`` or
+``pwsh -NoProfile`` by including the arguments as part of the configuration value. These
+arguments will be considered when executing the generated ``.ps1`` launchers.
 
 Also, by default, Conan will automatically append that launcher file path to a list that will be used to
 create a ``conanbuild.bat|sh|ps1`` file aggregating all the launchers in order. The ``conanbuild.sh|bat|ps1`` launcher

reference/tools/env/virtualbuildenv.rst

@@ -65,7 +65,11 @@ will create the following files:
 
 .. note::
 
-    To create ``.ps1`` files required for Powershell it is necessary to set to True the following conf: ``tools.env.virtualenv:powershell``.
+    To create ``.ps1`` files required for PowerShell, you need to set the
+    ``tools.env.virtualenv:powershell`` configuration with the value of the PowerShell
+    executable (e.g., ``powershell.exe`` or ``pwsh``). Note that, setting it to ``True``
+    or ``False`` is deprecated as of Conan 2.11.0 and should no longer be used.
+
 
 .. note::
 

reference/tools/env/virtualrunenv.rst

@@ -62,7 +62,10 @@ current active configuration, like ``deactivate_conanrunenv-release-x86_64.bat``
 
 .. note::
 
-    To create ``.ps1`` files required for Powershell it is necessary to set to True the following conf: ``tools.env.virtualenv:powershell``.
+    To create ``.ps1`` files required for PowerShell, you need to set the
+    ``tools.env.virtualenv:powershell`` configuration with the value of the PowerShell
+    executable (e.g., ``powershell.exe`` or ``pwsh``). Note that, setting it to ``True``
+    or ``False`` is deprecated as of Conan 2.11.0 and should no longer be used.
 
 .. note::
 

tutorial/consuming_packages/use_tools_as_conan_packages.rst

@@ -89,9 +89,14 @@ files the folder *build*. To do that, just run:
 
 .. note::
 
-    **Powershell** users need to add ``--conf=tools.env.virtualenv:powershell=True`` to the previous command
-    to generate ``.ps1`` files instead of ``.bat`` files.
-    To avoid the need to add this line every time, we recommend configuring it in the ``[conf]`` section of your profile. For detailed information, please refer to the :ref:`profiles section<reference_config_files_profiles>`.
+    **PowerShell** users need to add ``--conf=tools.env.virtualenv:powershell=<executable>`` 
+    (e.g., ``powershell.exe`` or ``pwsh``) to the previous command to generate ``.ps1`` files 
+    instead of ``.bat`` files. Setting this configuration to ``True`` or ``False`` is deprecated 
+    as of Conan 2.11.0. 
+
+    To avoid the need to add this line every time, we recommend configuring it in the ``[conf]`` 
+    section of your profile. For detailed information, please refer to the 
+    :ref:`profiles section<reference_config_files_profiles>`.
 
 You can check the output: