Merge pull request #11862 from MicrosoftDocs/main

3/3/2025 PM Publish

Author: Taojunshen

.github/ISSUE_TEMPLATE/04-customer-feedback.yml

@@ -1,5 +1,4 @@
 name: "📄 Feedback control template"
-title: "Feedback"
 description: >-
   ⛔ This template is intended for use by the feedback control on the bottom of every page on the
   live site. If you aren't using the feedback control, choose one of the other templates.⛔

reference/5.1/PSReadLine/About/about_PSReadLine.md

@@ -1,7 +1,7 @@
 ---
 description: PSReadLine provides an improved command-line editing experience in the PowerShell console.
 Locale: en-US
-ms.date: 09/17/2024
+ms.date: 03/03/2025
 online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline?view=powershell-5.1&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_PSReadLine
@@ -16,6 +16,7 @@ PowerShell console.
 There have been many updates to PSReadLine since the version that ships in
 Windows PowerShell 5.1.
 
+- v2.3.6 first shipped in PowerShell 7.4.7 and 7.5.0
 - v2.3.5 first shipped in PowerShell 7.4.2 and 7.5.0-preview.3
 - v2.3.4 first shipped in PowerShell 7.4.0-rc.1
 - v2.2.6 first shipped in PowerShell 7.3.0

reference/5.1/PSReadLine/About/about_PSReadLine_Functions.md

@@ -18,11 +18,11 @@ PowerShell console.
 ## Long Description
 
 PowerShell 5.1 ships with PSReadLine 2.0.0. The current version is PSReadLine
-2.3.4. The current version of PSReadLine can be installed and used on Windows
+2.3.6. The current version of PSReadLine can be installed and used on Windows
 PowerShell 5.1 and newer. For some features, you need to be running PowerShell
 7.2 or higher.
 
-This article documents the functions provided by PSReadLine. These functions
+This article documents the functions provided by PSReadLine 2.0.0. These functions
 can be bound to keystrokes for easy access and invocation.
 
 ## Using the Microsoft.PowerShell.PSConsoleReadLine class

reference/5.1/PSReadLine/About/about_PSReadLine_Release_Notes.md

@@ -1,7 +1,7 @@
 ---
 description: This article contains the list of changes for each released version of PSReadLine.
 Locale: en-US
-ms.date: 01/23/2025
+ms.date: 03/03/2025
 online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline_release_notes?view=powershell-5.1&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_PSReadLine_Release_Notes
@@ -11,7 +11,7 @@ title: about_PSReadLine_Release_Notes
 This is a summary of changes to the **PSReadLine** module. For a full list of
 changes, see the **PSReadLine** [ChangeLog][01].
 
-- Current preview: v2.4.0-beta0
+- Current preview: v2.4.0-beta1
 - Current stable release: v2.3.6
 
 ## PSReadLine release history
@@ -29,6 +29,13 @@ Windows PowerShell 5.1.
 
 ## Release Notes
 
+### v2.4.0-beta1 - 2025-02-28
+
+- Avoid querying for cursor position when it's not necessary
+- Handle buffer changes made by an event handler
+- Update SelectCommandArgument to properly handle POSIX style options for CLI
+  commands
+
 ### v2.4.0-beta0 - 2024-03-01
 
 - Fix copying text to system clipboard on Linux using `xclip`
@@ -75,7 +82,8 @@ enhancements:
 - Add the `TerminateOrphanedConsoleApps` option on Windows to kill orphaned
   console-attached process that may mess up reading from Console input
 - De-duplicate prediction results with the history results
-- Make tab completion show results whose `ListItemText` are different by case only
+- Make tab completion show results whose `ListItemText` are different by case
+  only
 - Add support for upcasing, downcasing, and capitalizing word
 - Handle multi-line description for parameter help content
 
@@ -143,9 +151,11 @@ release:
   logical line
 - Rename `PredictionColor` to `InlinePredictionColor`
 - Allow `MaximumHistoryCount` to be set from user's profile
