Merge pull request #1266 from MicrosoftDocs/master

8/21 AM Publish

Author: Taojunshen

.openpublishing.redirection.json

@@ -235,6 +235,11 @@
             "redirect_url": "/cpp/cpp/program-and-linkage-cpp",
             "redirect_document_id": false
         },
+        {
+            "source_path": "docs/cpp/template-friends.md",
+            "redirect_url": "/cpp/cpp/templates-cpp",
+            "redirect_document_id": false
+        },
         {
             "source_path": "docs/cpp/using-extern-to-specify-linkage.md",
             "redirect_url": "/cpp/cpp/extern-cpp",

docs/atl/reference/atl-text-encoding-functions.md

@@ -5,6 +5,9 @@ ms.date: "11/04/2016"
 ms.topic: "reference"
 f1_keywords: ["atlbase/ATL::AtlGetHexValue", "atlbase/ATL::AtlGetVersion", "atlenc/ATL::AtlHexDecode", "atlenc/ATL::AtlHexDecodeGetRequiredLength", "atlenc/ATL::AtlHexEncode", "atlenc/ATL::AtlHexEncodeGetRequiredLength", "atlenc/ATL::AtlHexValue", "atlenc/ATL::BEncode", "atlenc/ATL::BEncodeGetRequiredLength", "atlenc/ATL::EscapeXML", "atlenc/ATL::GetExtendedChars", "atlenc/ATL::IsExtendedChar", "atlenc/ATL::QEncode", "atlenc/ATL::QEncodeGetRequiredLength", "atlenc/ATL::QPDecode", "atlenc/ATL::QPDecodeGetRequiredLength", "atlenc/ATL::QPEncode", "atlenc/ATL::QPEncodeGetRequiredLength", "atlenc/ATL::UUDecode", "atlenc/ATL::UUDecodeGetRequiredLength", "atlenc/ATL::UUEncode", "atlenc/ATL::UUEncodeGetRequiredLength"]
 ms.assetid: 2ae1648b-2b87-4112-92aa-0069fcfd23da
+author: "mikeblome"
+ms.author: "mblome"
+ms.workload: ["cplusplus"]
 ---
 # ATL Text Encoding Functions
 These functions support text encoding and decoding.

docs/build/reference/TOC.md

@@ -78,6 +78,7 @@
 #### [/hotpatch (Create Hotpatchable Image)](hotpatch-create-hotpatchable-image.md)
 #### [/I (Additional Include Directories)](i-additional-include-directories.md)
 #### [/J (Default char Type Is unsigned)](j-default-char-type-is-unsigned.md)
+#### [/JMC (Just My Code debugging)](jmc.md)
 #### [/kernel (Create Kernel Mode Binary)](kernel-create-kernel-mode-binary.md)
 #### [/link (Pass Options to Linker)](link-pass-options-to-linker.md)
 #### [/LN (Create MSIL Module)](ln-create-msil-module.md)
@@ -259,6 +260,7 @@
 ### [/RELEASE (Set the Checksum)](release-set-the-checksum.md)
 ### [/SAFESEH (Image has Safe Exception Handlers)](safeseh-image-has-safe-exception-handlers.md)
 ### [/SECTION (Specify Section Attributes)](section-specify-section-attributes.md)
+### [/SOURCELINK (Include Sourcelink file in PDB)](sourcelink.md)
 ### [/STACK (Stack Allocations)](stack-stack-allocations.md)
 ### [/STUB (MS-DOS Stub File Name)](stub-ms-dos-stub-file-name.md)
 ### [/SUBSYSTEM (Specify Subsystem)](subsystem-specify-subsystem.md)

docs/build/reference/compiler-options-listed-alphabetically.md

@@ -1,7 +1,7 @@
 ---
 title: "Compiler Options Listed Alphabetically | Microsoft Docs"
 ms.custom: ""
-ms.date: "02/22/2018"
+ms.date: "08/20/2018"
 ms.technology: ["cpp-tools"]
 ms.topic: "reference"
 dev_langs: ["C++"]
@@ -79,6 +79,7 @@ The following is a comprehensive alphabetical list of compiler options. For a ca
 |[/hotpatch](hotpatch-create-hotpatchable-image.md)|Creates a hotpatchable image.|
 |[/I](i-additional-include-directories.md)|Searches a directory for include files.|
 |[/J](j-default-char-type-is-unsigned.md)|Changes the default `char` type.|
+|[/JMC](jmc.md)|Supports native C++ Just My Code debugging.|
 |[/kernel](kernel-create-kernel-mode-binary.md)|The compiler and linker will create a binary that can be executed in the Windows kernel.|
 |[/LD](md-mt-ld-use-run-time-library.md)|Creates a dynamic-link library.|
 |[/LDd](md-mt-ld-use-run-time-library.md)|Creates a debug dynamic-link library.|

docs/build/reference/compiler-options-listed-by-category.md

@@ -1,7 +1,7 @@
 ---
 title: "Compiler Options Listed by Category | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "08/20/2018"
 ms.technology: ["cpp-tools"]
 ms.topic: "reference"
 dev_langs: ["C++"]
@@ -159,6 +159,7 @@ This article contains a categorical list of compiler options. For an alphabetica
 |[/H](h-restrict-length-of-external-names.md)|Deprecated. Restricts the length of external (public) names.|
 |[/HELP](help-compiler-command-line-help.md)|Lists the compiler options.|
 |[/J](j-default-char-type-is-unsigned.md)|Changes the default `char` type.|
+|[/JMC](jmc.md)|Supports native C++ Just My Code debugging.|
 |[/kernel](kernel-create-kernel-mode-binary.md)|The compiler and linker will create a binary that can be executed in the Windows kernel.|
 |[/MP](mp-build-with-multiple-processes.md)|Builds multiple source files concurrently.|
 |[/nologo](nologo-suppress-startup-banner-c-cpp.md)|Suppresses display of sign-on banner.|

docs/build/reference/exports.md

@@ -1,7 +1,7 @@
 ---
 title: "EXPORTS | Microsoft Docs"
 ms.custom: ""
-ms.date: "07/11/2018"
+ms.date: "08/20/2018"
 ms.technology: ["cpp-tools"]
 ms.topic: "reference"
 f1_keywords: ["EXPORTS"]
@@ -38,13 +38,20 @@ EXPORTS
    func2=func1
 ```
 
-If the name that you export is from other module, specify the export's name in the DLL by using *other_module.exported_name*. For example, if your DLL exports a function `other_module.func1` and you want callers to use it as `func2`, you would specify:
+If the name that you export is from some other module, specify the export's name in the DLL by using *other_module.exported_name*. For example, if your DLL exports a function `other_module.func1` and you want callers to use it as `func2`, you would specify:
 
 ```DEF
 EXPORTS
    func2=other_module.func1
 ```
 
+If the name that you export is from another module that exports by ordinal, specify the export's ordinal in the DLL by using *other_module.#ordinal_number*. For example, if your DLL exports a function from the other module where it is ordinal 42, and you want callers to use it as `func2`, you would specify:
+
+```DEF
+EXPORTS
+   func2=other_module.#42
+```
+
 Because the Visual C++ compiler uses name decoration for C++ functions, you must either use the decorated name internal_name or define the exported functions by using extern "C" in the source code. The compiler also decorates C functions that use the [__stdcall](../../cpp/stdcall.md) calling convention with an underscore (_) prefix and a suffix composed of the at sign (@) followed by the number of bytes (in decimal) in the argument list.  
 
 To find the decorated names produced by the compiler, use the [DUMPBIN](../../build/reference/dumpbin-reference.md) tool or the linker [/MAP](../../build/reference/map-generate-mapfile.md) option. The decorated names are compiler-specific. If you export the decorated names in the .DEF file, executables that link to the DLL must also be built by using the same version of the compiler. This ensures that the decorated names in the caller match the exported names in the .DEF file.  

docs/build/reference/jmc.md

@@ -0,0 +1,46 @@
+---
+title: "/JMC (Just My Code debugging) | Microsoft Docs"
+ms.custom: "08/20/2018"
+ms.technology: ["cpp-tools"]
+ms.topic: "reference"
+f1_keywords: ["/JMC"]
+dev_langs: ["C++"]
+helpviewer_keywords: ["/JMC compiler option [C++]", "Just my code [C++]", "-JMC compiler option [C++]", "User code, debugging", "JMC compiler option [C++]"]
+author: "corob-msft"
+ms.author: "corob"
+ms.workload: ["cplusplus"]
+---
+# /JMC (Just My Code debugging)
+
+Specifies compiler support for native *Just My Code* debugging in the Visual Studio debugger. This option supports the user settings that allow Visual Studio to step over system, framework, library, and other non-user calls, and to collapse those calls in the call stack window. The **/JMC** compiler option is available starting in Visual Studio 2017 version 15.8.
+
+## Syntax
+
+> **/JMC**\[**-**]
+
+## Remarks
+
+The Visual Studio [Just My Code](/visualstudio/debugger/just-my-code) settings specify whether the Visual Studio debugger steps over system, framework, library, and other non-user calls. The **/JMC** compiler option enables support for Just My Code debugging in your native C++ code. When **/JMC** is enabled, the compiler inserts calls to a helper function, `__CheckForDebuggerJustMyCode`, in the function prolog. The helper function provides hooks that support Visual Studio debugger Just My Code step operations. To enable Just My Code in the Visual Studio debugger, on the menu bar, choose **Tools** > **Options**, and then set the option in **Debugging** > **General** > **Enable Just My Code**.
+
+The **/JMC** option requires that your code links to the C Runtime Library (CRT), which provides the `__CheckForDebuggerJustMyCode` helper function. If your project does not link to the CRT, you may see linker error **LNK2019: unresolved external symbol __CheckForDebuggerJustMyCode**. To resolve this error, either link to the CRT, or disable the **/JMC** option.
+
+By default, the **/JMC** compiler option is off. However, starting in Visual Studio 2017 version 15.8 this option is enabled in most Visual Studio project templates. To explicitly disable this option, use the **/JMC-** option on the command line. In Visual Studio, open the project Property Pages dialog box, and change the **Support Just My Code Debugging** property in the **Configuration Properties** > **C/C++** > **General** property page to **No**.
+
+For more information, see [C++ Just My Code](/visualstudio/debugger/just-my-code#BKMK_C___Just_My_Code) in [Specify whether to debug only user code using Just My Code in Visual Studio](/visualstudio/debugger/just-my-code), and the Visual C++ Team Blog post [Announcing C++ Just My Code Stepping in Visual Studio](https://blogs.msdn.microsoft.com/vcblog/2018/06/29/announcing-jmc-stepping-in-visual-studio/).
+
+### To set this compiler option in the Visual Studio development environment
+
+1. Open the project's **Property Pages** dialog box. For details, see [Working with Project Properties](../../ide/working-with-project-properties.md).
+
+1. Select the **Configuration Properties** > **C/C++** > **General** property page.
+
+1. Modify the **Support Just My Code Debugging** property.
+
+### To set this compiler option programmatically
+
+- See <xref:Microsoft.VisualStudio.VCProjectEngine.VCCLCompilerTool.AdditionalOptions%2A>.
+
+## See Also
+
+[Compiler Options](../../build/reference/compiler-options.md)<br/>
+[Setting Compiler Options](../../build/reference/setting-compiler-options.md)<br/>

docs/build/reference/linker-options.md

@@ -1,7 +1,7 @@
 ---
 title: "Linker Options | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "08/20/2018"
 ms.technology: ["cpp-tools"]
 ms.topic: "reference"
 f1_keywords: ["link"]
@@ -109,6 +109,7 @@ You can use the [comment](../../preprocessor/comment-c-cpp.md) pragma to specify
 |[/RELEASE](../../build/reference/release-set-the-checksum.md)|Sets the Checksum in the .exe header.|
 |[/SAFESEH](../../build/reference/safeseh-image-has-safe-exception-handlers.md)|Specifies that the image will contain a table of safe exception handlers.|
 |[/SECTION](../../build/reference/section-specify-section-attributes.md)|Overrides the attributes of a section.|
+|[/SOURCELINK](../../build/reference/sourcelink.md)|Specifies a SourceLink file to add to the PDB.|
 |[/STACK](../../build/reference/stack-stack-allocations.md)|Sets the size of the stack in bytes.|
 |[/STUB](../../build/reference/stub-ms-dos-stub-file-name.md)|Attaches an MS-DOS stub program to a Win32 program.|
 |[/SUBSYSTEM](../../build/reference/subsystem-specify-subsystem.md)|Tells the operating system how to run the .exe file.|

docs/build/reference/sourcelink.md

@@ -0,0 +1,46 @@
+---
+title: "/SOURCELINK (Include Sourcelink file in PDB) | Microsoft Docs"
+ms.custom: ""
+ms.date: "08/20/2018"
+ms.technology: ["cpp-tools"]
+ms.topic: "reference"
+f1_keywords: ["/sourcelink"]
+dev_langs: ["C++"]
+helpviewer_keywords: ["/SOURCELINK linker option", "/SOURCELINK"]
+author: "corob-msft"
+ms.author: "corob"
+ms.workload: ["cplusplus"]
+---
+# /SOURCELINK (Include Sourcelink file in PDB)
+
+Specifies a SourceLink configuration file to include in the PDB file generated by the linker.
+
+## Syntax
+
+> **/SOURCELINK:**_filename_
+
+## Arguments
+
+*filename*  
+Specifies a JSON-formatted configuration file that contains a simple mapping of local file paths to URLs where the source file can be retrieved for display by the debugger. For more information on the format of this file, see [Source Link JSON Schema](https://github.com/dotnet/designs/blob/master/accepted/diagnostics/source-link.md#source-link-json-schema).
+
+## Remarks
+
+SourceLink is a language- and source-control agnostic system for providing source debugging for binaries. SourceLink is supported for native C++ binaries starting in Visual Studio 2017 version 15.8. For an overview of SourceLink, see [Source Link](https://github.com/dotnet/designs/blob/master/accepted/diagnostics/source-link.md). For information on how to use SourceLink in your projects and how to generate the SourceLink file as part of your project, see [Using SourceLink](https://github.com/dotnet/sourcelink#using-sourcelink).
+
+### To set the /SOURCELINK linker option in Visual Studio
+
+1. Open the **Property Pages** dialog box for the project. For more information, see [Working with Project Properties](../../ide/working-with-project-properties.md).
+
+1. Select the **Configuration Properties** > **Linker** > **Command Line** property page.
+
+1. In the **Additional options** box, add **/SOURCELINK:**_filename_ and then choose **OK** or **Apply** to save your changes.
+
+### To set this linker option programmatically  
+  
+- This option does not have a programmatic equivalent.
+
+## See also
+
+[Setting Linker Options](../../build/reference/setting-linker-options.md)  
+[Linker Options](../../build/reference/linker-options.md)  

docs/c-runtime-library/crt-library-features.md

@@ -1,7 +1,7 @@
 ---
 title: "CRT Library Features | Microsoft Docs"
 ms.custom: ""
-ms.date: "03/13/2018"
+ms.date: "08/20/2018"
 ms.technology: ["cpp-standard-libraries"]
 ms.topic: "conceptual"
 f1_keywords: ["c.runtime"]
@@ -42,6 +42,9 @@ This table lists the libraries that implement the vcruntime library.
 |vcruntime.lib|vcruntime\<version>.dll|DLL import library for the vcruntime.|**/MD**|_MT, _DLL|
 |vcruntimed.lib|vcruntime\<version>d.dll|DLL import library for the Debug vcruntime. Not redistributable.|**/MDd**|_DEBUG, _MT, _DLL|
 
+When the UCRT refactoring occurred, the Concurrency Runtime functions were moved into
+concrt140.dll, which is part of the C++ redistributable package. This DLL is required for C++ parallel containers and algorithms such as `concurrency::parallel_for`. In addition, the C++ Standard Library requires this DLL on Windows XP to support synchronization primitives, because Windows XP does not have condition variables.
+
 The code that initializes the CRT is in one of several libraries, based on whether the CRT library is statically or dynamically linked, or native, managed, or mixed code. This code handles CRT startup, internal per-thread data initialization, and termination. It is specific to the version of the compiler used. This library is always statically linked, even when using a dynamically linked UCRT.
 
 This table lists the libraries that implement CRT initialization and termination.

docs/cpp/TOC.md

@@ -275,7 +275,6 @@
 ## [Templates](templates-cpp.md)
 ### [typename](typename.md)
 ### [Class Templates](class-templates.md)
-### [Template Friends](template-friends.md)
 ### [Function Templates](function-templates.md)
 #### [Function Template Instantiation](function-template-instantiation.md)
 #### [Explicit Instantiation](explicit-instantiation.md)

docs/cpp/attributes.md

@@ -4,7 +4,11 @@ ms.custom: ""
 ms.date: "03/28/2017"
 ms.topic: "language-reference"
 ms.assetid: 748340d9-8abf-4940-b0a0-91b6156a3ff8
+author: "mikeblome"
+ms.author: "mblome"
+ms.workload: ["cplusplus"]
 ---
+
 # Attributes in C++
 
 The C++ Standard defines a set of attributes and also allows compiler vendors to define their own attributes (within a vendor-specific namespace), but compilers are required to recognize only those attributes defined in the standard.

docs/cpp/goto-statement-cpp.md

@@ -25,6 +25,25 @@ goto identifier;
  The labeled statement designated by `identifier` must be in the current function. All `identifier` names are members of an internal namespace and therefore do not interfere with other identifiers.  
 
  A statement label is meaningful only to a **goto** statement; otherwise, statement labels are ignored. Labels cannot be redeclared.  
+
+A **goto** statement is not allowed to transfer control to a location that skips over the initialization of any variable that is in scope in that location. The following example raises C2362:
+
+```cpp
+int goto_fn(bool b)
+{
+    if (!b)
+    {
+        goto exit;  // C2362
+    }
+    else
+    { /*...*/ }
+
+    int error_code = 42;
+
+exit:
+    return error_code;
+}
+```
   
  It is good programming style to use the **break**, **continue**, and **return** statements instead of the **goto** statement whenever possible. However, because the **break** statement exits from only one level of a loop, you might have to use a **goto** statement to exit a deeply nested loop.  
   
@@ -76,4 +95,4 @@ Jumped to stop. i = 3
 
 ## See also  
  [Jump Statements](../cpp/jump-statements-cpp.md)   
- [Keywords](../cpp/keywords-cpp.md)
+ [Keywords](../cpp/keywords-cpp.md)

docs/cpp/microsoft-specific-modifiers.md

@@ -1,7 +1,7 @@
 ---
 title: "Microsoft-Specific Modifiers | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "08/16/2018"
 ms.technology: ["cpp-language"]
 ms.topic: "language-reference"
 dev_langs: ["C++"]
@@ -13,10 +13,29 @@ ms.workload: ["cplusplus"]
 # Microsoft-Specific Modifiers
 This section describes Microsoft-specific extensions to C++ in the following areas:  
 
--   [Based addressing](../cpp/based-addressing.md), the practice of using a pointer as a base from which other pointers can be offset  
+-   [Based addressing](based-addressing.md), the practice of using a pointer as a base from which other pointers can be offset  
 
--   [Function calling conventions](../cpp/calling-conventions.md)  
+-   [Function calling conventions](calling-conventions.md)  
 
--   Extended storage-class attributes declared with the [__declspec](../cpp/declspec.md) keyword  
+-   Extended storage-class attributes declared with the [__declspec](declspec.md) keyword  
 
--   The [__w64](../cpp/w64.md) keyword  
+-   The [__w64](w64.md) keyword  
+
+### Microsoft-Specific Keywords  
+
+Many of the Microsoft-specific keywords can be used to modify declarators to form derived types. For more information about declarators, see [Declarators](overview-of-declarators.md).  
+
+|Keyword|Meaning|Used to Form Derived Types?|  	
+|-------------|-------------|---------------------------------|
+|[__based](based-grammar.md)|The name that follows declares a 32-bit offset to the 32-bit base contained in the declaration.|Yes|  	
+|[__cdecl](cdecl.md)|The name that follows uses the C naming and calling conventions.|Yes|  	
+|[__declspec](declspec.md)|The name that follows specifies a Microsoft-specific storage-class attribute.|No|  	
+|[__fastcall](fastcall.md)|The name that follows declares a function that uses registers, when available, instead of the stack for argument passing.|Yes|  	
+|[__restrict](extension-restrict.md)|Similar to __declspec([restrict](restrict.md)), but for use on variables.|No|  	
+|[__stdcall](stdcall.md)|The name that follows specifies a function that observes the standard calling convention.|Yes|  	
+|[__w64](w64.md)|Marks a data type as being larger on a 64-bit compiler.|No|  	
+|[__unaligned](unaligned.md)|Specifies that a pointer to a type or other data is not aligned..|No|  	
+|[__vectorcall](vectorcall.md)|The name that follows declares a function that uses registers, including SSE registers, when available, instead of the stack for argument passing.|Yes|  	
+  	
+## See Also  	
+ [C++ Language Reference](cpp-language-reference.md)

docs/cpp/references-to-pointers.md

@@ -1,7 +1,7 @@
 ---
 title: "References to Pointers | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "08/20/2018"
 ms.technology: ["cpp-language"]
 ms.topic: "language-reference"
 dev_langs: ["C++"]
@@ -66,7 +66,7 @@ int main( int argc, char *argv[] ) {
 
    // Read a text file from the standard input device and  
    //  build a binary tree.  
-   //while( !cin.eof() )   
+   while( !cin.eof() )   
    {  
       cin.get( szBuf, sizeOfBuffer, '\n' );  
       cin.get();