From f2cfe89ddff218c6435e3dfd5f937a014e3f6854 Mon Sep 17 00:00:00 2001
From: Victor Tong <vitong@microsoft.com>
Date: Wed, 19 Apr 2023 19:58:24 -0700
Subject: [PATCH 1/6] Update doc with cl.exe /arm64EC flag

---
 docs/build/reference/compiler-options-listed-alphabetically.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/build/reference/compiler-options-listed-alphabetically.md b/docs/build/reference/compiler-options-listed-alphabetically.md
index 595439b8a7b..0b1f0a9e0e4 100644
--- a/docs/build/reference/compiler-options-listed-alphabetically.md
+++ b/docs/build/reference/compiler-options-listed-alphabetically.md
@@ -17,6 +17,7 @@ This table contains an alphabetical list of compiler options. For a list of comp
 | [`/AI<dir>`](ai-specify-metadata-directories.md) | Specifies a directory to search to resolve file references passed to the [`#using`](../../preprocessor/hash-using-directive-cpp.md) directive. |
 | [`/analyze`](analyze-code-analysis.md) | Enables code analysis. |
 | [`/arch:<IA32|SSE|SSE2|AVX|AVX2|AVX512>`](arch-x86.md) | Minimum CPU architecture requirements. IA32, SSE, and SSE2 are x86 only. |
+| `/arm64EC` | Generate code compatible to the arm64EC ABI. |
 | [`/await`](await-enable-coroutine-support.md) | Enable coroutines (resumable functions) extensions. |
 | [`/await:strict`](await-enable-coroutine-support.md) | Enable standard C++20 coroutine support with earlier language versions. |
 | [`/bigobj`](bigobj-increase-number-of-sections-in-dot-obj-file.md) | Increases the number of addressable sections in an .obj file. |

From 394f6e50873c65484c9a5580ae3e7199f78ac95b Mon Sep 17 00:00:00 2001
From: Tyler Whitney <TylerMSFT@users.noreply.github.com>
Date: Thu, 20 Apr 2023 13:17:41 -0700
Subject: [PATCH 2/6] Update compiler-options-listed-alphabetically.md

grammar fix
---
 docs/build/reference/compiler-options-listed-alphabetically.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/build/reference/compiler-options-listed-alphabetically.md b/docs/build/reference/compiler-options-listed-alphabetically.md
index 0b1f0a9e0e4..beb6bd81e95 100644
--- a/docs/build/reference/compiler-options-listed-alphabetically.md
+++ b/docs/build/reference/compiler-options-listed-alphabetically.md
@@ -17,7 +17,7 @@ This table contains an alphabetical list of compiler options. For a list of comp
 | [`/AI<dir>`](ai-specify-metadata-directories.md) | Specifies a directory to search to resolve file references passed to the [`#using`](../../preprocessor/hash-using-directive-cpp.md) directive. |
 | [`/analyze`](analyze-code-analysis.md) | Enables code analysis. |
 | [`/arch:<IA32|SSE|SSE2|AVX|AVX2|AVX512>`](arch-x86.md) | Minimum CPU architecture requirements. IA32, SSE, and SSE2 are x86 only. |
-| `/arm64EC` | Generate code compatible to the arm64EC ABI. |
+| `/arm64EC` | Generate code compatible with the arm64EC ABI. |
 | [`/await`](await-enable-coroutine-support.md) | Enable coroutines (resumable functions) extensions. |
 | [`/await:strict`](await-enable-coroutine-support.md) | Enable standard C++20 coroutine support with earlier language versions. |
 | [`/bigobj`](bigobj-increase-number-of-sections-in-dot-obj-file.md) | Increases the number of addressable sections in an .obj file. |

From bd434dea66e66fb7d476187f44dd17935b6021b4 Mon Sep 17 00:00:00 2001
From: TylerMSFT <Tyler.Whitney@microsoft.com>
Date: Thu, 20 Apr 2023 15:15:09 -0700
Subject: [PATCH 3/6] fix github #4518