-- Add the parameter `-PredictionSource` to `Set-PSReadLineOption`, with the options `None` and `History`
+- Add the parameter `-PredictionSource` to `Set-PSReadLineOption`, with the
+  options `None` and `History`
 - Make the functions `AcceptSuggestion` and `AcceptNextSuggestionWord` bindable
-- Relax the sensitive words we filter by changing `key` to `apikey` to reduce false positives
+- Relax the sensitive words we filter by changing `key` to `apikey` to reduce
+  false positives
 - Make `ViForwardChar` able to accept suggestions
 - Expose `ViBackwardChar` and `ViForwardChar` as bindable functions
 

reference/7.4/Microsoft.PowerShell.Core/About/about_Built-in_Functions.md

@@ -1,7 +1,7 @@
 ---
 description: Describes the built-in functions in PowerShell.
 Locale: en-US
-ms.date: 08/14/2024
+ms.date: 03/01/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_built-in_functions?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_Built-in_Functions
@@ -84,6 +84,15 @@ This function provides a short hand way to run `New-Item -Type Directory` with
 your parameters. This function is only defined for Windows systems. Linux and
 macOS system use the native `mkdir` command.
 
+## `exec`
+
+Some native Unix commands shell out to run something (like ssh) and use the
+built-in bash command `exec` to spawn a new process that replaces the current
+one. PowerShell 7.3.1 adds the `exec` function to wrap the
+[Switch-Process](xref:Microsoft.PowerShell.Core.Switch-Process) cmdlet.
+`Switch-Process` calls the native Unix `execv()` function to provide similar
+behavior as POSIX shells.
+
 ## Windows drive letter functions
 
 In Windows, drive mount points are associated with a drive letter like `C:`.

reference/7.4/PSReadLine/About/about_PSReadLine.md

@@ -1,7 +1,7 @@
 ---
 description: PSReadLine provides an improved command-line editing experience in the PowerShell console.
 Locale: en-US
-ms.date: 09/17/2024
+ms.date: 03/03/2025
 online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_PSReadLine
@@ -16,6 +16,7 @@ PowerShell console.
 There have been many updates to PSReadLine since the version that ships in
 Windows PowerShell 5.1.
 
+- v2.3.6 first shipped in PowerShell 7.4.7 and 7.5.0
 - v2.3.5 first shipped in PowerShell 7.4.2 and 7.5.0-preview.3
 - v2.3.4 first shipped in PowerShell 7.4.0-rc.1
 - v2.2.6 first shipped in PowerShell 7.3.0

reference/7.4/PSReadLine/About/about_PSReadLine_Functions.md

@@ -3,7 +3,7 @@ description: >
     This article documents the functions provided by PSReadLine. These functions
     can be bound to keystrokes for easy access and invocation.
 Locale: en-US
-ms.date: 10/16/2023
+ms.date: 03/03/2025
 online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline_functions?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_PSReadLine_Functions
@@ -18,11 +18,11 @@ PowerShell console.
 ## Long Description
 
 PowerShell 7.3 ships with PSReadLine 2.2.6. The current version is PSReadLine
-2.3.4. The current version of PSReadLine can be installed and used on Windows
+2.3.6. The current version of PSReadLine can be installed and used on Windows
 PowerShell 5.1 and newer. For some features, you need to be running PowerShell
 7.2 or higher.
 
-This article documents the functions provided by PSReadLine 2.3.4. These
+This article documents the functions provided by PSReadLine 2.3.6. These
 functions can be bound to keystrokes for easy access and invocation.
 
 ## Using the Microsoft.PowerShell.PSConsoleReadLine class

reference/7.4/PSReadLine/About/about_PSReadLine_Release_Notes.md

@@ -1,7 +1,7 @@
 ---
 description: This article contains the list of changes for each released version of PSReadLine.
 Locale: en-US
-ms.date: 01/23/2025
+ms.date: 03/03/2025
 online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline_release_notes?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_PSReadLine_Release_Notes
@@ -11,7 +11,7 @@ title: about_PSReadLine_Release_Notes
 This is a summary of changes to the **PSReadLine** module. For a full list of
 changes, see the **PSReadLine** [ChangeLog][01].
 
