Merge pull request #210 from Microsoft/master

updated links to various topics, and f1 for C++/CX

Author: mikeblome

docs/cpp/attributes2.md

@@ -26,6 +26,10 @@ void Foo(int);
 -   `carries_dependency`--specifies that the function propagates data dependency ordering with respect to thread synchronization. The attribute can be applied to one or more parameters, to specify that the passed-in argument carries a dependency into the function body. The attribute can be applied to the function itself, to specify that the return value carries a dependency out of the function.   The compiler can use this information to generate more efficient code.  
 
 -   `deprecated` – specifies that a function is not intended to be used, and might not exist in future versions of a library interface. The compiler can use this to generate an informational message when client code attempts to call the function. Can be applied to declaration of a class, a typedef-name, a variable, a non-static data member, a function, a namespace, an enumeration, an enumerator, or a template specialization.  
+
+-   `fallthrough` - **Visual Studio 2017 and later:**(available with [/std:c++latest](../build/reference/std-specify-language-standard-version.md)) The `[[fallthrough]]` attribute can be used in the context of [switch](switch-statement-cpp.md) statements as a hint to the compiler (or anyone reading the code) that the fallthrough behavior is intended. The Visual C++ compiler currently does not warn on fallthrough behavior, so this attribute has no effect compiler behavior.
+
+**Microsoft-specific:**
 
 -   `gsl::suppress`  -- this Microsoft-specific attribute is used for suppressing warnings from checkers that enforce [Guidelines Support Library (GSL)](https://github.com/Microsoft/GSL) rules in code. For example, consider the code snippet below  
 

docs/cpp/range-based-for-statement-cpp.md

@@ -42,9 +42,11 @@ Executes `statement` repeatedly and sequentially for each element in `expression
 ```  
 
 ## Remarks  
- Use the range-based `for` statement to construct loops that must execute through a "range", which is defined as anything that you can iterate through—for example, `std::vector`, or any other C++ Standard Library sequence whose range is defined by a `begin()` and `end()`. The name that is declared in the `for-range-declaration` portion is local to the `for` statement and cannot be re-declared in `expression` or `statement`. Note that the [auto](../cpp/auto-cpp.md) keyword is preferred in the `for-range-declaration` portion of the statement.  
+ Use the range-based `for` statement to construct loops that must execute through a "range", which is defined as anything that you can iterate through—for example, `std::vector`, or any other C++ Standard Library sequence whose range is defined by a `begin()` and `end()`. The name that is declared in the `for-range-declaration` portion is local to the `for` statement and cannot be re-declared in `expression` or `statement`. Note that the [auto](../cpp/auto-cpp.md) keyword is preferred in the `for-range-declaration` portion of the statement. 
+
+ **New in Visual Studio 2017:**  Range-based for loops no longer require that begin() and end() return objects of the same type. This enables end() to return a sentinel object such as used by ranges as defined in the Ranges-V3 proposal. For more information, see [Generalizing the Range-Based For Loop](http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2016/p0184r0.html) and the [range-v3 library on GitHub](https://github.com/ericniebler/range-v3).
 
- This code shows how to use ranged `for` loops to iterate through an array and a vector:  
+ This code shows how to use range-based `for` loops to iterate through an array and a vector:  
 
 ```cpp  
 // range-based-for.cpp  
@@ -78,7 +80,7 @@ int main()
     }  
     cout << endl;  
 
-    for( const auto &y : x ) { // Type inference by reference.  
+    for( const auto &y : x ) { // Type inference by const reference.  
         // Observes in-place. Preferred when no modify is needed.  
         cout << y << " ";  
     }  

docs/cpp/switch-statement-cpp.md

@@ -99,11 +99,39 @@ int main() {
 }  
 ```  
 
- In the above example, `capa` is incremented if `c` is an uppercase `A`. The `break` statement after `capa++` terminates execution of the `switch` statement body and control passes to the `while` loop. Without the `break` statement, `lettera` and `nota` would also be incremented. A similar purpose is served by the `break` statement for `case 'a'`. If `c` is a lowercase `a`, `lettera` is incremented and the `break` statement terminates the `switch` statement body. If `c` is not an `a` or `A`, the `default` statement is executed.  
+ In the above example, `capa` is incremented if `c` is an uppercase `A`. The `break` statement after `capa++` terminates execution of the `switch` statement body and control passes to the `while` loop. Without the `break` statement, execution would "fall through" to the next labeled statement, so that `lettera` and `nota` would also be incremented. A similar purpose is served by the `break` statement for `case 'a'`. If `c` is a lowercase `a`, `lettera` is incremented and the `break` statement terminates the `switch` statement body. If `c` is not an `a` or `A`, the `default` statement is executed.  
+
+ **Visual Studio 2017 and later:** (available with [/std:c++latest](../build/reference/std-specify-language-standard-version.md)) The `[[fallthrough]]` attribute is specified in the C++17 standard. It can be used in a `switch` statement as a hint to the compiler (or to anyone reading the code) that fall-through behavior is intended. The Visual C++ compiler currently does not warn on fallthrough behavior, so this attribute has no effect compiler behavior. Note that the attribute is applied to an empty statement within the labeled statement; in other words the semicolon is necessary.
+
+```cpp
+int main()
+{
+	int n = 5;
+	switch (n)
+	{
+
+	case 1:
+		a();
+		break;
+	case 2:
+		b();
+		d();
+		[[fallthrough]]; // I meant to do this!
+	case 3:
+		c();
+		break;
+	default:
+		d();
+		break;
+	}
+
+	return 0;
+}
+```
 
  An inner block of a `switch` statement can contain definitions with initializations as long as they are reachable — that is, not bypassed by all possible execution paths. Names introduced using these declarations have local scope. For example:  
 
-```  
+```cpp  
 // switch_statement2.cpp  
 // C2360 expected  
 #include <iostream>  
@@ -137,7 +165,8 @@ int main(int argc, char *argv[])
 ```  
   
  A `switch` statement can be nested. In such cases, **case** or **default** labels associate with the closest `switch` statement that encloses them.  
-  
+
+ 
 ## Microsoft Specific  
  Microsoft C does not limit the number of case values in a `switch` statement. The number is limited only by the available memory. ANSI C requires at least 257 case labels be allowed in a `switch` statement.  
   

docs/cppcx/TOC.md

@@ -33,10 +33,10 @@
 ## [Weak references and breaking cycles (C++/CX)](weak-references-and-breaking-cycles-c-cx.md)
 ## [Namespaces Reference (C++/CX)](namespaces-reference-c-cx.md)
 ### [default namespace](default-namespace.md)
-#### [default::(type_name)::Equals Method](default-type-name-equals-method.md)
-#### [default::(type_name)::GetHashCode Method](default-type-name-gethashcode-method.md)
-#### [default::(type_name)::GetType Method](default-type-name-gettype-method.md)
-#### [default::(type_name)::ToString Method](default-type-name-tostring-method.md)
+#### [default::(type_name)::Equals](default-type-name-equals-method.md)
+#### [default::(type_name)::GetHashCode](default-type-name-gethashcode-method.md)
+#### [default::(type_name)::GetType](default-type-name-gettype-method.md)
+#### [default::(type_name)::ToString](default-type-name-tostring-method.md)
 ### [Platform namespace (C++/CX)](platform-namespace-c-cx.md)
 #### [Platform::AccessDeniedException Class](platform-accessdeniedexception-class.md)
 #### [Platform::Agile Class](platform-agile-class.md)
@@ -69,7 +69,7 @@
 #### [Platform::OperationCanceledException Class](platform-operationcanceledexception-class.md)
 #### [Platform::OutOfBoundsException Class](platform-outofboundsexception-class.md)
 #### [Platform::OutOfMemoryException Class](platform-outofmemoryexception-class.md)
-#### [Platform::ReCreateException Method](platform-recreateexception-method.md)
+#### [Platform::ReCreateException](platform-recreateexception-method.md)
 #### [Platform::SizeT value class](platform-sizet-value-class.md)
 #### [Platform::STAThreadAttribute Class](platform-stathreadattribute-class.md)
 #### [Platform::String Class](platform-string-class.md)

docs/cppcx/collections-c-cx.md

@@ -98,7 +98,7 @@ void FindButton(UIElementCollection^ col)
 ## Collection types  
  Collections fall into four categories: modifiable versions and read-only versions of sequence collections and associative collections. In addition, C++/CX enhances collections by providing three iterator classes that simplify the accessing of collections. 
 
- Elements of a modifiable collection can be changed, but elements of a read-only collection, which is known as a *view*, can only be read. Elements of a [Platform::Collections::Vector](../cppcx/platform-collections-vector-class.md) or[Platform::Collections::VectorView](../cppcx/platform-collections-vectorview-class.md) collection can be accessed by using an iterator or the collection's [Vector::GetAt Method](../cppcx/platform-collections-vector-class.md#getat) and an index. Elements of an associative collection can be accessed by using the collection's [Map::Lookup Method](../cppcx/platform-collections-map-class.md#lookup) and a key.  
+ Elements of a modifiable collection can be changed, but elements of a read-only collection, which is known as a *view*, can only be read. Elements of a [Platform::Collections::Vector](../cppcx/platform-collections-vector-class.md) or[Platform::Collections::VectorView](../cppcx/platform-collections-vectorview-class.md) collection can be accessed by using an iterator or the collection's [Vector::GetAt](../cppcx/platform-collections-vector-class.md#getat) and an index. Elements of an associative collection can be accessed by using the collection's [Map::Lookup](../cppcx/platform-collections-map-class.md#lookup) and a key.  
 
  [Platform::Collections::Map Class](../cppcx/platform-collections-map-class.md)  
  A modifiable, associative collection. Map elements are key-value pairs. Looking up a key to retrieve its associated value, and iterating through all key-value pairs, are both supported.  

docs/cppcx/default-namespace.md

@@ -32,10 +32,10 @@ namespace default;
 
 |||  
 |-|-|  
-|[default::(type_name)::Equals Method](../cppcx/default-type-name-equals-method.md)|Determines whether the specified object is equal to the current object.|  
-|[default::(type_name)::GetHashCode Method](../cppcx/default-type-name-gethashcode-method.md)|Returns the hash code for this instance.|  
-|[default::(type_name)::GetType Method](../cppcx/default-type-name-gettype-method.md)|Returns a string that represents the current type.|  
-|[default::(type_name)::ToString Method](../cppcx/default-type-name-tostring-method.md)|Returns a string that represents the current type.|  
+|[default::(type_name)::Equals](../cppcx/default-type-name-equals-method.md)|Determines whether the specified object is equal to the current object.|  
+|[default::(type_name)::GetHashCode](../cppcx/default-type-name-gethashcode-method.md)|Returns the hash code for this instance.|  
+|[default::(type_name)::GetType](../cppcx/default-type-name-gettype-method.md)|Returns a string that represents the current type.|  
+|[default::(type_name)::ToString](../cppcx/default-type-name-tostring-method.md)|Returns a string that represents the current type.|  
 
 ### Built-in types  
 

docs/cppcx/default-type-name-equals-method.md

@@ -9,7 +9,7 @@ ms.suite: ""
 ms.tgt_pltfrm: ""
 ms.topic: "language-reference"
 f1_keywords: 
-  - "Platform/Platform::Object::Equals"
+  - "VCCORLIB/Platform::Object::Equals"
 dev_langs: 
   - "C++"
 ms.assetid: 4450f835-06fc-4758-8d0a-72cf00007873

docs/cppcx/default-type-name-gethashcode-method.md

@@ -9,7 +9,7 @@ ms.suite: ""
 ms.tgt_pltfrm: ""
 ms.topic: "language-reference"
 f1_keywords: 
-  - "Platform/Platform::Object::GetHashCode"
+  - "VCCORLIB/Platform::Object::GetHashCode"
 dev_langs: 
   - "C++"
 ms.assetid: 58ea60f8-f820-4103-9b9b-b6635ada3fa5

docs/cppcx/default-type-name-gettype-method.md

@@ -9,7 +9,7 @@ ms.suite: ""
 ms.tgt_pltfrm: ""
 ms.topic: "language-reference"
 f1_keywords: 
-  - "Platform/Platform::Object::GetType"
+  - "VCCORLIB/Platform::Object::GetType"
 dev_langs: 
   - "C++"
 ms.assetid: 21d0bf92-fac4-48cd-9108-c6f57ba1196a

docs/cppcx/default-type-name-tostring-method.md

@@ -9,7 +9,7 @@ ms.suite: ""
 ms.tgt_pltfrm: ""
 ms.topic: "language-reference"
 f1_keywords: 
-  - "Platform/Platform::Object::ToString"
+  - "VCCORLIB/Platform::Object::ToString"
 dev_langs: 
   - "C++"
 ms.assetid: 2541955f-d844-4bd8-944d-185198c86579

docs/cppcx/exceptions-c-cx.md

@@ -16,7 +16,7 @@ manager: "ghogen"
 ---
 # Exceptions (C++/CX)
 
-Error handling in C++/CX is based on exceptions. At the most fundamental level, [!INCLUDE[wrt](includes/wrt-md.md)] components report errors as HRESULT values. In C++/CX, these values are converted to strongly typed exceptions that contain an HRESULT value and a string description that you can access programmatically.  Exceptions are implemented as a `ref class` that derives from `Platform::Exception`.  The `Platform` namespace defines distinct exception classes for the most common HRESULT values; all other values are reported through the `Platform::COMException` class. All exception classes have an [Exception::HResult Property](platform-exception-class.md#hresult) field that you can use to retrieve the original HRESULT. You can also examine call-stack information for user code in the debugger that can help pinpoint the original source of the exception, even if it originated in code that was written in a language other than C++.  
+Error handling in C++/CX is based on exceptions. At the most fundamental level, [!INCLUDE[wrt](includes/wrt-md.md)] components report errors as HRESULT values. In C++/CX, these values are converted to strongly typed exceptions that contain an HRESULT value and a string description that you can access programmatically.  Exceptions are implemented as a `ref class` that derives from `Platform::Exception`.  The `Platform` namespace defines distinct exception classes for the most common HRESULT values; all other values are reported through the `Platform::COMException` class. All exception classes have an [Exception::HResult](platform-exception-class.md#hresult) field that you can use to retrieve the original HRESULT. You can also examine call-stack information for user code in the debugger that can help pinpoint the original source of the exception, even if it originated in code that was written in a language other than C++.  
 
 ## Exceptions  
  In your C++ program, you can throw and catch an exception that comes from a [!INCLUDE[wrt](includes/wrt-md.md)] operation, an exception that's derived from `std::exception`, or a user-defined type. You have to throw a [!INCLUDE[wrt](includes/wrt-md.md)] exception only when it will cross the application binary interface (ABI) boundary, for example, when the code that catches your exception is written in JavaScript. When a non-[!INCLUDE[wrt](includes/wrt-md.md)] C++ exception reaches the ABI boundary, the exception is translated into a `Platform::FailureException` exception, which represents an E_FAIL HRESULT. For more information about the ABI, see [Creating Windows Runtime Components in C++](/MicrosoftDocs/windows-uwp/blob/docs/windows-apps-src/winrt-components/creating-windows-runtime-components-in-cpp.md).  

docs/cppcx/platform-accessdeniedexception-class.md

@@ -9,8 +9,8 @@ ms.suite: ""
 ms.tgt_pltfrm: ""
 ms.topic: "language-reference"
 f1_keywords: 
-  - "Platform/Platform::AccessDeniedException"
-  - "Platform/Platform::AccessDeniedException::AccessDeniedException"
+  - "VCCORLIB/Platform::AccessDeniedException"
+  - "VCCORLIB/Platform::AccessDeniedException::AccessDeniedException"
 dev_langs: 
   - "C++"
 helpviewer_keywords: 

docs/cppcx/platform-agile-class.md

@@ -8,8 +8,7 @@ ms.reviewer: ""
 ms.suite: ""
 ms.tgt_pltfrm: ""
 ms.topic: "language-reference"
-f1_keywords: 
-  - "agile/Platform::Agile"
+f1_keywords: ['AGILE/Platform::Platform', 'AGILE/Platform::Platform::Agile::Agile', 'AGILE/Platform::Platform::Agile::Get', 'AGILE/Platform::Platform::Agile::GetAddressOf', 'AGILE/Platform::Platform::Agile::GetAddressOfForInOut', 'AGILE/Platform::Platform::Agile::Release']
 dev_langs: 
   - "C++"
 helpviewer_keywords: 
@@ -45,7 +44,7 @@ class Agile;
 
 |Name|Description|  
 |----------|-----------------|  
-|[Agile::Agile Constructor](#ctor)|Initializes a new instance of the Agile class.|  
+|[Agile::Agile](#ctor)|Initializes a new instance of the Agile class.|  
 |[Agile::~Agile Destructor](#dtor)|Destroys the current instance of the Agile class.|  
 
 ### Public Methods  
@@ -155,7 +154,7 @@ throw();
 ### Remarks  
  This operation releases the current representation of a object of type `T`, if any; reinitializes the Agile object's data members; acquires the current threading context; and then returns the address of a handle-to-object variable that can represent a non-agile object. To cause an Agile class instance to represent an object, use the assignment operator ([Agile::operator=](#operator-assign)) to assign the object to the Agile class instance.  
 
-## <a name="getaddressofforinput"></a>  Agile::GetAddressOfForInOut Method
+## <a name="getaddressofforinout"></a>  Agile::GetAddressOfForInOut Method
 Returns the address of a handle to the object represented by the current Agile object.  
 
 ## Syntax  

docs/cppcx/platform-array-class.md

@@ -8,8 +8,7 @@ ms.reviewer: ""
 ms.suite: ""
 ms.tgt_pltfrm: ""
 ms.topic: "language-reference"
-f1_keywords: 
-  - "vccorlib/Platform::Array"
+f1_keywords: ['VCCORLIB/Namespace not found::Platform', 'VCCORLIB/Namespace not found::Platform::Array Constructors', 'VCCORLIB/Namespace not found::Platform::Array::Value']
 dev_langs: 
   - "C++"
 helpviewer_keywords: 
@@ -48,7 +47,7 @@ private ref class Array<TArg, 1> :
   
 |||  
 |-|-|  
-|[Array::Value Property](#value)|Retrieves a handle to the current array.|  
+|[Array::Value](#value)|Retrieves a handle to the current array.|  
   
 ### Remarks  
  The Array class is sealed and cannot be inherited.  

docs/cppcx/platform-arrayreference-class.md

@@ -8,8 +8,7 @@ ms.reviewer: ""
 ms.suite: ""
 ms.tgt_pltfrm: ""
 ms.topic: "language-reference"
-f1_keywords: 
-  - "Platform/Platform::ArrayReference"
+f1_keywords: ['VCCORLIB/Platform::ArrayReference::ArrayReference']
 dev_langs: 
   - "C++"
 helpviewer_keywords: 
@@ -35,7 +34,7 @@ class ArrayReference
   
 |Name|Description|  
 |----------|-----------------|  
-|[ArrayReference::ArrayReference Constructor](#ctor)|Initializes a new instance of the `ArrayReference` class.|  
+|[ArrayReference::ArrayReference](#ctor)|Initializes a new instance of the `ArrayReference` class.|  
   
 ### Public Operators  
   

docs/cppcx/platform-boolean-value-class.md

@@ -9,7 +9,7 @@ ms.suite: ""
 ms.tgt_pltfrm: ""
 ms.topic: "language-reference"
 f1_keywords: 
-  - "Platform/Platform::Boolean"
+  - "VCCORLIB/Platform::Boolean"
 dev_langs: 
   - "C++"
 helpviewer_keywords: 

docs/cppcx/platform-box-class.md

@@ -9,7 +9,7 @@ ms.suite: ""
 ms.tgt_pltfrm: ""
 ms.topic: "language-reference"
 f1_keywords: 
-  - "Platform/Platform::Box"
+  - "VCCORLIB/Platform::Box"
 dev_langs: 
   - "C++"
 ms.assetid: b3d7ea37-e98a-4fbc-80b0-ad35e50250c6
@@ -34,7 +34,7 @@ ref class Box abstract;
  **Namespace:** Platform
 |Member|Description|  
 |------------|-----------------|
-|[Box Constructor](#ctor)|Creates a `Box` that can encapsulate a value of the specified type.|
+|[Box](#ctor)|Creates a `Box` that can encapsulate a value of the specified type.|
 |[operator Box&lt;const T&gt;^](#box-const-t)|Enables boxing conversions from a `const` value class `T` or `enum` class `T` to `Box<T>`.|
 |[operator Box&lt;const volatile T&gt;^](#box-const-volatile-t)|Enables boxing conversions from a `const volatile` value class `T` or `enum` type `T` to `Box<T>`. |
 |[operator Box&lt;T&gt;^](#box-t)|Enables boxing conversions from a value class `T` to `Box<T>`.|

docs/cppcx/platform-callbackcontext-enumeration.md

@@ -9,7 +9,7 @@ ms.suite: ""
 ms.tgt_pltfrm: ""
 ms.topic: "language-reference"
 f1_keywords: 
-  - "Platform/Platform::CallbackContext"
+  - "VCCORLIB/Platform::CallbackContext"
 dev_langs: 
   - "C++"
 helpviewer_keywords: