Skip to content

Commit 0ba882f

Browse files
Merge pull request #12863 from MicrosoftDocs/main
Auto Publish – main to live - 2026-03-18 22:00 UTC
2 parents a52281f + 96dcd4a commit 0ba882f

File tree

7 files changed

+61
-41
lines changed

7 files changed

+61
-41
lines changed

reference/5.1/PSReadLine/About/about_PSReadLine.md

Lines changed: 35 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,24 @@
11
---
22
description: PSReadLine provides an improved command-line editing experience in the PowerShell console.
33
Locale: en-US
4-
ms.date: 08/18/2025
4+
ms.date: 03/18/2026
55
online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline?view=powershell-5.1&WT.mc_id=ps-gethelp
66
schema: 2.0.0
77
title: about_PSReadLine
88
---
99
# about_PSReadLine
1010

11-
## SHORT DESCRIPTION
11+
## Short description
1212

1313
PSReadLine provides an improved command-line editing experience in the
1414
PowerShell console.
1515

16-
## LONG DESCRIPTION
16+
## Long description
1717

1818
There have been many updates to PSReadLine since the version that ships in
1919
Windows PowerShell 5.1.
2020

21+
- v2.4.5 first shipped in PowerShell 7.6.0-rc.1
2122
- v2.3.6 first shipped in PowerShell 7.4.7 and 7.5.0
2223
- v2.3.5 first shipped in PowerShell 7.4.2 and 7.5.0-preview.3
2324
- v2.3.4 first shipped in PowerShell 7.4.0-rc.1
@@ -45,6 +46,9 @@ PowerShell console. It provides:
4546
- Bash style completion (optional in Cmd mode, default in Emacs mode)
4647
- Emacs yank/kill-ring
4748
- PowerShell token based "word" movement and deletion
49+
- Predictive IntelliSense
50+
- Dynamic display of Help in the console without losing your place on the
51+
command line
4852

4953
PSReadLine requires PowerShell 5.1, or newer. PSReadLine works with the default
5054
Windows console host, Windows Terminal, and Visual Studio Code. It doesn't work
@@ -57,7 +61,32 @@ in a supported version of PowerShell run the following command.
5761
Install-Module -Name PSReadLine -AllowClobber -Force
5862
```
5963

60-
## CUSTOM KEY BINDINGS
64+
## Predictive IntelliSense
65+
66+
Predictive IntelliSense is an addition to the concept of tab completion that
67+
assists the user in successfully completing commands. It enables users to
68+
discover, edit, and execute full commands based on matching predictions from the
69+
user's history and additional domain specific plugins.
70+
71+
### Enable Predictive IntelliSense
72+
73+
Predictive IntelliSense is disabled by default. To enable predictions, just run
74+
the following command:
75+
76+
```powershell
77+
Set-PSReadLineOption -PredictionSource History
78+
```
79+
80+
The **PredictionSource** parameter can also accept plugins for domain specific
81+
and custom requirements.
82+
83+
To disable Predictive IntelliSense, just run:
84+
85+
```powershell
86+
Set-PSReadLineOption -PredictionSource None
87+
```
88+
89+
## Custom key bindings
6190

6291
PSReadLine supports custom key bindings using the `Set-PSReadLineKeyHandler`
6392
cmdlet. Most custom key bindings call one of the [bindable functions][02], for
@@ -119,7 +148,7 @@ is installed in the **PSReadLine** module folder.
119148
Most key bindings use some helper functions for editing the command line. Those
120149
APIs are documented in [about_PSReadLine_Functions][02].
121150

122-
## NOTES
151+
## Notes
123152

124153
### Command History
125154

@@ -225,7 +254,7 @@ $Env:PGPASS = gcloud auth print-access-token
225254

226255
Feel free to submit a pull request or submit feedback on the GitHub page.
227256

228-
## SEE ALSO
257+
## See also
229258

230259
- PSReadLine is heavily influenced by the GNU [readline][04] library.
231260

reference/7.4/PSReadLine/About/about_PSReadLine.md

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: PSReadLine provides an improved command-line editing experience in the PowerShell console.
33
Locale: en-US
4-
ms.date: 08/18/2025
4+
ms.date: 03/18/2026
55
online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline?view=powershell-7.4&WT.mc_id=ps-gethelp
66
schema: 2.0.0
77
title: about_PSReadLine
@@ -18,6 +18,7 @@ PowerShell console.
1818
There have been many updates to PSReadLine since the version that ships in
1919
Windows PowerShell 5.1.
2020

21+
- v2.4.5 first shipped in PowerShell 7.6.0-rc.1
2122
- v2.3.6 first shipped in PowerShell 7.4.7 and 7.5.0
2223
- v2.3.5 first shipped in PowerShell 7.4.2 and 7.5.0-preview.3
2324
- v2.3.4 first shipped in PowerShell 7.4.0-rc.1
@@ -60,13 +61,6 @@ in a supported version of PowerShell run the following command.
6061
Install-Module -Name PSReadLine -AllowClobber -Force
6162
```
6263

