Merge pull request #5856 from MicrosoftDocs/FromPublicMasterBranch

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

Author: Albertyang0

docs/c-runtime-library/link-options.md

@@ -1,27 +1,26 @@
 ---
-description: "Learn more about: Link Options"
-title: "Link Options"
+title: "Link options"
+description: "Learn more about: Link options"
 ms.date: "11/04/2016"
 helpviewer_keywords: ["nothrownew.obj", "newmode.obj", "noenv.obj", "psetargv.obj", "legacy_stdio_float_rounding.obj", "loosefpmath.obj", "smallheap.obj", "fp10.obj", "nochkclr.obj", "chkstk.obj", "pcommode.obj", "pnoenv.obj", "link options [C++]", "invalidcontinue.obj", "pnothrownew.obj", "pwsetargv.obj", "pinvalidcontinue.obj", "wsetargv.obj", "binmode.obj", "setargv.obj", "noarg.obj", "pnewmode.obj", "commode.obj", "pthreadlocale.obj", "pbinmode.obj", "threadlocale.obj", "pnoarg.obj"]
-ms.assetid: 05b5a77b-9dd1-494b-ae46-314598c770bb
 ---
 # Link options
 
 The CRT lib directory includes several small object files that enable specific CRT features without code changes. These object files are called "link options" because you only have to add them to the linker command line to use them. To do this from Visual Studio, in the Solution Explorer right-click your project and choose **Properties**. Under **Configuration Properties**, choose **Linker** > **Input** > **Additional Dependencies** and specify the additional items to add to the link command line.
 
-CLR pure mode versions of these objects are deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017. Use the regular versions for native and `/clr` code.
+CLR pure mode versions of these objects are deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017. Use the regular versions for native and [`/clr`](../build/reference/clr-common-language-runtime-compilation.md) code.
 
 | Native and /clr | Pure mode | Description |
 |---|---|---|
-| `binmode.obj` | `pbinmode.obj` | Sets the default file-translation mode to binary. See [`_fmode`](./fmode.md). |
+| `binmode.obj` | `pbinmode.obj` | Sets the default file-translation mode to binary. See [`_fmode`](fmode.md). |
 | `chkstk.obj` | n/a | Provides stack-checking and alloca support when not using the CRT. |
-| `commode.obj` | `pcommode.obj` | Sets the global commit flag to "commit". See [`fopen`, `_wfopen`](./reference/fopen-wfopen.md) and [`fopen_s`, `_wfopen_s`](./reference/fopen-s-wfopen-s.md). |
-| exe_initialize_mta.lib | n/a | Initializes the MTA apartment during EXE startup, which allows the use of COM objects in global smart pointers. Because this option leaks an MTA apartment reference during shutdown, don't use it for DLLs. Linking to this file is equivalent to including `combase.h` and defining `_EXE_INITIALIZE_MTA`. Using this link option adds [onecore.lib](/windows/win32/apiindex/windows-umbrella-libraries) to the default library list. If this effect is undesirable (such as using onecore_apiset.lib or other umbrella library), use [/NODEFAULTLIB](../build/reference/nodefaultlib-ignore-libraries.md) to override this behavior and provide an alternative. |
-| `fp10.obj` | n/a | Changes the default precision control to 64 bits. See [Math and floating-point support](./floating-point-support.md). |
+| `commode.obj` | `pcommode.obj` | Sets the global commit flag to "commit". See [`fopen`, `_wfopen`](reference/fopen-wfopen.md) and [`fopen_s`, `_wfopen_s`](reference/fopen-s-wfopen-s.md). |
+| `exe_initialize_mta.lib` | n/a | Initializes the MTA apartment during EXE startup, which allows the use of COM objects in global smart pointers. Because this option leaks an MTA apartment reference during shutdown, don't use it for DLLs. Linking to this file is equivalent to including `combase.h` and defining `_EXE_INITIALIZE_MTA`. Using this link option adds [`onecore.lib`](/windows/win32/apiindex/windows-umbrella-libraries) to the default library list. If this effect is undesirable (such as using onecore_apiset.lib or other umbrella library), use [`/NODEFAULTLIB`](../build/reference/nodefaultlib-ignore-libraries.md) to override this behavior and provide an alternative. |
+| `fp10.obj` | n/a | Changes the default precision control to 64 bits. See [Math and floating-point support](floating-point-support.md). |
 | `invalidcontinue.obj` | `pinvalidcontinue.obj` | Sets a default invalid parameter handler that does nothing, meaning that invalid parameters passed to CRT functions will just set errno and return an error result. |
