Restructure about_Logical_Operators

This shifts about some of the existing content and adds a new header
for Syntax. It also adds link references and makes minor formatting
changes.

Author: surfingoldelephant

reference/5.1/Microsoft.PowerShell.Core/About/about_Logical_Operators.md

@@ -1,7 +1,7 @@
 ---
 description: Describes the operators that connect statements in PowerShell.
 Locale: en-US
-ms.date: 08/29/2022
+ms.date: 12/30/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_logical_operators?view=powershell-5.1&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_Logical_Operators
@@ -17,10 +17,30 @@ Describes the operators that connect statements in PowerShell.
 The PowerShell logical operators connect expressions and statements, allowing
 you to use a single expression to test for multiple conditions.
 
-For example, the following statement uses the and operator and the or operator
-to connect three conditional statements. The statement is true only when the
-value of $a is greater than the value of $b, and either $a or $b is less than
-20.
+Statements that use the logical operators return boolean (TRUE or FALSE)
+values.
+
+The PowerShell logical operators evaluate only the statements required to
+determine the truth value of the statement. If the left operand in a statement
+that contains the `-and` operator is FALSE, the right operand isn't evaluated.
+If the left operand in a statement that contains the `-or` statement is TRUE,
+the right operand isn't evaluated. As a result, you can use these statements in
+the same way that you would use the `if` statement.
+
+## Syntax
+
+The syntax of the logical operators is as follows:
+
+```Syntax
+<statement> {-and | -or | -xor} <statement>
+{! | -not} <statement>
+```
+
+## Examples
+
+The following example uses the `-and` and `-or` operators to connect three
+conditional statements. The result is TRUE only when the value of `$a` is
+greater than the value of `$b`, and either `$a` or `$b` is less than `20`.
 
 ```powershell
 ($a -gt $b) -and (($a -lt 20) -or ($b -lt 20))
@@ -46,38 +66,29 @@ PowerShell supports the following logical operators.
   (1 -eq 1) -xor (2 -eq 2)   # Result is False
   ```
 
-- Logical not (`-not`) or (`!`) - Negates the statement that follows.
+- Logical NOT (`-not`) or (`!`) - Negates the statement that follows.
 
   ```powershell
   -not (1 -eq 1)             # Result is False
   !(1 -eq 1)                 # Result is False
   ```
 
-The previous examples also use the equal to comparison operator `-eq`. For more
-information, see [about_Comparison_Operators](about_Comparison_Operators.md).
-The examples also use the Boolean values of integers. The integer 0 has a value
-of FALSE. All other integers have a value of TRUE.
-
-The syntax of the logical operators is as follows:
-
-```Syntax
-<statement> {-and | -or | -xor} <statement>
-{! | -not} <statement>
-```
-
-Statements that use the logical operators return Boolean (TRUE or FALSE)
-values.
-
-The PowerShell logical operators evaluate only the statements required to
-determine the truth value of the statement. If the left operand in a statement
-that contains the and operator is FALSE, the right operand isn't evaluated. If
-the left operand in a statement that contains the or statement is TRUE, the
-right operand isn't evaluated. As a result, you can use these statements in
-the same way that you would use the `if` statement.
+The previous examples also use the equality comparison operator, `-eq`. For
+more information, see [about_Comparison_Operators][03]. The examples also use
+the boolean values of integers. The integer `0` has a boolean value of FALSE.
+All other integers have a value of TRUE.
 
 ## See also
 
-- [about_Operators](about_Operators.md)
-- [about_Comparison_operators](about_Comparison_Operators.md)
-- [about_If](about_If.md)
-- [Compare-Object](xref:Microsoft.PowerShell.Utility.Compare-Object)
+- [about_Operators][02]
+- [about_Operator_Precedence][01]
+- [about_Comparison_Operators][03]
+- [about_If][04]
+- [Compare-Object][05]
+
+<!-- link references -->
+[01]: about_Operator_Precedence.md
+[02]: about_Operators.md
+[03]: about_Comparison_Operators.md
+[04]: about_If.md
+[05]: xref:Microsoft.PowerShell.Utility.Compare-Object

