Skip to content

Commit cdbc388

Browse files
committed
Add disclaimer to Language Specification pages
1 parent 04f9d45 commit cdbc388

File tree

17 files changed

+63
-22
lines changed

17 files changed

+63
-22
lines changed

reference/docs-conceptual/lang-spec/chapter-01.md

Lines changed: 2 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,11 @@
11
---
22
description: This Language Specification describe the syntax, semantics, and behavior of the PowerShell language.
3-
ms.date: 05/19/2021
3+
ms.date: 01/08/2025
44
title: Windows PowerShell Language Specification 3.0
55
---
66
# Windows PowerShell Language Specification 3.0
77

8-
The _Windows PowerShell Language Specification 3.0_ was published in December 2012 and is based on
9-
PowerShell 3.0. The specification document is available as a Microsoft Word document from the
10-
Microsoft Download Center at:
11-
[https://www.microsoft.com/download/details.aspx?id=36389](https://www.microsoft.com/download/details.aspx?id=36389)
12-
13-
That Word document has been converted for presentation here on Microsoft Learn. During conversion,
14-
some editorial changes have been made to accommodate formatting for the Docs platform. Some typos
15-
and minor errors have been corrected.
16-
17-
> [!IMPORTANT]
18-
> The contents of this documentation may not reflect the current state of PowerShell in its current
19-
> version. There is no plan to update this documentation to reflect the current state. This
20-
> documentation is presented here for historical reference.
8+
[!INCLUDE [Disclaimer](../../includes/language-spec.md)]
219

2210
## 1. Introduction
2311

reference/docs-conceptual/lang-spec/chapter-02.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ title: Lexical structure
55
---
66
# 2. Lexical Structure
77

8+
[!INCLUDE [Disclaimer](../../includes/language-spec.md)]
9+
810
## 2.1 Grammars
911

1012
This specification shows the syntax of the PowerShell language using two grammars. The _lexical

reference/docs-conceptual/lang-spec/chapter-03.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ title: Basic concepts
55
---
66
# 3. Basic concepts
77

8+
[!INCLUDE [Disclaimer](../../includes/language-spec.md)]
9+
810
## 3.1 Providers and drives
911

1012
A *provider* allows access to data and components that would not otherwise be easily accessible at

reference/docs-conceptual/lang-spec/chapter-04.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,16 @@ title: Types
55
---
66
# 4. Types
77

8-
In PowerShell, each value has a type, and types fall into one of two main categories: **value types**
9-
and **reference types**. Consider the type `int`, which is typical of value types. A value of type
10-
`int` is completely self-contained; all the bits needed to represent that value are stored in that
11-
value, and every bit pattern in that value represents a valid value for its type. Now, consider the
12-
array type `int[]`, which is typical of reference types. A so-called value of an array type can hold
13-
either a reference to an object that actually contains the array elements, or the **null reference**
14-
whose value is `$null`. The important distinction between the two type categories is best
15-
demonstrated by the differences in their semantics during assignment. For example,
8+
[!INCLUDE [Disclaimer](../../includes/language-spec.md)]
9+
10+
In PowerShell, each value has a type, and types fall into one of two main categories: **value
11+
types** and **reference types**. Consider the type `int`, which is typical of value types. A value
12+
of type `int` is completely self-contained; all the bits needed to represent that value are stored
13+
in that value, and every bit pattern in that value represents a valid value for its type. Now,
14+
consider the array type `int[]`, which is typical of reference types. A so-called value of an array
15+
type can hold either a reference to an object that actually contains the array elements, or the
16+
**null reference** whose value is `$null`. The important distinction between the two type categories
17+
is best demonstrated by the differences in their semantics during assignment. For example,
1618

1719
```powershell
1820
$i = 100 # $i designates an int value 100

reference/docs-conceptual/lang-spec/chapter-05.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ title: Variables
55
---
66
# 5. Variables
77

8+
[!INCLUDE [Disclaimer](../../includes/language-spec.md)]
9+
810
A variable represents a storage location for a value, and that value has a type. Traditional
911
procedural programming languages are statically typed; that is, the runtime type of a variable is
1012
that with which it was declared at compile time. Object-oriented languages add the idea of

reference/docs-conceptual/lang-spec/chapter-06.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ title: Conversions
55
---
66
# 6. Conversions
77

8+
[!INCLUDE [Disclaimer](../../includes/language-spec.md)]
9+
810
A *type conversion* is performed when a value of one type is used in a context that requires a
911
different type. If such a conversion happens automatically it is known as *implicit conversion*. (A
1012
common example of this is with some operators that need to convert one or more of the values

reference/docs-conceptual/lang-spec/chapter-07.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ title: Expressions
55
---
66
# 7. Expressions
77

8+
[!INCLUDE [Disclaimer](../../includes/language-spec.md)]
9+
810
Syntax:
911

1012
```Syntax

reference/docs-conceptual/lang-spec/chapter-08.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ title: Statements
55
---
66
# 8. Statements
77

8+
[!INCLUDE [Disclaimer](../../includes/language-spec.md)]
9+
810
## 8.1 Statement blocks and lists
911

1012
Syntax:

reference/docs-conceptual/lang-spec/chapter-09.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ title: Arrays
55
---
66
# 9. Arrays
77

8+
[!INCLUDE [Disclaimer](../../includes/language-spec.md)]
9+
810
## 9.1 Introduction
911

1012
PowerShell supports arrays of one or more dimensions with each dimension having zero or more

reference/docs-conceptual/lang-spec/chapter-10.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ title: Hashtables
55
---
66
# 10. Hashtables
77

8+
[!INCLUDE [Disclaimer](../../includes/language-spec.md)]
9+
810
Syntax:
911

1012
> [!TIP]

0 commit comments

Comments
 (0)