---
 docs/dotnet/queue-stl-clr.md | 281 +++++++++++++++++++----------------
 1 file changed, 155 insertions(+), 126 deletions(-)

diff --git a/docs/dotnet/queue-stl-clr.md b/docs/dotnet/queue-stl-clr.md
index 881b8b19672..057cb4e35ed 100644
--- a/docs/dotnet/queue-stl-clr.md
+++ b/docs/dotnet/queue-stl-clr.md
@@ -1,15 +1,14 @@
 ---
 description: "Learn more about: queue (STL/CLR)"
 title: "queue (STL/CLR)"
-ms.date: "11/04/2016"
+ms.date: "4/20/2023"
 ms.topic: "reference"
 f1_keywords: ["cliext::queue", "cliext::queue::assign", "cliext::queue::back", "cliext::queue::back_item", "cliext::queue::const_reference", "cliext::queue::container_type", "cliext::queue::difference_type", "cliext::queue::empty", "cliext::queue::front", "cliext::queue::front_item", "cliext::queue::generic_container", "cliext::queue::generic_value", "cliext::queue::get_container", "cliext::queue::operator=", "cliext::queue::pop", "cliext::queue::push", "cliext::queue::queue", "cliext::queue::reference", "cliext::queue::size", "cliext::queue::size_type", "cliext::queue::to_array", "cliext::queue::value_type"]
 helpviewer_keywords: ["<queue> header [STL/CLR]", "queue class [STL/CLR]", "<cliext/queue> header [STL/CLR]", "operator!= member [STL/CLR]", "operator< member [STL/CLR]", "operator<= member [STL/CLR]", "operator== member [STL/CLR]", "operator> member [STL/CLR]", "operator>= member [STL/CLR]", "assign member [STL/CLR]", "back member [STL/CLR]", "back_item member [STL/CLR]", "const_reference member [STL/CLR]", "container_type member [STL/CLR]", "difference_type member [STL/CLR]", "empty member [STL/CLR]", "front member [STL/CLR]", "front_item member [STL/CLR]", "generic_container member [STL/CLR]", "generic_value member [STL/CLR]", "get_container member [STL/CLR]", "operator= member [STL/CLR]", "pop member [STL/CLR]", "push member [STL/CLR]", "queue member [STL/CLR]", "reference member [STL/CLR]", "size member [STL/CLR]", "size_type member [STL/CLR]", "to_array member [STL/CLR]", "value_type member [STL/CLR]"]
-ms.assetid: 9ea7dec3-ea98-48ff-87d0-a5afc924aaf2
 ---
 # `queue` (STL/CLR)
 
-The template class describes an object that controls a varying-length sequence of elements that has first-in first-out access. You use the container adapter `queue` to manage an underlying container as a queue.
+The template class describes an object that controls a varying length sequence of elements that has first-in first-out access. Use the container adapter `queue` to manage an underlying container as a queue.
 
 In the description below, `GValue` is the same as *`Value`* unless the latter is a ref type, in which case it's `Value^`. Similarly, `GContainer` is the same as *`Container`* unless the latter is a ref type, in which case it's `Container^`.
 
@@ -35,10 +34,13 @@ The type of the underlying container.
 
 ## Requirements
 
-**Header:** \<cliext/queue>
+**Header:** `<cliext/queue>`
 
 **Namespace:** `cliext`
 