reference/7.4/Microsoft.PowerShell.Core/About/about_Logical_Operators.md

@@ -1,7 +1,7 @@
 ---
 description: Describes the operators that connect statements in PowerShell.
 Locale: en-US
-ms.date: 08/29/2022
+ms.date: 12/30/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_logical_operators?view=powershell-7.4&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_Logical_Operators
@@ -17,10 +17,30 @@ Describes the operators that connect statements in PowerShell.
 The PowerShell logical operators connect expressions and statements, allowing
 you to use a single expression to test for multiple conditions.
 
-For example, the following statement uses the and operator and the or operator
-to connect three conditional statements. The statement is true only when the
-value of $a is greater than the value of $b, and either $a or $b is less than
-20.
+Statements that use the logical operators return boolean (TRUE or FALSE)
+values.
+
+The PowerShell logical operators evaluate only the statements required to
+determine the truth value of the statement. If the left operand in a statement
+that contains the `-and` operator is FALSE, the right operand isn't evaluated.
+If the left operand in a statement that contains the `-or` statement is TRUE,
+the right operand isn't evaluated. As a result, you can use these statements in
+the same way that you would use the `if` statement.
+
+## Syntax
+
+The syntax of the logical operators is as follows:
+
+```Syntax
+<statement> {-and | -or | -xor} <statement>
+{! | -not} <statement>
+```
+
+## Examples
+
+The following example uses the `-and` and `-or` operators to connect three
+conditional statements. The result is TRUE only when the value of `$a` is
+greater than the value of `$b`, and either `$a` or `$b` is less than `20`.
 
 ```powershell
 ($a -gt $b) -and (($a -lt 20) -or ($b -lt 20))
@@ -46,38 +66,29 @@ PowerShell supports the following logical operators.
   (1 -eq 1) -xor (2 -eq 2)   # Result is False
   ```
 
-- Logical not (`-not`) or (`!`) - Negates the statement that follows.
+- Logical NOT (`-not`) or (`!`) - Negates the statement that follows.
 
   ```powershell
   -not (1 -eq 1)             # Result is False
   !(1 -eq 1)                 # Result is False
   ```
 
-The previous examples also use the equal to comparison operator `-eq`. For more
-information, see [about_Comparison_Operators](about_Comparison_Operators.md).
-The examples also use the Boolean values of integers. The integer 0 has a value
-of FALSE. All other integers have a value of TRUE.
-
-The syntax of the logical operators is as follows:
-
-```Syntax
-<statement> {-and | -or | -xor} <statement>
-{! | -not} <statement>
-```
-
-Statements that use the logical operators return Boolean (TRUE or FALSE)
-values.
-
-The PowerShell logical operators evaluate only the statements required to
-determine the truth value of the statement. If the left operand in a statement
-that contains the and operator is FALSE, the right operand isn't evaluated. If
-the left operand in a statement that contains the or statement is TRUE, the
-right operand isn't evaluated. As a result, you can use these statements in
-the same way that you would use the `if` statement.
+The previous examples also use the equality comparison operator, `-eq`. For
+more information, see [about_Comparison_Operators][03]. The examples also use
+the boolean values of integers. The integer `0` has a boolean value of FALSE.
+All other integers have a value of TRUE.
 
 ## See also
 
-- [about_Operators](about_Operators.md)
-- [about_Comparison_operators](about_Comparison_Operators.md)
-- [about_If](about_If.md)
-- [Compare-Object](xref:Microsoft.PowerShell.Utility.Compare-Object)
+- [about_Operators][02]
+- [about_Operator_Precedence][01]
+- [about_Comparison_Operators][03]
+- [about_If][04]
+- [Compare-Object][05]
+
+<!-- link references -->
+[01]: about_Operator_Precedence.md
+[02]: about_Operators.md
+[03]: about_Comparison_Operators.md
+[04]: about_If.md
+[05]: xref:Microsoft.PowerShell.Utility.Compare-Object

