Skip to content

vsprintf articles update #5230

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
Apr 11, 2025
Merged

Conversation

nikita-leontiev
Copy link
Contributor

@nikita-leontiev nikita-leontiev commented Mar 8, 2025

  1. cd68e32
    vswprintf and _vswprintf_l functions return characters count that would be written to buffer when buffer=NULL and count=0. If only count is zero, then memory corruption occurs. "Return value" section updated.
  2. 15f1aa3
    If buffer=NULL and count=0, functions return characters count that would be written to buffer. If buffer is valid and count/sizeInBytes is zero, then memory corruption occurs. "Return value"/"Remarks" sections updated.
  3. 5fa9b33
    Functions return characters count that would be written to buffer when buffer=NULL and count=0. If count is zero, functions return -1. "Behavior summary" section updated.
  4. 38e139c
    If buffer is valid, sizeOfBuffer is not zero and count=0, functions return -1. "Behavior summary" section updated.

Functions behavior was checked on Windows 7 SP1 x64 with Microsoft Visual C++ 2008.

Copy link
Contributor

Learn Build status updates of commit 38e139c:

✅ Validation status: passed

File Status Preview URL Details
docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md ✅Succeeded
docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md ✅Succeeded

For more details, please refer to the build report.

For any questions, please:

@nikita-leontiev
Copy link
Contributor Author

@microsoft-github-policy-service agree

Copy link
Contributor

@nikita-leontiev : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@prmerger-automator prmerger-automator bot requested a review from TylerMSFT March 8, 2025 06:38
Copy link
Contributor

@nikita-leontiev : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@Court72
Copy link
Contributor

Court72 commented Mar 10, 2025

@TylerMSFT

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator bot added the aq-pr-triaged Tracking label for the PR review team label Mar 10, 2025
@TylerMSFT
Copy link
Collaborator

Thank you for this. I have several things in my queue at the moment but have marked this to come back to as soon as I'm able.

The behavior is slightly different than stated.
Copy link
Contributor

Learn Build status updates of commit e1f66f4:

✅ Validation status: passed

File Status Preview URL Details
docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md ✅Succeeded
docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md ✅Succeeded

For more details, please refer to the build report.

For any questions, please:

behave is different than written here.
Copy link
Contributor

Learn Build status updates of commit 5d4cf4e:

✅ Validation status: passed

File Status Preview URL Details
docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md ✅Succeeded
docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md ✅Succeeded

For more details, please refer to the build report.

For any questions, please:

behavior is a little different for count = 0 case.
Copy link
Contributor

Learn Build status updates of commit 3f711f8:

✅ Validation status: passed

File Status Preview URL Details
docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md ✅Succeeded
docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md ✅Succeeded

For more details, please refer to the build report.

For any questions, please:

@TylerMSFT
Copy link
Collaborator

TylerMSFT commented Apr 10, 2025

Hi @nikita-leontiev, thank you for these updates.

I don't see the corruption issue you refer to and made updates to this PR accordingly. I tested on VS 2022 17.14 and Windows 11.

I did see where vsnprintf_s() we write a fill string to the buffer in Debug builds, and that's by design. I added an update for that in #5868.

The behavior in debug mode applies to all functions on this page, so made more prominent.
Copy link
Contributor

Learn Build status updates of commit 450eefa:

✅ Validation status: passed

File Status Preview URL Details
docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md ✅Succeeded
docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md ✅Succeeded

For more details, please refer to the build report.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit 7fa3ce7:

✅ Validation status: passed

File Status Preview URL Details
docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md ✅Succeeded
docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md ✅Succeeded

For more details, please refer to the build report.

For any questions, please:

Copy link
Contributor

Learn Build status updates of commit f6d27df:

✅ Validation status: passed

File Status Preview URL Details
docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md ✅Succeeded
docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md ✅Succeeded

For more details, please refer to the build report.

For any questions, please:

@TylerMSFT
Copy link
Collaborator

#sign-off

Copy link
Collaborator

@TylerMSFT TylerMSFT left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It took awhile to get to this. Thank you for your patience.

Copy link
Contributor

Learn Build status updates of commit 51b55d6:

✅ Validation status: passed

File Status Preview URL Details
docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md ✅Succeeded
docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md ✅Succeeded
docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md ✅Succeeded

For more details, please refer to the build report.

For any questions, please:

@TylerMSFT
Copy link
Collaborator

#sign-off

@Court72 Court72 merged commit 5af3f88 into MicrosoftDocs:main Apr 11, 2025
2 checks passed
learn-build-service-prod bot added a commit that referenced this pull request Apr 14, 2025
* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
learn-build-service-prod bot added a commit that referenced this pull request Apr 15, 2025
* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
learn-build-service-prod bot added a commit that referenced this pull request Apr 16, 2025
* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5874)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

