OpenXR SDK 1.0.17 (2021-06-08)release-1.0.17

This release features an important fix to the loader for an
invalid-iterator bug introduced in 1.0.16. All developers shipping the
loader are strongly encouraged to upgrade. It also includes a variety of
new vendor extensions.

-   Registry
    -   Add XR_MSFT_scene_understanding vendor extension. (internal MR
        2032)
    -   Add XR_MSFT_scene_understanding_serialization vendor extension.
        (internal MR 2032)
    -   Add XR_MSFT_composition_layer_reprojection vendor extension.
        (internal MR 2033)
    -   Add XR_OCULUS_audio_device_guid vendor extension. (internal MR
        2053)
    -   Add version 3 of XR_FB_swapchain_update_state vendor extension,
        which splits platform and graphics API specific structs into
        separate extensions. (internal MR 2059)
    -   Apply formatting to registry XML by selectively committing
        changes made by https://github.com/rpavlik/PrettyRegistryXml.
        (internal MR 2070, OpenXR-SDK-Source/#256)
    -   Enforce that all xrCreate functions must be able to return
        XR_ERROR_LIMIT_REACHED and XR_ERROR_OUT_OF_MEMORY, and adjust
        lists of error codes accordingly. (internal MR 2064)
    -   Fix a usage of > without escaping as an XML entity. (internal MR
        2064)
    -   Fix all cases of a success code (most often
        XR_SESSION_LOSS_PENDING) appearing in the errorcodes attribute
        of a command. (internal MR 2064, internal issue 1566)
    -   Improve comments for several enum values. (internal MR 1982)
    -   Perform some script clean-up and refactoring, including
        selective type annotation and moving the Conventions abstract
        base class to spec_tools. (internal MR 2064)
    -   Sort return codes, with some general, popular codes made to be
        early. Script sort_codes.py can be used to maintain this, though
        it mangles other XML formatting, so use it with care.
        https://github.com/rpavlik/PrettyRegistryXml can format, and
        eventually sort return codes (currently sort order does not
        match). (internal MR 2064, OpenXR-SDK-Source/#256)
-   SDK
    -   Loader: Fix iteration over explicit layer manifests.
        (OpenXR-SDK-Source/#256)
    -   validation layer: Don’t try to apply strlen to wchar_t-based
        output buffers. (internal MR 2053)

1 files changed, 51 insertions, 0 deletions

diff --git a/CHANGELOG.SDK.md b/CHANGELOG.SDK.md
index 29914f2..e245a6b 100644
--- a/CHANGELOG.SDK.md
+++ b/CHANGELOG.SDK.md
@@ -19,6 +19,57 @@ along with any public pull requests that have been accepted.
 In this repository in particular, since it is primarily software,
 pull requests may be integrated as they are accepted even between periodic updates.
 
+## OpenXR SDK 1.0.17 (2021-06-08)
+
+This release features an important fix to the loader for an invalid-iterator bug
+introduced in 1.0.16. All developers shipping the loader are strongly encouraged
+to upgrade. It also includes a variety of new vendor extensions.
+
+- Registry
+  - Add `XR_MSFT_scene_understanding` vendor extension.
+    ([internal MR 2032](https://gitlab.khronos.org/openxr/openxr/merge_requests/2032))
+  - Add `XR_MSFT_scene_understanding_serialization` vendor extension.
+    ([internal MR 2032](https://gitlab.khronos.org/openxr/openxr/merge_requests/2032))
+  - Add `XR_MSFT_composition_layer_reprojection` vendor extension.
+    ([internal MR 2033](https://gitlab.khronos.org/openxr/openxr/merge_requests/2033))
+  - Add `XR_OCULUS_audio_device_guid` vendor extension.
+    ([internal MR 2053](https://gitlab.khronos.org/openxr/openxr/merge_requests/2053))
+  - Add version 3 of `XR_FB_swapchain_update_state` vendor extension, which splits
+    platform and graphics API specific structs into separate extensions.
+    ([internal MR 2059](https://gitlab.khronos.org/openxr/openxr/merge_requests/2059))
+  - Apply formatting to registry XML by selectively committing changes made by
+    <https://github.com/rpavlik/PrettyRegistryXml>.
+    ([internal MR 2070](https://gitlab.khronos.org/openxr/openxr/merge_requests/2070),
+    [OpenXR-SDK-Source/#256](https://github.com/KhronosGroup/OpenXR-SDK-Source/pull/256))
+  - Enforce that all `xrCreate` functions must be able to return
+    `XR_ERROR_LIMIT_REACHED` and `XR_ERROR_OUT_OF_MEMORY`, and adjust lists of
+    error codes accordingly.
+    ([internal MR 2064](https://gitlab.khronos.org/openxr/openxr/merge_requests/2064))
+  - Fix a usage of `>` without escaping as an XML entity.
+    ([internal MR 2064](https://gitlab.khronos.org/openxr/openxr/merge_requests/2064))
+  - Fix all cases of a success code (most often `XR_SESSION_LOSS_PENDING`)
+    appearing in the `errorcodes` attribute of a command.
+    ([internal MR 2064](https://gitlab.khronos.org/openxr/openxr/merge_requests/2064),
+    [internal issue 1566](https://gitlab.khronos.org/openxr/openxr/issues/1566))
+  - Improve comments for several enum values.
+    ([internal MR 1982](https://gitlab.khronos.org/openxr/openxr/merge_requests/1982))
+  - Perform some script clean-up and refactoring, including selective type
+    annotation and moving the Conventions abstract base class to `spec_tools`.
+    ([internal MR 2064](https://gitlab.khronos.org/openxr/openxr/merge_requests/2064))
+  - Sort return codes, with some general, popular codes made to be early. Script
+    `sort_codes.py` can be used to maintain this, though it mangles other XML
+    formatting, so use it with care. <https://github.com/rpavlik/PrettyRegistryXml>
+    can format, and eventually sort return codes (currently sort order does not
+    match).
+    ([internal MR 2064](https://gitlab.khronos.org/openxr/openxr/merge_requests/2064),
+    [OpenXR-SDK-Source/#256](https://github.com/KhronosGroup/OpenXR-SDK-Source/pull/256))
+- SDK
+  - Loader: Fix iteration over explicit layer manifests.
+    ([OpenXR-SDK-Source/#256](https://github.com/KhronosGroup/OpenXR-SDK-Source/pull/256))
+  - validation layer: Don't try to apply `strlen` to `wchar_t`-based output
+    buffers.
+    ([internal MR 2053](https://gitlab.khronos.org/openxr/openxr/merge_requests/2053))
+
 ## OpenXR SDK 1.0.16 (2021-05-11)
 
 This release contains an update to define a new error code,