63-
> [!NOTE]
64-
> Beginning with PowerShell 7.0, PowerShell skips autoloading PSReadLine on
65-
> Windows if a screen reader program is detected. Currently, PSReadLine doesn't
66-
> work well with the screen readers. The default rendering and formatting of
67-
> PowerShell 7.0 on Windows works properly. You can manually load the module if
68-
> necessary.
69-
7064
## Predictive IntelliSense
7165

7266
Predictive IntelliSense is an addition to the concept of tab completion that

reference/7.5/PSReadLine/About/about_PSReadLine.md

Lines changed: 2 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: PSReadLine provides an improved command-line editing experience in the PowerShell console.
33
Locale: en-US
4-
ms.date: 08/18/2025
4+
ms.date: 03/18/2026
55
online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline?view=powershell-7.5&WT.mc_id=ps-gethelp
66
schema: 2.0.0
77
title: about_PSReadLine
@@ -18,6 +18,7 @@ PowerShell console.
1818
There have been many updates to PSReadLine since the version that ships in
1919
Windows PowerShell 5.1.
2020

21+
- v2.4.5 first shipped in PowerShell 7.6.0-rc.1
2122
- v2.3.6 first shipped in PowerShell 7.4.7 and 7.5.0
2223
- v2.3.5 first shipped in PowerShell 7.4.2 and 7.5.0-preview.3
2324
- v2.3.4 first shipped in PowerShell 7.4.0-rc.1
@@ -60,13 +61,6 @@ in a supported version of PowerShell run the following command.
6061
Install-Module -Name PSReadLine -AllowClobber -Force
6162
```
6263

63-
> [!NOTE]
64-
> Beginning with PowerShell 7.0, PowerShell skips autoloading PSReadLine on
65-
> Windows if a screen reader program is detected. Currently, PSReadLine doesn't
66-
> work well with the screen readers. The default rendering and formatting of
67-
> PowerShell 7.0 on Windows works properly. You can manually load the module if
68-
> necessary.
69-
7064
## Predictive IntelliSense
7165

7266
Predictive IntelliSense is an addition to the concept of tab completion that

reference/7.6/PSReadLine/About/about_PSReadLine.md

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: PSReadLine provides an improved command-line editing experience in the PowerShell console.
33
Locale: en-US
4-
ms.date: 02/20/2026
4+
ms.date: 03/18/2026
55
online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline?view=powershell-7.6&WT.mc_id=ps-gethelp
66
schema: 2.0.0
77
title: about_PSReadLine
@@ -61,13 +61,6 @@ in a supported version of PowerShell run the following command.
6161
Install-Module -Name PSReadLine -AllowClobber -Force
6262
```
6363