* 4/14/2025 AM Publish (#5871)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Fix typo

VSCode -> VS Code

* Fix wrong image file name in get-started-linux-cmake.md

Fix the image file name for cmake-bullet3-linux-callstack.png for the call stack.

* 4/15/2025 AM Publish (#5873)

* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Diana Richards <[email protected]>

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Diana Richards <[email protected]>
learn-build-service-prod bot added a commit that referenced this pull request Apr 17, 2025
* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5874)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

* 4/14/2025 AM Publish (#5871)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Fix typo

VSCode -> VS Code

* Fix wrong image file name in get-started-linux-cmake.md

Fix the image file name for cmake-bullet3-linux-callstack.png for the call stack.

* 4/15/2025 AM Publish (#5873)

* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Diana Richards <[email protected]>

* add customer requested info about #pragma

* wordsmith

* fix broken link

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5877)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

* 4/14/2025 AM Publish (#5871)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Fix typo

VSCode -> VS Code

* Fix wrong image file name in get-started-linux-cmake.md

Fix the image file name for cmake-bullet3-linux-callstack.png for the call stack.

* 4/15/2025 AM Publish (#5873)

* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>

* 4/16/2025 AM Publish (#5876)

* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5874)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

* 4/14/2025 AM Publish (#5871)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Fix typo

VSCode -> VS Code

* Fix wrong image file name in get-started-linux-cmake.md

Fix the image file name for cmake-bullet3-linux-callstack.png for the call stack.

* 4/15/2025 AM Publish (#5873)

* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Diana Richards <[email protected]>

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Diana Richards <[email protected]>

* cl.exe CLI clarify default for space being allowed between option and arg

* wordsmith per MS style

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Diana Richards <[email protected]>
Co-authored-by: Mitch Capper <[email protected]>

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Diana Richards <[email protected]>
Co-authored-by: Mitch Capper <[email protected]>
learn-build-service-prod bot added a commit that referenced this pull request Apr 18, 2025
* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5874)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

* 4/14/2025 AM Publish (#5871)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Fix typo

VSCode -> VS Code

* Fix wrong image file name in get-started-linux-cmake.md

Fix the image file name for cmake-bullet3-linux-callstack.png for the call stack.

* 4/15/2025 AM Publish (#5873)

* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Diana Richards <[email protected]>

* add customer requested info about #pragma

* wordsmith

* fix broken link

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5877)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

* 4/14/2025 AM Publish (#5871)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Fix typo

VSCode -> VS Code

* Fix wrong image file name in get-started-linux-cmake.md

Fix the image file name for cmake-bullet3-linux-callstack.png for the call stack.

* 4/15/2025 AM Publish (#5873)

* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>

* 4/16/2025 AM Publish (#5876)

* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5874)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

* 4/14/2025 AM Publish (#5871)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Fix typo

VSCode -> VS Code

* Fix wrong image file name in get-started-linux-cmake.md

Fix the image file name for cmake-bullet3-linux-callstack.png for the call stack.

* 4/15/2025 AM Publish (#5873)

* docs for justification in pragma warning

* docs for gsl::suppress

* teach gsl::suppress("rule") instead of gsl::suppress(rule)

* doc - portion of flag

* acrolinx

* related to #5230 - call out buffer fill behavior

* edit

* acrolinx/link fix

* Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#5870)

* vswprintf/_vswprintf_l return value description update.

* Return value/Remarks sections update.

* Behavior summary update.

* Behavior summary update.

* Merge pull request #5867 from MicrosoftDocs/main

4/10/2025 AM Publish

* Update behavior description for `buffer` and `count` conditions

The behavior is slightly different than stated.

* Update return value behavior for valid buffer

behave is different than written here.

* Clarify vswprintf return values for count zero

behavior is a little different for count = 0 case.

* Update remarks and behavior summary sections

The behavior in debug mode applies to all functions on this page, so made more prominent.

* Fix NULL character formatting in documentation

* 4/11/2025 AM Publish (#5869)

* doc - portion of flag

* acrolinx

---------

Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>

* Clarify vswprintf behavior when count is zero

* Standardize 'null' to 'NULL'

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>

* Add Arm64 forceInterlockedFunctions option (#5822)

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update force-interlocked-functions.md

* Learn Editor: Update force-interlocked-functions.md

* update Metadata

* Update force-interlocked-functions.md with github id author name

* Reorder compiler options in toc.yml to be alphabetical

* Learn Editor: Update compiler-options-listed-alphabetically.md

* Learn Editor: Update compiler-options-listed-by-category.md

* Learn Editor: Update force-interlocked-functions.md

* change article metadata

* Learn Editor: Update force-interlocked-functions.md

* Fix casing in toc.yml for forceInterlockedFunctions

* Add 'items' section to toc.yml to revert previous change

* Fix indentation in toc.yml file

* Update metadata and improve documentation wording

* Update metadata in force-interlocked-functions.md

tidied up metdata

* Fix typos and improve clarity in documentation

* Update description for `/forceInterlockedFunctions` option

* Clarify CPU capability/ runtime description in documentation

* Update remark on Armv8.0 instructions

* Remove unneeded template comments and update livelock remarks in documentation

* Add "---" to metadata

---------

Co-authored-by: Tyler Whitney <[email protected]>

* address feedback

* small edits

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Diana Richards <[email protected]>

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Diana Richards <[email protected]>

* cl.exe CLI clarify default for space being allowed between option and arg

* wordsmith per MS style

---------

Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Bo wen Yang <[email protected]>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Tyler Whitney <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Diana Richards <[email protected]>
Co-authored-by: Mitch Capper <[email protected]>

---------

Co-authored-by: Carson Radtke <[email protected]>
Co-authored-by: TylerMSFT <[email protected]>
Co-authored-by: Jill Grant <[email protected]>
Co-authored-by: prmerger-automator[bot] <40007230+prmerger-automator[bot]@users.noreply.github.com>
Co-authored-by: learn-build-service-prod[bot] <113403604+learn-build-service-prod[bot]@users.noreply.github.com>
Co-authored-by: Nikita Leontiev <[email protected]>
Co-authored-by: Learn Build Service GitHub App <Learn Build Service [email protected]>
Co-authored-by: Courtney Wales <[email protected]>
Co-authored-by: Emily Bao <[email protected]>
Co-authored-by: Stacy Chambers <[email protected]>
Co-authored-by: Takashi Takebayashi <[email protected]>
Co-authored-by: liginity <[email protected]>
Co-authored-by: Diana Richards <[email protected]>
Co-authored-by: Mitch Capper <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants