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

openpublishbuild · Colin Robertson · commit 0ee38ddd0ade · 2017-09-15T16:27:11.000-07:00
* merge to live (#341) * Add _chkstk to list of internals * Fixes for command line issues * Minor tweak * Update random.md (#322) Fix broken fwlink to presentation on rand * Update link names and instructions * More link fixes, consolidation * Another tweak * Update x64 topics, topic names * Fix C3861 issues. * Fix link issues. * Dang typoes. * Confirm merge from FromPublicMasterBranch to master to sync with https://github.com/MicrosoftDocs/cpp-docs (branch master) (MicrosoftDocs#323) * Update random.md Fix broken fwlink to presentation on rand * Update arm-assembler-reference.md Point to search engine to pick up latest results for ARM references on the ARM Developer Center. * Update some egregious out-of-dateness * Fix a link typo. * Update to address user complaints * Minor tweaks. * Remove stray parens. * updated info on mbcs dll (MicrosoftDocs#325) * Confirm merge from FromPublicMasterBranch to master to sync with https://github.com/MicrosoftDocs/cpp-docs (branch master) (MicrosoftDocs#326) * Update random.md Fix broken fwlink to presentation on rand * Update arm-assembler-reference.md Point to search engine to pick up latest results for ARM references on the ARM Developer Center. * Update desktop-applications-visual-cpp.md Fix space issue * Fix some C1083 user complaints (MicrosoftDocs#332) * First draft of fixes for user complaints * More updates for common issues * More consistency tweaks * Fix link typo * Make C2065 friendlier (#333) * Try to address some user issues. * Add a useful link. * Updated namespaces topic (#329) * updated namespaces topic * udpated ms.date * Updated content on MFC MBCS DLL (MicrosoftDocs#328) * updated info on mbcs dll * minor tweak * udpated ms.date * Update ms.date to match changes. * Update more freshness dates * Escape brackets, fix format * Update .openpublishing.publish.config.json with pdf info (#336) * Update .openpublishing.publish.config.json * Update .openpublishing.publish.config.json * Confirm merge from FromPublicMasterBranch to master to sync with https://github.com/MicrosoftDocs/cpp-docs (branch master) (#335) * Update random.md Fix broken fwlink to presentation on rand * Update arm-assembler-reference.md Point to search engine to pick up latest results for ARM references on the ARM Developer Center. * Update desktop-applications-visual-cpp.md Fix space issue * 📦 Enable PDF generation. * zc-conformance.md: rvalueCast is off by default rvalueCast is off by default according to the https://docs.microsoft.com/en-us/cpp/build/reference/zc-rvaluecast-enforce-type-conversion-rules * Fix bad merge in storage-classes-cpp Had merge conflict markers * Update .openpublishing.publish.config.json * Fix typographical error The fix is for the file docs/windows/desktop-applications-visual-cpp.md and adds the missing word "that" to a sentence. * Correct .ERRDIF[[I]] title * Fixed indentation * Replace nonsense with correct statement Replace nonsense with correct statement * Update read.md Fix some more formatting while we're at it. * Correct build working directory * Order link option alphabetically Orders link option CLRUNMANAGEDCODECHECK alphabetically in the table of contents for consistency. * Updating timestamp Worth getting this right, since otherwise it doesn't look like this page covers 15.3 (and it does!) * Update cl-environment-variables.md Line 65, fixed spelling of "setting". * Update CONTRIBUTING.md * Resolve syncing conflicts from FromPublicMasterBranch to master (#340) * Update random.md Fix broken fwlink to presentation on rand * Update arm-assembler-reference.md Point to search engine to pick up latest results for ARM references on the ARM Developer Center. * Update desktop-applications-visual-cpp.md Fix space issue * 📦 Enable PDF generation. * zc-conformance.md: rvalueCast is off by default rvalueCast is off by default according to the https://docs.microsoft.com/en-us/cpp/build/reference/zc-rvaluecast-enforce-type-conversion-rules * Fix bad merge in storage-classes-cpp Had merge conflict markers * Update .openpublishing.publish.config.json * Fix typographical error The fix is for the file docs/windows/desktop-applications-visual-cpp.md and adds the missing word "that" to a sentence. * Correct .ERRDIF[[I]] title * Fixed indentation * Replace nonsense with correct statement Replace nonsense with correct statement * Update read.md Fix some more formatting while we're at it. * Correct build working directory * Order link option alphabetically Orders link option CLRUNMANAGEDCODECHECK alphabetically in the table of contents for consistency. * Updating timestamp Worth getting this right, since otherwise it doesn't look like this page covers 15.3 (and it does!) * Update cl-environment-variables.md Line 65, fixed spelling of "setting". * Update CONTRIBUTING.md * Update filesystem-enumerations.md Fix for minor grammatical issue * Correct unnecessary '\<' escape The markdown processor changed a couple of sprints ago, and '<' escaping is no longer required in backtick code literals, and also generates incorrect backslash iont he viewed content * remove spurious text from code examples * Format C++ samples as cpp. - Also use headers to separate sample output, instead of unsupported "Output" syntax * Apply cpp to code samples so they are syntax highlighted - also consistent usage of bold/code * Apply cpp to code samples for syntax highlighting * Add missing 'cpp' for C++ code blocks * Portable escape syntax for asterisk, add cpp to code samples - Different md processors handle character escapes differently. In particular, the OPS markdown processor is in some places different than the GitHub/VSTS/etc previewers. A recent sprint changed the markdown processor, so this topic doesn't render the escaped asterisks properly. Changed these to use html character references, which render properly in all processors/viewers. - add cpp to c++ code samples * add cpp to C++ code samples, md lint headers markdown lint says to use blank lines around headers * use cpp in c++ code samples so they get highlighted * Use cpp for C++ code samples * Use cpp for C++ code samples * use cpp for C++ code samples * cpp for c++ code samples, edits - Use cpp for c++ code examples so they get syntax highlighting - Edit for correct standard MS notation for `code literal`, **keyword**. - Make headings parallel and aligned with the defined terms wrt the inclusion/explicit instantiation models * Update template-friends.md Undo output tag change - this should be a global change if we decide to make it. * Update partial-ordering-of-function-templates-cpp.md Updated escapes to switch ** to __. Babelmark 2 https://johnmacfarlane.net/babelmark2/ seems to find these changes acceptable. Cleaned a little formatting. * Update variant-t-extractors.md * Correct const correct overloads macro name In both VS 2015 and 2017 (I didn't check any other versions), the macro is actually called `_CRT_CONST_CORRECT_OVERLOADS`. Adjust the documentation accordingly, and adjust some formatting in the process.
diff --git a/docs/c-runtime-library/reference/memchr-wmemchr.md b/docs/c-runtime-library/reference/memchr-wmemchr.md
@@ -105,7 +105,7 @@ const wchar_t *wmemchr(
 ## Remarks  
  `memchr` and `wmemchr` look for the first occurrence of `c` in the first `count` bytes of `buf`. It stops when it finds `c` or when it has checked the first `count` bytes.  
   
- In C, these functions take a `const` pointer for the first argument. In C++, two overloads are available. The overload taking a pointer to `const` returns a pointer to `const`; the version that takes a pointer to non-`const` returns a pointer to non-`const`. The macro _CONST_CORRECT_OVERLOADS is defined if both the `const` and non-`const` versions of these functions are available. If you require the non-`const` behavior for both C++ overloadsin C++, define the symbol _CONST_RETURN.  
+ In C, these functions take a `const` pointer for the first argument. In C++, two overloads are available. The overload taking a pointer to `const` returns a pointer to `const`; the version that takes a pointer to non-`const` returns a pointer to non-`const`. The macro _CRT_CONST_CORRECT_OVERLOADS is defined if both the `const` and non-`const` versions of these functions are available. If you require the non-`const` behavior for both C++ overloadsin C++, define the symbol _CONST_RETURN.  
   
 ## Requirements  
   
diff --git a/docs/c-runtime-library/reference/strchr-wcschr-mbschr-mbschr-l.md b/docs/c-runtime-library/reference/strchr-wcschr-mbschr-mbschr-l.md
@@ -150,7 +150,7 @@ const unsigned char *_mbschr_l(
   
  The output value is affected by the setting of the `LC_CTYPE` category setting of the locale; for more information, see [setlocale](../../c-runtime-library/reference/setlocale-wsetlocale.md). The versions of these functions without the `_l` suffix use the current locale for this locale-dependent behavior; the versions with the `_l` suffix are identical except that they use the locale parameter passed in instead. For more information, see [Locale](../../c-runtime-library/locale.md).  
   
- In C, these functions take a `const` pointer for the first argument. In C++, two overloads are available. The overload taking a pointer to `const` returns a pointer to `const`; the version that takes a pointer to non-`const` returns a pointer to non-`const`. The macro _CONST_CORRECT_OVERLOADS is defined if both the `const` and non-`const` versions of these functions are available. If you require the non-`const` behavior for both C++ overloads, define the symbol _CONST_RETURN.  
+ In C, these functions take a `const` pointer for the first argument. In C++, two overloads are available. The overload taking a pointer to `const` returns a pointer to `const`; the version that takes a pointer to non-`const` returns a pointer to non-`const`. The macro `_CRT_CONST_CORRECT_OVERLOADS` is defined if both the `const` and non-`const` versions of these functions are available. If you require the non-`const` behavior for both C++ overloads, define the symbol `_CONST_RETURN`.  
   
 ### Generic-Text Routine Mappings  
   
diff --git a/docs/c-runtime-library/reference/strpbrk-wcspbrk-mbspbrk-mbspbrk-l.md b/docs/c-runtime-library/reference/strpbrk-wcspbrk-mbspbrk-mbspbrk-l.md
@@ -156,7 +156,7 @@ const unsigned char *_mbspbrk_l(
   
  `_mbspbrk` is similar to `_mbscspn` except that `_mbspbrk` returns a pointer rather than a value of type [size_t](../../c-runtime-library/standard-types.md).  
   
- In C, these functions take a `const` pointer for the first argument. In C++, two overloads are available. The overload taking a pointer to `const` returns a pointer to `const`; the version that takes a pointer to non-`const` returns a pointer to non-`const`. The macro _CONST_CORRECT_OVERLOADS is defined if both the `const` and non-`const` versions of these functions are available. If you require the non-`const` behavior for both C++ overloads, define the symbol _CONST_RETURN.  
+ In C, these functions take a `const` pointer for the first argument. In C++, two overloads are available. The overload taking a pointer to `const` returns a pointer to `const`; the version that takes a pointer to non-`const` returns a pointer to non-`const`. The macro `_CRT_CONST_CORRECT_OVERLOADS` is defined if both the `const` and non-`const` versions of these functions are available. If you require the non-`const` behavior for both C++ overloads, define the symbol `_CONST_RETURN`.  
   
  The output value is affected by the setting of the `LC_CTYPE` category setting of the locale; for more information, see [setlocale](../../c-runtime-library/reference/setlocale-wsetlocale.md). The versions of these functions without the `_l` suffix use the current locale for this locale-dependent behavior; the version with the `_l` suffix is identical except that it uses the locale parameter passed in instead. For more information, see [Locale](../../c-runtime-library/locale.md).  
   
diff --git a/docs/c-runtime-library/reference/strrchr-wcsrchr-mbsrchr-mbsrchr-l.md b/docs/c-runtime-library/reference/strrchr-wcsrchr-mbsrchr-mbsrchr-l.md
@@ -149,7 +149,7 @@ const unsigned char *_mbsrchr_l(
   
  `wcsrchr` and `_mbsrchr` are wide-character and multibyte-character versions of `strrchr`. The arguments and return value of `wcsrchr` are wide-character strings; those of `_mbsrchr` are multibyte-character strings.  
   
- In C, these functions take a `const` pointer for the first argument. In C++, two overloads are available. The overload taking a pointer to `const` returns a pointer to `const`; the version that takes a pointer to non-`const` returns a pointer to non-`const`. The macro _CONST_CORRECT_OVERLOADS is defined if both the `const` and non-`const` versions of these functions are available. If you require the non-`const` behavior for both C++ overloads, define the symbol _CONST_RETURN.  
+ In C, these functions take a `const` pointer for the first argument. In C++, two overloads are available. The overload taking a pointer to `const` returns a pointer to `const`; the version that takes a pointer to non-`const` returns a pointer to non-`const`. The macro `_CRT_CONST_CORRECT_OVERLOADS` is defined if both the `const` and non-`const` versions of these functions are available. If you require the non-`const` behavior for both C++ overloads, define the symbol `_CONST_RETURN`.  
   
  `_mbsrchr` validates its parameters. If `str` is `NULL`, the invalid parameter handler is invoked, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md). If execution is allowed to continue, `errno` is set to `EINVAL` and `_mbsrchr` returns 0. `strrchr` and `wcsrchr` do not validate their parameters. These three functions behave identically otherwise.  
   
diff --git a/docs/c-runtime-library/reference/strstr-wcsstr-mbsstr-mbsstr-l.md b/docs/c-runtime-library/reference/strstr-wcsstr-mbsstr-mbsstr-l.md
@@ -152,7 +152,7 @@ const unsigned char *_mbsstr_l(
 > [!IMPORTANT]
 >  These functions might incur a threat from a buffer overrun problem. Buffer overrun problems can be used to attack a system because they can allow the execution of arbitrary code, which can cause an unwarranted elevation of privilege. For more information, see [Avoiding Buffer Overruns](http://msdn.microsoft.com/library/windows/desktop/ms717795).  
   
- In C, these functions take a `const` pointer for the first argument. In C++, two overloads are available. The overload that takes a pointer to `const` returns a pointer to `const`; the version that takes a pointer to non-`const` returns a pointer to non-`const`. The macro _CONST_CORRECT_OVERLOADS is defined if both the `const` and non-`const` versions of these functions are available. If you require the non-`const` behavior for both C++ overloads, define the symbol _CONST_RETURN.  
+ In C, these functions take a `const` pointer for the first argument. In C++, two overloads are available. The overload that takes a pointer to `const` returns a pointer to `const`; the version that takes a pointer to non-`const` returns a pointer to non-`const`. The macro `_CRT_CONST_CORRECT_OVERLOADS` is defined if both the `const` and non-`const` versions of these functions are available. If you require the non-`const` behavior for both C++ overloads, define the symbol `_CONST_RETURN`.  
   
  The output value is affected by the locale-category setting of `LC_CTYPE`; for more information, see [setlocale, _wsetlocale](../../c-runtime-library/reference/setlocale-wsetlocale.md). The versions of these functions that do not have the `_l` suffix use the current locale for this locale-dependent behavior; the versions that have the `_l` suffix are identical except that they instead use the locale parameter that's passed in. For more information, see [Locale](../../c-runtime-library/locale.md).  
   
diff --git a/docs/cpp/variant-t-extractors.md b/docs/cpp/variant-t-extractors.md
@@ -25,8 +25,7 @@ translation.priority.ht: ["cs-cz", "de-de", "es-es", "fr-fr", "it-it", "ja-jp",
 ## Syntax  
   
 ```  
-  
-      operator short( ) const;   
+operator short( ) const;   
 operator long( ) const;   
 operator float( ) const;   
 operator double( ) const;   
@@ -75,4 +74,4 @@ operator unsigned __int64() const;
  **END Microsoft Specific**  
   
 ## See Also  
- [_variant_t Class](../cpp/variant-t-class.md)
+ [_variant_t Class](../cpp/variant-t-class.md)