+> [!IMPORTANT]
+> To compile the examples in this topic, ensure that you have installed C++/CLI support as described in [Install C++/CLI support in Visual Studio 2022](dotnet-programming-with-cpp-cli-visual-cpp.md#install-ccli-support-in-visual-studio-2022). For the project type, create a *CLR Console app (.NET Framework)*.
+
 ## Declarations
 
 | Type definition | Description |
@@ -117,29 +119,30 @@ The member function assigns `right.get_container()` to the underlying container.
 ```cpp
 // cliext_queue_assign.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display initial contents " a b c"
+    // display initial contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// assign a repetition of values
+    // assign a repetition of values
     Myqueue c2;
     c2.assign(c1);
     for each (wchar_t elem in c2.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -166,31 +169,32 @@ The member function returns a reference to the last element of the controlled se
 ```cpp
 // cliext_queue_back.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display initial contents " a b c"
+    // display initial contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// inspect last item
+    // inspect last item
     System::Console::WriteLine("back() = {0}", c1.back());
 
-// alter last item and reinspect
+    // alter last item and reinspect
     c1.back() = L'x';
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -218,31 +222,32 @@ The property accesses the last element of the controlled sequence, which must be
 ```cpp
 // cliext_queue_back_item.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display initial contents " a b c"
+    // display initial contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// inspect last item
+    // inspect last item
     System::Console::WriteLine("back_item = {0}", c1.back_item);
 
-// alter last item and reinspect
+    // alter last item and reinspect
     c1.back_item = L'x';
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -270,17 +275,18 @@ The type describes a constant reference to an element.
 ```cpp
 // cliext_queue_const_reference.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for (; !c1.empty(); c1.pop())
         {   // get a const reference to an element
         Myqueue::const_reference cref = c1.front();
@@ -288,7 +294,7 @@ int main()
         }
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -314,23 +320,24 @@ The type is a synonym for the template parameter `Container`.
 ```cpp
 // cliext_queue_container_type.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c" using container_type
+    // display contents "a b c" using container_type
     Myqueue::container_type wc1 = c1.get_container();
     for each (wchar_t elem in wc1)
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -356,29 +363,30 @@ The type describes a possibly negative element count.
 ```cpp
 // cliext_queue_difference_type.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display initial contents " a b c"
+    // display initial contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// compute negative difference
+    // compute negative difference
     Myqueue::difference_type diff = c1.size();
     c1.push(L'd');
     c1.push(L'e');
     diff -= c1.size();
     System::Console::WriteLine("pushing 2 = {0}", diff);
 
-// compute positive difference
+    // compute positive difference
     diff = c1.size();
     c1.pop();
     c1.pop();
@@ -386,7 +394,7 @@ int main()
     diff -= c1.size();
     System::Console::WriteLine("popping 3 = {0}", diff);
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -414,31 +422,32 @@ The member function returns true for an empty controlled sequence. It's equivale
 ```cpp
 // cliext_queue_empty.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display initial contents " a b c"
+    // display initial contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     System::Console::WriteLine("size() = {0}", c1.size());
     System::Console::WriteLine("empty() = {0}", c1.empty());
 
-// clear the container and reinspect
+    // clear the container and reinspect
     c1.pop();
     c1.pop();
     c1.pop();
     System::Console::WriteLine("size() = {0}", c1.size());
     System::Console::WriteLine("empty() = {0}", c1.empty());
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -468,31 +477,32 @@ The member function returns a reference to the first element of the controlled s
 ```cpp
 // cliext_queue_front.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display initial contents " a b c"
+    // display initial contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// inspect first item
+    // inspect first item
     System::Console::WriteLine("front() = {0}", c1.front());
 
-// alter first item and reinspect
+    // alter first item and reinspect
     c1.front() = L'x';
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -520,31 +530,32 @@ The property accesses the first element of the controlled sequence, which must b
 ```cpp
 // cliext_queue_front_item.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display initial contents " a b c"
+    // display initial contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// inspect last item
+    // inspect last item
     System::Console::WriteLine("front_item = {0}", c1.front_item);
 
-// alter last item and reinspect
+    // alter last item and reinspect
     c1.front_item = L'x';
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -573,40 +584,41 @@ The type describes the generic interface for this template container adapter cla
 ```cpp
 // cliext_queue_generic_container.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// construct a generic container
+    // construct a generic container
     Myqueue::generic_container^ gc1 = %c1;
     for each (wchar_t elem in gc1->get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// modify generic and display original
+    // modify generic and display original
     gc1->push(L'd');
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// modify original and display generic
+    // modify original and display generic
     c1.push(L'e');
     for each (wchar_t elem in gc1->get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -635,28 +647,29 @@ The type describes an object of type `GValue` that describes the stored element
 ```cpp
 // cliext_queue_generic_value.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// get interface to container
+    // get interface to container
     Myqueue::generic_container^ gc1 = %c1;
     for each (wchar_t elem in gc1->get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// display in order using generic_value
+    // display in order using generic_value
     for (; !gc1->empty(); gc1->pop())
         {
         Myqueue::generic_value elem = gc1->front();
@@ -665,7 +678,7 @@ int main()
         }
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -693,22 +706,23 @@ The member function returns the underlying container. You use it to bypass the r
 ```cpp
 // cliext_queue_get_container.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display initial contents " a b c"
+    // display initial contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -739,29 +753,30 @@ The member operator copies *`right`* to the object, then returns **`*this`**. Yo
 ```cpp
 // cliext_queue_operator_as.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// assign to a new container
+    // assign to a new container
     Myqueue c2;
     c2 = c1;
     for each (wchar_t elem in c2.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -771,7 +786,7 @@ a b c
 
 ## <a name="pop"></a> `queue::pop`
 
-Removes the last element.
+Removes the first element.
 
 ### Syntax
 
@@ -781,35 +796,36 @@ void pop();
 
 ### Remarks
 
-The member function removes the last element of the controlled sequence, which must be non-empty. You use it to shorten the `queue` by one element at the back.
+Removes the first element of the controlled sequence, which must be non-empty.
 
 ### Example
 
 ```cpp
 // cliext_queue_pop.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// pop an element and redisplay
+    // pop an element and redisplay
     c1.pop();
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -836,22 +852,23 @@ The member function adds an element with value `val` at the end of the queue. Yo
 ```cpp
 // cliext_queue_push.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -910,6 +927,7 @@ uses the existing container *`wrapped`* as the wrapped container. You use it to
 ```cpp
 // cliext_queue_construct.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 #include <cliext/list>
 
@@ -917,31 +935,31 @@ typedef cliext::queue<wchar_t> Myqueue;
 typedef cliext::list<wchar_t> Mylist;
 typedef cliext::queue<wchar_t, Mylist> Myqueue_list;
 int main()
-    {
-// construct an empty container
+{
+    // construct an empty container
     Myqueue c1;
     System::Console::WriteLine("size() = {0}", c1.size());
 
-// construct from an underlying container
+    // construct from an underlying container
     Mylist v2(5, L'x');
     Myqueue_list c2(v2);
     for each (wchar_t elem in c2.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// construct by copying another container
+    // construct by copying another container
     Myqueue_list c3(c2);
     for each (wchar_t elem in c3.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// construct by copying another container through handle
+    // construct by copying another container through handle
     Myqueue_list c4(%c2);
     for each (wchar_t elem in c4.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -970,29 +988,30 @@ The type describes a reference to an element.
 ```cpp
 // cliext_queue_reference.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display initial contents " a b c"
+    // display initial contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// modify back of queue and redisplay
+    // modify back of queue and redisplay
     Myqueue::reference ref = c1.back();
     ref = L'x';
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -1019,32 +1038,33 @@ The member function returns the length of the controlled sequence. You use it to
 ```cpp
 // cliext_queue_size.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display initial contents " a b c"
+    // display initial contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     System::Console::WriteLine("size() = {0} starting with 3", c1.size());
 
-// pop an item and reinspect
+    // pop an item and reinspect
     c1.pop();
     System::Console::WriteLine("size() = {0} after popping", c1.size());
 
-// add two elements and reinspect
+    // add two elements and reinspect
     c1.push(L'a');
     c1.push(L'b');
     System::Console::WriteLine("size() = {0} after adding 2", c1.size());
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -1073,29 +1093,30 @@ The type describes a non-negative element count.
 ```cpp
 // cliext_queue_size_type.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display initial contents " a b c"
+    // display initial contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// compute positive difference
+    // compute positive difference
     Myqueue::size_type diff = c1.size();
     c1.pop();
     c1.pop();
     diff -= c1.size();
     System::Console::WriteLine("size difference = {0}", diff);
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -1122,17 +1143,18 @@ The member function returns an array containing the controlled sequence. You use
 ```cpp
 // cliext_queue_to_array.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// copy the container and modify it
+    // copy the container and modify it
     cli::array<wchar_t>^ a1 = c1.to_array();
 
     c1.push(L'd');
@@ -1140,12 +1162,12 @@ int main()
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// display the earlier array copy
+    // display the earlier array copy
     for each (wchar_t elem in a1)
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -1172,17 +1194,18 @@ The type is a synonym for the template parameter *`Value`*.
 ```cpp
 // cliext_queue_value_type.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display reversed contents " a b c" using value_type
+    // display reversed contents "a b c" using value_type
     for (; !c1.empty(); c1.pop())
         {   // store element in value_type object
         Myqueue::value_type val = c1.front();
@@ -1191,7 +1214,7 @@ int main()
         }
     System::Console::WriteLine();
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -1228,28 +1251,29 @@ The operator function returns `!(left == right)`. You use it to test whether *`l
 ```cpp
 // cliext_queue_operator_ne.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// assign to a new container
+    // assign to a new container
     Myqueue c2;
     c2.push(L'a');
     c2.push(L'b');
     c2.push(L'd');
 
-// display contents " a b d"
+    // display contents "a b d"
     for each (wchar_t elem in c2.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
@@ -1259,7 +1283,7 @@ int main()
     System::Console::WriteLine("[a b c] != [a b d] is {0}",
         c1 != c2);
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -1299,28 +1323,29 @@ The operator function returns true if, for the lowest position `i` for which `!(
 ```cpp
 // cliext_queue_operator_lt.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// assign to a new container
+    // assign to a new container
     Myqueue c2;
     c2.push(L'a');
     c2.push(L'b');
     c2.push(L'd');
 
-// display contents " a b d"
+    // display contents "a b d"
     for each (wchar_t elem in c2.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
@@ -1330,7 +1355,7 @@ int main()
     System::Console::WriteLine("[a b c] < [a b d] is {0}",
         c1 < c2);
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -1370,28 +1395,29 @@ The operator function returns `!(right < left)`. You use it to test whether *`le
 ```cpp
 // cliext_queue_operator_le.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// assign to a new container
+    // assign to a new container
     Myqueue c2;
     c2.push(L'a');
     c2.push(L'b');
     c2.push(L'd');
 
-// display contents " a b d"
+/    / display contents "a b d"
     for each (wchar_t elem in c2.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
@@ -1401,7 +1427,7 @@ int main()
     System::Console::WriteLine("[a b d] <= [a b c] is {0}",
         c2 <= c1);
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -1441,28 +1467,29 @@ The operator function returns true only if the sequences controlled by *`left`*
 ```cpp
 // cliext_queue_operator_eq.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// assign to a new container
+    // assign to a new container
     Myqueue c2;
     c2.push(L'a');
     c2.push(L'b');
     c2.push(L'd');
 
-// display contents " a b d"
+    // display contents "a b d"
     for each (wchar_t elem in c2.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
@@ -1472,7 +1499,7 @@ int main()
     System::Console::WriteLine("[a b c] == [a b d] is {0}",
         c1 == c2);
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -1512,28 +1539,29 @@ The operator function returns `right < left`. You use it to test whether *`left`
 ```cpp
 // cliext_queue_operator_gt.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// assign to a new container
+    // assign to a new container
     Myqueue c2;
     c2.push(L'a');
     c2.push(L'b');
     c2.push(L'd');
 
-// display contents " a b d"
+    // display contents "a b d"
     for each (wchar_t elem in c2.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
@@ -1543,7 +1571,7 @@ int main()
     System::Console::WriteLine("[a b d] > [a b c] is {0}",
         c2 > c1);
     return (0);
-    }
+}
 ```
 
 ```Output
@@ -1583,28 +1611,29 @@ The operator function returns `!(left < right)`. You use it to test whether *`le
 ```cpp
 // cliext_queue_operator_ge.cpp
 // compile with: /clr
+#include "pch.h"
 #include <cliext/queue>
 
 typedef cliext::queue<wchar_t> Myqueue;
 int main()
-    {
+{
     Myqueue c1;
     c1.push(L'a');
     c1.push(L'b');
     c1.push(L'c');
 
-// display contents " a b c"
+    // display contents "a b c"
     for each (wchar_t elem in c1.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
 
-// assign to a new container
+    // assign to a new container
     Myqueue c2;
     c2.push(L'a');
     c2.push(L'b');
     c2.push(L'd');
 
-// display contents " a b d"
+    // display contents "a b d"
     for each (wchar_t elem in c2.get_container())
         System::Console::Write("{0} ", elem);
     System::Console::WriteLine();
@@ -1614,7 +1643,7 @@ int main()
     System::Console::WriteLine("[a b c] >= [a b d] is {0}",
         c1 >= c2);
     return (0);
-    }
+}
 ```
 
 ```Output

From 52803ee84045db44eeb47ac821d89ddc880775aa Mon Sep 17 00:00:00 2001
From: TylerMSFT <Tyler.Whitney@microsoft.com>
Date: Thu, 20 Apr 2023 15:19:22 -0700
Subject: [PATCH 4/6] acrolinx

---
 docs/dotnet/queue-stl-clr.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/dotnet/queue-stl-clr.md b/docs/dotnet/queue-stl-clr.md
index 057cb4e35ed..4bd7aaf67ec 100644
--- a/docs/dotnet/queue-stl-clr.md
+++ b/docs/dotnet/queue-stl-clr.md
@@ -10,7 +10,7 @@ helpviewer_keywords: ["<queue> header [STL/CLR]", "queue class [STL/CLR]", "<cli
 
 The template class describes an object that controls a varying length sequence of elements that has first-in first-out access. Use the container adapter `queue` to manage an underlying container as a queue.
 
-In the description below, `GValue` is the same as *`Value`* unless the latter is a ref type, in which case it's `Value^`. Similarly, `GContainer` is the same as *`Container`* unless the latter is a ref type, in which case it's `Container^`.
+In the following description, `GValue` is the same as *`Value`* unless the latter is a ref type, in which case it's `Value^`. Similarly, `GContainer` is the same as *`Container`* unless the latter is a ref type, in which case it's `Container^`.
 
 ## Syntax
 
@@ -162,7 +162,7 @@ reference back();
 
 ### Remarks
 
-The member function returns a reference to the last element of the controlled sequence, which must be non-empty. You use it to access the last element, when you know one exists.
+The member function returns a reference to the last element of the controlled sequence, which must be nonempty. You use it to access the last element, when you know one exists.
 
 ### Example
 
@@ -215,7 +215,7 @@ property value_type back_item;
 
 ### Remarks
 
-The property accesses the last element of the controlled sequence, which must be non-empty. You use it to read or write the last element, when you know one exists.
+The property accesses the last element of the controlled sequence, which must be nonempty. You use it to read or write the last element, when you know one exists.
 
 ### Example
 
@@ -470,7 +470,7 @@ reference front();
 
 ### Remarks
 
-The member function returns a reference to the first element of the controlled sequence, which must be non-empty. You use it to access the first element, when you know one exists.
+The member function returns a reference to the first element of the controlled sequence, which must be nonempty. You use it to access the first element, when you know one exists.
 
 ### Example
 
@@ -523,7 +523,7 @@ property value_type front_item;
 
 ### Remarks
 
-The property accesses the first element of the controlled sequence, which must be non-empty. You use it to read or write the first element, when you know one exists.
+The property accesses the first element of the controlled sequence, which must be nonempty. You use it to read or write the first element, when you know one exists.
 
 ### Example
 
@@ -796,7 +796,7 @@ void pop();
 
 ### Remarks
 
-Removes the first element of the controlled sequence, which must be non-empty.
+Removes the first element of the controlled sequence, which must be nonempty.
 
 ### Example
 

From 4ec6dc963adf2abb6099972c6ada005e1b05cb6a Mon Sep 17 00:00:00 2001
From: TylerMSFT <Tyler.Whitney@microsoft.com>
Date: Thu, 20 Apr 2023 17:12:15 -0700
Subject: [PATCH 5/6] fix github #4510

---
 .../reference/setlocale-wsetlocale.md             | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/docs/c-runtime-library/reference/setlocale-wsetlocale.md b/docs/c-runtime-library/reference/setlocale-wsetlocale.md
index 8eefaa426f5..fbc91f1e2b3 100644
--- a/docs/c-runtime-library/reference/setlocale-wsetlocale.md
+++ b/docs/c-runtime-library/reference/setlocale-wsetlocale.md
@@ -1,7 +1,7 @@
 ---
 title: "setlocale, _wsetlocale"
 description: "Describes the Microsoft C runtime (CRT) library functions setlocale and _wsetlocale."
-ms.date: 05/05/2022
+ms.date: 4/20/2023
 api_name: ["_wsetlocale", "setlocale", "_o__wsetlocale", "_o_setlocale"]
 api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-locale-l1-1-0.dll"]
 api_type: ["DLLExport"]
@@ -21,6 +21,7 @@ char *setlocale(
    int category,
    const char *locale
 );
+
 wchar_t *_wsetlocale(
    int category,
    const wchar_t *locale
@@ -40,9 +41,17 @@ Locale specifier.
 If a valid *`locale`* and *`category`* are given, the functions return a pointer to the string associated with the specified *`locale`* and *`category`*.
 If the *`locale`*  argument is `NULL`, the functions return the current locale.
 
-If the *`locale`* or *`category`* isn't valid, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, each function sets `errno` to `EINVAL`, and returns `NULL`.
+If an invalid argument is passed to either function, the return value is `NULL`.
+The behavior for invalid arguments is as follows:
+
+|Function | Invalid parameter | Invalid handler invoked as described in [Parameter validation](../parameter-validation.md)| Sets `errno` |
+|---------|---------|---------|
+| `setlocale` | *`category`*  | yes | yes |
+| `setlocale` | *`locale`*  | no | no |
+| `_wsetlocale` | *`category`* | yes | yes |
+| `_wsetlocale` | *`locale`*  | no | no |
 
-The call
+The call:
 
 ```C
 setlocale( LC_ALL, "en-US" );

From 2c6891bba3a03751cfbf16e35b21e2a1510700e3 Mon Sep 17 00:00:00 2001
From: TylerMSFT <Tyler.Whitney@microsoft.com>
Date: Thu, 20 Apr 2023 17:20:00 -0700
Subject: [PATCH 6/6] acrolinx

---
 docs/c-runtime-library/reference/setlocale-wsetlocale.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/c-runtime-library/reference/setlocale-wsetlocale.md b/docs/c-runtime-library/reference/setlocale-wsetlocale.md
index fbc91f1e2b3..382ef7908d4 100644
--- a/docs/c-runtime-library/reference/setlocale-wsetlocale.md
+++ b/docs/c-runtime-library/reference/setlocale-wsetlocale.md
@@ -87,7 +87,7 @@ The *`category`* argument specifies the parts of a program's locale information
 | `LC_COLLATE` | The `strcoll`, `_stricoll`, `wcscoll`, `_wcsicoll`, `strxfrm`, `_strncoll`, `_strnicoll`, `_wcsncoll`, `_wcsnicoll`, and `wcsxfrm` functions. |
 | `LC_CTYPE` | The character-handling functions (except `isdigit`, `isxdigit`, `mbstowcs`, and `mbtowc`, which are unaffected). |
 | `LC_MONETARY` | Monetary-formatting information returned by the `localeconv` function. |
-| `LC_NUMERIC` | Decimal-point character for the formatted output routines (such as `printf`), for the data-conversion routines, and for the non-monetary formatting information returned by `localeconv`. In addition to the decimal-point character, `LC_NUMERIC` sets the thousands separator and the grouping control string returned by [`localeconv`](localeconv.md). |
+| `LC_NUMERIC` | Decimal-point character for the formatted output routines (such as `printf`), for the data-conversion routines, and for the nonmonetary formatting information returned by `localeconv`. In addition to the decimal-point character, `LC_NUMERIC` sets the thousands separator and the grouping control string returned by [`localeconv`](localeconv.md). |
 | `LC_TIME` | The `strftime` and `wcsftime` functions. |
 
 This function validates the category parameter. If the category parameter isn't one of the values given in the previous table, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the function sets `errno` to `EINVAL` and returns `NULL`.
@@ -182,7 +182,7 @@ The function [`_configthreadlocale`](configthreadlocale.md) is used to control w
 
 ## UTF-8 support
 
-Starting in Windows 10 version 1803 (10.0.17134.0), the Universal C Runtime supports using a UTF-8 code page. The change means that `char` strings passed to C runtime functions can expect strings in the UTF-8 encoding. To enable UTF-8 mode, use `".UTF8"` as the code page when using **`setlocale`**. For example, `setlocale(LC_ALL, ".UTF8")` will use the current default Windows ANSI code page (ACP) for the locale and UTF-8 for the code page.
+Starting in Windows 10 version 1803 (10.0.17134.0), the Universal C Runtime supports using a UTF-8 code page. The change means that `char` strings passed to C runtime functions can expect strings in the UTF-8 encoding. To enable UTF-8 mode, use `".UTF8"` as the code page when using **`setlocale`**. For example, `setlocale(LC_ALL, ".UTF8")` uses the current default Windows ANSI code page (ACP) for the locale and UTF-8 for the code page.
 
 The string to specify UTF-8 mode is:
 
@@ -201,7 +201,7 @@ The following examples show how to specify the UTF-8 string:
 
 After calling `setlocale(LC_ALL, ".UTF8")`, you may pass "😊" to `mbtowcs` and it will be properly translated to a `wchar_t` string. Previously, there wasn't a locale setting available to do this translation.
 
-UTF-8 mode is also enabled for functions that have historically translated `char` strings using the default Windows ANSI code page (ACP). For example, calling [`_mkdir("😊")`](../reference/mkdir-wmkdir.md) while using a UTF-8 code page will correctly produce a directory with that emoji as the folder name, instead of requiring the ACP to be changed to UTF-8 before running your program. Likewise, calling [`_getcwd()`](../reference/getcwd-wgetcwd.md) in that folder will return a UTF-8 encoded string. For compatibility, the ACP is still used if the C locale code page isn't set to UTF-8.
+UTF-8 mode is also enabled for functions that have historically translated `char` strings using the default Windows ANSI code page (ACP). For example, calling [`_mkdir("😊")`](../reference/mkdir-wmkdir.md) while using a UTF-8 code page will correctly produce a directory with that emoji as the folder name, instead of requiring the ACP to be changed to UTF-8 before running your program. Likewise, calling [`_getcwd()`](../reference/getcwd-wgetcwd.md) in that folder returns a UTF-8 encoded string. For compatibility, the ACP is still used if the C locale code page isn't set to UTF-8.
 
 The following aspects of the C Runtime can't use UTF-8 because they're set during program startup and must use the default Windows ANSI code page (ACP): [`__argv`](../argc-argv-wargv.md), [`_acmdln`](../acmdln-tcmdln-wcmdln.md), and [`_pgmptr`](../pgmptr-wpgmptr.md).