reference/7.5/Microsoft.PowerShell.Core/About/about_Logical_Operators.md

@@ -1,7 +1,7 @@
 ---
 description: Describes the operators that connect statements in PowerShell.
 Locale: en-US
-ms.date: 08/29/2022
+ms.date: 12/30/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_logical_operators?view=powershell-7.5&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_Logical_Operators
@@ -17,10 +17,30 @@ Describes the operators that connect statements in PowerShell.
 The PowerShell logical operators connect expressions and statements, allowing
 you to use a single expression to test for multiple conditions.
 
-For example, the following statement uses the and operator and the or operator
-to connect three conditional statements. The statement is true only when the
-value of $a is greater than the value of $b, and either $a or $b is less than
-20.
+Statements that use the logical operators return boolean (TRUE or FALSE)
+values.
+
+The PowerShell logical operators evaluate only the statements required to
+determine the truth value of the statement. If the left operand in a statement
+that contains the `-and` operator is FALSE, the right operand isn't evaluated.
+If the left operand in a statement that contains the `-or` statement is TRUE,
+the right operand isn't evaluated. As a result, you can use these statements in
+the same way that you would use the `if` statement.
+
+## Syntax
+
+The syntax of the logical operators is as follows:
+
+```Syntax
+<statement> {-and | -or | -xor} <statement>
+{! | -not} <statement>
+```
+
+## Examples
+
+The following example uses the `-and` and `-or` operators to connect three
+conditional statements. The result is TRUE only when the value of `$a` is
+greater than the value of `$b`, and either `$a` or `$b` is less than `20`.
 
 ```powershell
 ($a -gt $b) -and (($a -lt 20) -or ($b -lt 20))
@@ -46,38 +66,29 @@ PowerShell supports the following logical operators.
   (1 -eq 1) -xor (2 -eq 2)   # Result is False
   ```
 
-- Logical not (`-not`) or (`!`) - Negates the statement that follows.
+- Logical NOT (`-not`) or (`!`) - Negates the statement that follows.
 
   ```powershell
   -not (1 -eq 1)             # Result is False
   !(1 -eq 1)                 # Result is False
   ```
 
-The previous examples also use the equal to comparison operator `-eq`. For more
-information, see [about_Comparison_Operators](about_Comparison_Operators.md).
-The examples also use the Boolean values of integers. The integer 0 has a value
-of FALSE. All other integers have a value of TRUE.
-
-The syntax of the logical operators is as follows:
-
-```Syntax
-<statement> {-and | -or | -xor} <statement>
-{! | -not} <statement>
-```
-
-Statements that use the logical operators return Boolean (TRUE or FALSE)
-values.
-
-The PowerShell logical operators evaluate only the statements required to
-determine the truth value of the statement. If the left operand in a statement
-that contains the and operator is FALSE, the right operand isn't evaluated. If
-the left operand in a statement that contains the or statement is TRUE, the
-right operand isn't evaluated. As a result, you can use these statements in
-the same way that you would use the `if` statement.
+The previous examples also use the equality comparison operator, `-eq`. For
+more information, see [about_Comparison_Operators][03]. The examples also use
+the boolean values of integers. The integer `0` has a boolean value of FALSE.
+All other integers have a value of TRUE.
 
 ## See also
 
-- [about_Operators](about_Operators.md)
-- [about_Comparison_operators](about_Comparison_Operators.md)
-- [about_If](about_If.md)
-- [Compare-Object](xref:Microsoft.PowerShell.Utility.Compare-Object)
+- [about_Operators][02]
+- [about_Operator_Precedence][01]
+- [about_Comparison_Operators][03]
+- [about_If][04]
+- [Compare-Object][05]
+
+<!-- link references -->
+[01]: about_Operator_Precedence.md
+[02]: about_Operators.md
+[03]: about_Comparison_Operators.md
+[04]: about_If.md
+[05]: xref:Microsoft.PowerShell.Utility.Compare-Object

reference/7.6/Microsoft.PowerShell.Core/About/about_Logical_Operators.md

