cmd/shell: fix incorrect documentation

docs/cli.md

@@ -637,10 +637,12 @@ Note that this command has no option.
 
 ## shell
 
-The `shell` command spawns a shell,
-according to the `$SHELL` environment variable,
-within the virtual environment.
-If one doesn't exist yet, it will be created.
+The shell command spawns a shell within the project's virtual environment.
+
+By default, the current active shell is detected and used. Failing that,
+the shell defined via the `SHELL` (on posix) or `COMSPEC` (on windows) is used.
+
+If a virtual environment does not exist, it will be created.
 
 ```bash
 poetry shell
@@ -650,6 +652,11 @@ Note that this command starts a new shell and activates the virtual environment.
 
 As such, `exit` should be used to properly exit the shell and the virtual environment instead of `deactivate`.
 
+{{% note %}}
+Poetry internally uses the [Shellingham](https://github.com/sarugaku/shellingham) project to detect current
+active shell.
+{{% /note %}}
+
 ## check
 
 The `check` command validates the content of the `pyproject.toml` file

src/poetry/console/commands/shell.py

@@ -1,8 +1,8 @@
 from __future__ import annotations
 
+import os
 import sys
 
-from os import environ
 from typing import TYPE_CHECKING
 from typing import cast
 
@@ -17,9 +17,12 @@ class ShellCommand(EnvCommand):
     name = "shell"
     description = "Spawns a shell within the virtual environment."
 
-    help = """The <info>shell</> command spawns a shell, according to the
-<comment>$SHELL</> environment variable, within the virtual environment.
-If one doesn't exist yet, it will be created.
+    help = f"""The <info>shell</> command spawns a shell within the project's virtual environment.
+
+By default, the current active shell is detected and used. Failing that,
+the shell defined via the <comment>{'COMSPEC' if os.name == 'nt' else 'SHELL'}</> is used.
+
+If a virtual environment does not exist, it will be created.
 """
 
     def handle(self) -> int:
@@ -41,14 +44,14 @@ def handle(self) -> int:
         env = cast("VirtualEnv", env)
 
         # Setting this to avoid spawning unnecessary nested shells
-        environ["POETRY_ACTIVE"] = "1"
+        os.environ["POETRY_ACTIVE"] = "1"
         shell = Shell.get()
         shell.activate(env)
-        environ.pop("POETRY_ACTIVE")
+        os.environ.pop("POETRY_ACTIVE")
 
         return 0
 
     def _is_venv_activated(self) -> bool:
-        return bool(environ.get("POETRY_ACTIVE")) or getattr(
+        return bool(os.environ.get("POETRY_ACTIVE")) or getattr(
             sys, "real_prefix", sys.prefix
         ) == str(self.env.path)