Merge pull request #6181 from jgreitemann/jg/kqvvzuzuzywv

docs(complete): Fix instructions for sourcing PowerShell completions

Author: epage

clap_complete/src/env/mod.rs

@@ -35,29 +35,32 @@
 //!
 //! </div>
 //!
-//! Bash
+//! **Bash**
 //! ```bash
 //! echo "source <(COMPLETE=bash your_program)" >> ~/.bashrc
 //! ```
 //!
-//! Elvish
+//! **Elvish**
 //! ```elvish
 //! echo "eval (E:COMPLETE=elvish your_program | slurp)" >> ~/.elvish/rc.elv
 //! ```
 //!
-//! Fish
+//! **Fish**
 //! ```fish
 //! echo "COMPLETE=fish your_program | source" >> ~/.config/fish/config.fish
 //! ```
 //!
-//! Powershell
+//! **Powershell**
 //! ```powershell
-//! $env:COMPLETE = "powershell"
-//! echo "your_program | Out-String | Invoke-Expression" >> $PROFILE
-//! Remove-Item Env:\COMPLETE
+//! echo '$env:COMPLETE = "powershell"; your_program | Out-String | Invoke-Expression; Remove-Item Env:\COMPLETE' >> $PROFILE
 //! ```
+//! Note that to execute scripts in PowerShell on Windows, including [`$PROFILE`][$Profile],
+//! the [execution policy][ExecutionPolicies] needs to be set to `RemoteSigned` at minimum.
 //!
-//! Zsh
+//! [$Profile]: https://learn.microsoft.com/en-us/powershell/scripting/learn/shell/creating-profiles
+//! [ExecutionPolicies]: https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies
+//!
+//! **Zsh**
 //! ```zsh
 //! echo "source <(COMPLETE=zsh your_program)" >> ~/.zshrc
 //! ```