@@ -1,7 +1,7 @@
 ---
 description: Describes the operators that connect statements in PowerShell.
 Locale: en-US
-ms.date: 08/29/2022
+ms.date: 12/30/2025
 online version: https://learn.microsoft.com/powershell/module/microsoft.powershell.core/about/about_logical_operators?view=powershell-7.6&WT.mc_id=ps-gethelp
 schema: 2.0.0
 title: about_Logical_Operators
@@ -17,10 +17,30 @@ Describes the operators that connect statements in PowerShell.
 The PowerShell logical operators connect expressions and statements, allowing
 you to use a single expression to test for multiple conditions.
 
-For example, the following statement uses the and operator and the or operator
-to connect three conditional statements. The statement is true only when the
-value of $a is greater than the value of $b, and either $a or $b is less than
-20.
+Statements that use the logical operators return boolean (TRUE or FALSE)
+values.
+
+The PowerShell logical operators evaluate only the statements required to
+determine the truth value of the statement. If the left operand in a statement
+that contains the `-and` operator is FALSE, the right operand isn't evaluated.
+If the left operand in a statement that contains the `-or` statement is TRUE,
+the right operand isn't evaluated. As a result, you can use these statements in
+the same way that you would use the `if` statement.
+
+## Syntax
+
+The syntax of the logical operators is as follows:
+
+```Syntax
+<statement> {-and | -or | -xor} <statement>
+{! | -not} <statement>
+```
+
+## Examples
+
+The following example uses the `-and` and `-or` operators to connect three
+conditional statements. The result is TRUE only when the value of `$a` is
+greater than the value of `$b`, and either `$a` or `$b` is less than `20`.
 
 ```powershell
 ($a -gt $b) -and (($a -lt 20) -or ($b -lt 20))
@@ -46,38 +66,29 @@ PowerShell supports the following logical operators.
   (1 -eq 1) -xor (2 -eq 2)   # Result is False
   ```
 
-- Logical not (`-not`) or (`!`) - Negates the statement that follows.
+- Logical NOT (`-not`) or (`!`) - Negates the statement that follows.
 
   ```powershell
   -not (1 -eq 1)             # Result is False
   !(1 -eq 1)                 # Result is False
   ```
 
-The previous examples also use the equal to comparison operator `-eq`. For more
-information, see [about_Comparison_Operators](about_Comparison_Operators.md).
-The examples also use the Boolean values of integers. The integer 0 has a value
-of FALSE. All other integers have a value of TRUE.
-
-The syntax of the logical operators is as follows:
-
-```Syntax
-<statement> {-and | -or | -xor} <statement>
-{! | -not} <statement>
-```
-
-Statements that use the logical operators return Boolean (TRUE or FALSE)
-values.
-
-The PowerShell logical operators evaluate only the statements required to
-determine the truth value of the statement. If the left operand in a statement
-that contains the and operator is FALSE, the right operand isn't evaluated. If
-the left operand in a statement that contains the or statement is TRUE, the
-right operand isn't evaluated. As a result, you can use these statements in
-the same way that you would use the `if` statement.
+The previous examples also use the equality comparison operator, `-eq`. For
+more information, see [about_Comparison_Operators][03]. The examples also use
+the boolean values of integers. The integer `0` has a boolean value of FALSE.
+All other integers have a value of TRUE.
 
 ## See also
 
-- [about_Operators](about_Operators.md)
-- [about_Comparison_operators](about_Comparison_Operators.md)
-- [about_If](about_If.md)
-- [Compare-Object](xref:Microsoft.PowerShell.Utility.Compare-Object)
+- [about_Operators][02]
+- [about_Operator_Precedence][01]
+- [about_Comparison_Operators][03]
+- [about_If][04]
+- [Compare-Object][05]
+
+<!-- link references -->
+[01]: about_Operator_Precedence.md
+[02]: about_Operators.md
+[03]: about_Comparison_Operators.md
+[04]: about_If.md
+[05]: xref:Microsoft.PowerShell.Utility.Compare-Object