-- Current preview: v2.4.0-beta0
+- Current preview: v2.4.0-beta1
 - Current stable release: v2.3.6
 
 ## PSReadLine release history
@@ -29,6 +29,13 @@ Windows PowerShell 5.1.
 
 ## Release Notes
 
+### v2.4.0-beta1 - 2025-02-28
+
+- Avoid querying for cursor position when it's not necessary
+- Handle buffer changes made by an event handler
+- Update SelectCommandArgument to properly handle POSIX style options for CLI
+  commands
+
 ### v2.4.0-beta0 - 2024-03-01
 
 - Fix copying text to system clipboard on Linux using `xclip`
@@ -75,7 +82,8 @@ enhancements:
 - Add the `TerminateOrphanedConsoleApps` option on Windows to kill orphaned
   console-attached process that may mess up reading from Console input
 - De-duplicate prediction results with the history results
-- Make tab completion show results whose `ListItemText` are different by case only
+- Make tab completion show results whose `ListItemText` are different by case
+  only
 - Add support for upcasing, downcasing, and capitalizing word
 - Handle multi-line description for parameter help content
 
@@ -143,9 +151,11 @@ release:
   logical line
 - Rename `PredictionColor` to `InlinePredictionColor`
 - Allow `MaximumHistoryCount` to be set from user's profile
-- Add the parameter `-PredictionSource` to `Set-PSReadLineOption`, with the options `None` and `History`
+- Add the parameter `-PredictionSource` to `Set-PSReadLineOption`, with the
+  options `None` and `History`
 - Make the functions `AcceptSuggestion` and `AcceptNextSuggestionWord` bindable
-- Relax the sensitive words we filter by changing `key` to `apikey` to reduce false positives
+- Relax the sensitive words we filter by changing `key` to `apikey` to reduce
+  false positives
 - Make `ViForwardChar` able to accept suggestions
 - Expose `ViBackwardChar` and `ViForwardChar` as bindable functions
 

reference/7.5/Microsoft.PowerShell.Core/About/about_Built-in_Functions.md

@@ -1,7 +1,7 @@
 ---
 description: Describes the built-in functions in PowerShell.
 Locale: en-US
-ms.date: 08/14/2024
+ms.date: 03/01/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_built-in_functions?view=powershell-7.5&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_Built-in_Functions
@@ -84,6 +84,15 @@ This function provides a short hand way to run `New-Item -Type Directory` with
 your parameters. This function is only defined for Windows systems. Linux and
 macOS system use the native `mkdir` command.
 
+## `exec`
+
+Some native Unix commands shell out to run something (like ssh) and use the
+built-in bash command `exec` to spawn a new process that replaces the current
+one. PowerShell 7.3.1 adds the `exec` function to wrap the
+[Switch-Process](xref:Microsoft.PowerShell.Core.Switch-Process) cmdlet.
+`Switch-Process` calls the native Unix `execv()` function to provide similar
+behavior as POSIX shells.
+
 ## Windows drive letter functions
 
 In Windows, drive mount points are associated with a drive letter like `C:`.

reference/7.5/PSReadLine/About/about_PSReadLine.md

@@ -1,7 +1,7 @@
 ---
 description: PSReadLine provides an improved command-line editing experience in the PowerShell console.
 Locale: en-US
-ms.date: 09/17/2024
+ms.date: 03/03/2025
 online version: https://learn.microsoft.com/powershell/module/psreadline/about/about_psreadline?view=powershell-7.5&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_PSReadLine
@@ -16,6 +16,7 @@ PowerShell console.
 There have been many updates to PSReadLine since the version that ships in
 Windows PowerShell 5.1.
 
+- v2.3.6 first shipped in PowerShell 7.4.7 and 7.5.0
 - v2.3.5 first shipped in PowerShell 7.4.2 and 7.5.0-preview.3
 - v2.3.4 first shipped in PowerShell 7.4.0-rc.1
 - v2.2.6 first shipped in PowerShell 7.3.0