64-
> [!NOTE]
65-
> Beginning with PowerShell 7.0, PowerShell skips autoloading PSReadLine on
66-
> Windows if a screen reader program is detected. Currently, PSReadLine doesn't
67-
> work well with the screen readers. The default rendering and formatting of
68-
> PowerShell 7.0 on Windows works properly. You can manually load the module if
69-
> necessary.
70-
7164
## Predictive IntelliSense
7265

7366
Predictive IntelliSense is an addition to the concept of tab completion that

reference/docs-conceptual/install/alternate-install-methods.md

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
description: Alternate ways to install PowerShell on non-Windows platforms.
3-
ms.date: 03/12/2026
3+
ms.date: 03/18/2026
44
title: Alternate ways to install PowerShell
55
---
66
# Alternate ways to install PowerShell
@@ -16,6 +16,10 @@ from the PowerShell Community or the operating system vendor. For support option
1616
Homebrew is the preferred package manager for macOS. If the `brew` command isn't found, you need to
1717
install Homebrew following [their instructions][12].
1818

19+
> [!IMPORTANT]
20+
> The brew formula is maintained and supported by the Homebrew community. The brew formula builds
21+
> PowerShell from source code rather than installing a package built by Microsoft.
22+
1923
```bash
2024
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2125
```
@@ -26,9 +30,16 @@ Once `brew` is installed, install PowerShell using the following command:
2630
brew install powershell
2731
```
2832

29-
> [!IMPORTANT]
30-
> The brew formula is maintained and supported by the Homebrew community. The brew formula builds
31-
> PowerShell from source code rather than installing a package built by Microsoft.
33+
If you previously installed PowerShell using the Homebrew cask, you must first uninstall the cask
34+
before you can successfully install using the Homebrew formula. Use the following commands to
35+
uninstall the cask:
36+
37+
```sh
38+
# Uninstall the PowerShell cask instance
39+
brew uninstall --cask powershell
40+
# Uninstall the PowerShell Preview cask instance
41+
brew uninstall --cask powershell-preview
42+
```
3243

3344
### Update PowerShell 7
3445

reference/docs-conceptual/install/install-powershell-on-windows.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -83,9 +83,9 @@ Latest stable release:
8383

8484
Latest Preview release:
8585

86-
- [PowerShell-7.6.0-rc1-win-x64.msi][20]
87-
- [PowerShell-7.6.0-rc1-win-x86.msi][21]
88-
- [PowerShell-7.6.0-rc1-win-arm64.msi][19]
86+
- [PowerShell-7.6.0-rc.1-win-x64.msi][20]
87+
- [PowerShell-7.6.0-rc.1-win-x86.msi][21]
88+
- [PowerShell-7.6.0-rc.1-win-arm64.msi][19]
8989

9090
Once downloaded, double-click the installer file and follow the prompts.
9191

@@ -329,9 +329,9 @@ can't support those methods.
329329
[16]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-x64.zip
330330
[17]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-x86.msi
331331
[18]: https://github.com/PowerShell/PowerShell/releases/download/v7.5.5/PowerShell-7.5.5-win-x86.zip
332-
[19]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-arm64.msi
333-
[20]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-x64.msi
334-
[21]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc1/PowerShell-7.6.0-rc1-win-x86.msi
332+
[19]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/PowerShell-7.6.0-rc.1-win-arm64.msi
333+
[20]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/PowerShell-7.6.0-rc.1-win-x64.msi
334+
[21]: https://github.com/PowerShell/PowerShell/releases/download/v7.6.0-rc.1/PowerShell-7.6.0-rc.1-win-x86.msi
335335
[22]: https://github.com/PowerShell/PowerShell/releases/latest
336336
[23]: https://www.microsoft.com/store/apps/9MZ1SNWT0N5D
337337
[24]: media/install-powershell-on-windows/powershell-start-menu.png

reference/docs-conceptual/toc.yml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -213,7 +213,6 @@ items:
213213
- name: Glossary
214214
href: learn/glossary.md
215215
- name: What's New in PowerShell
216-
expanded: true
217216
items:
218217
- name: Overview
219218
href: whats-new/overview.yml

0 commit comments

Comments
 (0)