-| `legacy_stdio_float_rounding.obj` | n/a | The printing of floating-point values (for example, when using [`printf`](./reference/printf-printf-l-wprintf-wprintf-l.md)) with the Windows 10 19041 Universal C Runtime has been fixed. It now properly rounds exactly representable floating-point numbers, and respects the floating-point rounding requested by [`fesetround`](./reference/fegetround-fesetround2.md). This behavior update is available in Visual Studio 2019 version 16.2 and later. Legacy behavior is used in earlier versions of Visual Studio, or by providing this link option. |
+| `legacy_stdio_float_rounding.obj` | n/a | The printing of floating-point values (for example, when using [`printf`](reference/printf-printf-l-wprintf-wprintf-l.md)) with the Windows 10 19041 Universal C Runtime has been fixed. It now properly rounds exactly representable floating-point numbers, and respects the floating-point rounding requested by [`fesetround`](reference/fegetround-fesetround2.md). This behavior update is available in Visual Studio 2019 version 16.2 and later. Legacy behavior is used in earlier versions of Visual Studio, or by providing this link option. |
 | `loosefpmath.obj` | n/a | Ensures that floating point code tolerates denormal values. |
-| `newmode.obj` | `pnewmode.obj` | Causes [`malloc`](./reference/malloc.md) to call the new handler on failure. See [`_set_new_mode`](./reference/set-new-mode.md), [`_set_new_handler`](./reference/set-new-handler.md), [`calloc`](./reference/calloc.md), and [`realloc`](./reference/realloc.md). |
+| `newmode.obj` | `pnewmode.obj` | Causes [`malloc`](reference/malloc.md) to call the new handler on failure. See [`_set_new_mode`](reference/set-new-mode.md), [`_set_new_handler`](reference/set-new-handler.md), [`calloc`](reference/calloc.md), and [`realloc`](reference/realloc.md). |
 | `noarg.obj` | `pnoarg.obj` | Disables all processing of argc and argv. |
 | `nochkclr.obj` | n/a | Does nothing. Remove from your project. |
 | `noenv.obj` | `pnoenv.obj` | Disables the creation of a cached environment for the CRT. |
@@ -32,4 +31,4 @@ CLR pure mode versions of these objects are deprecated in Visual Studio 2015 and
 
 ## See also
 
-- [C runtime (CRT) and C++ Standard Library (STL) `.lib` files](./crt-library-features.md)
+- [C runtime (CRT) and C++ Standard Library (STL) `.lib` files](crt-library-features.md)

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4556.md

@@ -1,36 +1,32 @@
 ---
-description: "Learn more about: Compiler Warning (level 1) C4556"
 title: "Compiler Warning (level 1) C4556"
-ms.date: "08/27/2018"
+description: "Learn more about: Compiler Warning (level 1) C4556"
+ms.date: "03/28/2025"
 f1_keywords: ["C4556"]
 helpviewer_keywords: ["C4556"]
-ms.assetid: e4c0e296-b747-4db1-9608-30b8b74feac2
 ---
 # Compiler Warning (level 1) C4556
 
-> value of intrinsic immediate argument '*value*' is out of range '*lowerbound* - *upperbound*'
+> value of intrinsic immediate argument '*value*' is out of range '*lower_bound* - *upper_bound*'
 
 ## Remarks
 
 An intrinsic matches a hardware instruction. The hardware instruction has a fixed number of bits to encode the constant. If *value* is out of range, it will not encode properly. The compiler truncates the extra bits.
 
 ## Example
 
-The following sample generates C4556:
+The following example generates C4556:
 
 ```cpp
 // C4556.cpp
 // compile with: /W1
-// processor: x86 IPF
+// processor: x86
 #include <xmmintrin.h>
 
-void test()
-{
-   __m64 m;
-   _m_pextrw(m, 5);   // C4556
-}
-
 int main()
 {
+    __m64 m = _mm_setzero_si64();
+    _m_pextrw(m, 5);   // C4556
+    _mm_empty();
 }
 ```

docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md

@@ -1,17 +1,35 @@
 ---
-description: "Learn more about: Compiler Warning (level 1) C4799"
 title: "Compiler Warning (level 1) C4799"
-ms.date: "11/04/2016"
+description: "Learn more about: Compiler Warning (level 1) C4799"
+ms.date: "03/28/2025"
 f1_keywords: ["C4799"]
 helpviewer_keywords: ["C4799"]
-ms.assetid: 8ecbd06f-c778-4371-a2fb-c690b6743ec8
 ---
 # Compiler Warning (level 1) C4799
 
-> No EMMS at end of function '*function*'
+> function '*function*' has no EMMS instruction
 
-The function has at least one MMX instruction, but does not have an `EMMS` instruction. When a multimedia instruction is used, an `EMMS` instruction or `_mm_empty` intrinsic should also be used to clear the multimedia tag word at the end of the MMX code.
+The function has at least one MMX instruction, but does not have an `EMMS` instruction. When a multimedia instruction is used, an `EMMS` instruction or [`_mm_empty`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm_empty) intrinsic should also be used to clear the multimedia tag word at the end of the MMX code.
 
-You may get C4799 when using ivec.h, indicating that the code does not use properly execute the EMMS instruction before returning. This is a false warning for these headers. You may turn these off by defining _SILENCE_IVEC_C4799 in ivec.h. However, be aware that this will also keep the compiler from giving correct warnings of this type.
+You may get C4799 when using `ivec.h`, indicating that the code does not properly execute the `EMMS` instruction before returning. This is a false warning for these headers. You may turn these off by defining `_SILENCE_IVEC_C4799` in `ivec.h`. However, be aware that this will also keep the compiler from giving correct warnings of this type.
 
 For related information, see [Intel's MMX Instruction Set](../../assembler/inline/intel-s-mmx-instruction-set.md).
+
+## Example
+
+The following example generates C4799:
+
+```cpp
+// C4799.cpp
+// compile with: /W1
+// processor: x86
+#include <mmintrin.h>
+
+int main()
+{
+    __m64 m = _mm_setzero_si64();
+
+    // Uncomment the following line to resolve the warning:
+    // _mm_empty();
+}   // C4799
+```

docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md

@@ -953,7 +953,7 @@ These warnings, and all warnings in later versions, are suppressed by using the
 | [C4792](compiler-warning-level-3-c4792.md) | `function 'function' declared using sysimport and referenced from native code; import library required to link` |
 | [C4794](compiler-warning-level-1-c4794.md) | `segment of thread local storage variable 'name' changed from 'segment' to 'segment'` |
 | C4798 | `native code generated for p-code function 'name' with exception handler or unwind semantics` |
-| [C4799](compiler-warning-level-1-c4799.md) | `function 'name' has no EMMS instruction` |
+| [C4799](compiler-warning-level-1-c4799.md) | `function 'function' has no EMMS instruction` |
 | [C4803](compiler-warning-level-1-c4803.md) | `'declaration': the raise method has a different storage class from that of the event, 'declaration'` |
 | [C4810](compiler-warning-level-1-c4810.md) | `value of pragma pack(show) == number` |
 | [C4811](compiler-warning-level-1-c4811.md) | `value of pragma conform(forScope, show) == value` |

docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md

@@ -170,7 +170,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages
 |[Compiler warning (level 1 and level 3) C4793](compiler-warning-level-1-and-3-c4793.md)|'*function*': function compiled as native:<br> *reason*|
 |[Compiler warning (level 1) C4794](compiler-warning-level-1-c4794.md)|segment of thread local storage variable '%s' changed from '%s' to '%s'|
 |Compiler warning C4798|native code generated for p-code function 'name' with exception handler or unwind semantics|
-|[Compiler warning (level 1) C4799](compiler-warning-level-1-c4799.md)|function 'function' has no `EMMS` instruction|
+|[Compiler warning (level 1) C4799](compiler-warning-level-1-c4799.md)|function '*function*' has no EMMS instruction|
 
 ## See also