Merge pull request #233 from Microsoft/master

MFC and misc formatting fixes

Author: ghogen

docs/atl-mfc-shared/reference/coledatetime-class.md

@@ -625,19 +625,15 @@ DateTimeStatus GetStatus() const throw();
 ### Remarks  
  The return value is defined by the **DateTimeStatus** enumerated type, which is defined within the `COleDateTime` class.  
 
- `enum DateTimeStatus`  
-  
- `{`  
-  
- `error = -1,`  
-  
- `valid = 0,`  
-  
- `invalid = 1,    // Invalid date (out of range, etc.)`  
-  
- `null = 2,       // Literally has no value`  
-  
- `};`  
+```  
+enum DateTimeStatus  
+{  
+   error = -1,  
+   valid = 0,  
+   invalid = 1,    // Invalid date (out of range, etc.)  
+   null = 2,       // Literally has no value  
+};  
+```  
 
  For a brief description of these status values, see the following list:  
 
@@ -884,9 +880,7 @@ bool ParseDateTime(
 
  `"8:30:00 Jan. 25, 1996"`  
 
- `"1/25/1996 8:30:00"  // always specify the full year,`  
-  
- `// even in a 'short date' format`  
+ `"1/25/1996 8:30:00"  // always specify the full year, even in a 'short date' format`  
 
  Note that the locale ID will also affect whether the string format is acceptable for conversion to a date/time value.  
 

docs/atl-mfc-shared/reference/coledatetimespan-class.md

@@ -347,15 +347,13 @@ DateTimeSpanStatus GetStatus() const throw();
 ### Remarks  
  The return value is defined by the **DateTimeSpanStatus** enumerated type, which is defined within the `COleDateTimeSpan` class.  
 
- `enum DateTimeSpanStatus{`  
-  
- `valid = 0,`  
-  
- `invalid = 1,`  
-  
- `null = 2,`  
-  
- `};`  
+```  
+enum DateTimeSpanStatus{  
+   valid = 0,  
+   invalid = 1,  
+   null = 2,  
+};  
+```  
 
  For a brief description of these status values, see the following list:  
 
@@ -526,15 +524,14 @@ DateTimeSpanStatus m_status;
 ```  
 
 ### Remarks  
- `enum DateTimeSpanStatus{`  
-  
- `valid = 0,`  
-  
- `invalid = 1,`  
-  
- `null = 2,`  
 
- `};`  
+```  
+enum DateTimeSpanStatus{  
+   valid = 0,  
+   invalid = 1,  
+   null = 2,  
+   };  
+```  
 
  For a brief description of these status values, see the following list:  
 
@@ -665,15 +662,13 @@ void SetStatus(DateTimeSpanStatus status) throw();
 ### Remarks  
  The *Status* parameter value is defined by the **DateTimeSpanStatus** enumerated type, which is defined within the `COleDateTimeSpan` class.  
 
- `enum DateTimeSpanStatus{`  
-  
- `valid = 0,`  
-  
- `invalid = 1,`  
-  
- `null = 2,`  
-  
- `};`  
+```  
+enum DateTimeSpanStatus{  
+   valid = 0,  
+   invalid = 1,  
+   null = 2,  
+   };  
+```  
 
  For a brief description of these status values, see the following list:  
 

docs/atl/reference/atl-ole-db-provider-wizard.md

@@ -55,31 +55,31 @@ This wizard creates the classes that compose an OLE DB provider.
  If you select this option when you created a non-attributed project, the wizard warns you that the project will be converted to an attributed project and asks you whether to continue or not.  
 
  **ProgID**  
- The ProgID, or programmatic identifier, is a text string that your application can use instead of a GUID. The ProgID name has the form *Projectname*.*Coclassname*.  
+ The ProgID, or programmatic identifier, is a text string that your application can use instead of a GUID. The ProgID name has the form *Projectname.Coclassname*.  
 
  **Version**  
  The version number of your provider. The default is 1.  
 
  **DataSource class**  
- The name of the data source class, of the form C`Shortname`Source.  
+ The name of the data source class, of the form C*Shortname*Source.  
 
  **DataSource .h file**  
  The header file for the data source class. You can edit this file's name or select an existing header file.  
 
  **Session class**  
- The name of the session class, of the form C`Shortname`Session.  
+ The name of the session class, of the form C*Shortname*Session.  
 
  **Session .h file**  
  The header file for the session class. You can edit this file's name or select an existing header file.  
 
  **Command class**  
- The name of the command class, of the form C`Shortname`Command.  
+ The name of the command class, of the form C*Shortname*Command.  
 
  **Command .h file**  
  The header file for the command class. This name cannot be edited and depends on the name of the rowset header file.  
 
  **Rowset class**  
- The name of the rowset class, of the form C`Shortname`Rowset.  
+ The name of the rowset class, of the form C*Shortname*Rowset.  
 
  **Rowset .h file**  
  The header file for the rowset class. You can edit this file's name or select an existing header file.  

docs/atl/reference/cbindstatuscallback-class.md

@@ -249,15 +249,13 @@ ATL_PDATAAVAILABLE m_pFunc;
 ### Remarks  
  The function pointed to by `m_pFunc` is a member of your object's class and has the following syntax:  
 
- `void Function_Name(`  
-  
- `CBindStatusCallback<T>* pbsc,`  
-  
- `BYTE* pBytes,`  
-  
- `DWORD dwSize`  
-  
- `);`  
+```  
+void Function_Name(  
+   CBindStatusCallback<T>* pbsc,  
+   BYTE* pBytes,  
+   DWORD dwSize  
+   );  
+```  
 
 ##  <a name="m_pt"></a>  CBindStatusCallback::m_pT  
  A pointer to the object requesting the asynchronous data transfer.  

docs/atl/reference/ccomenumimpl-class.md

@@ -154,17 +154,14 @@ HRESULT Init(
 
  The `flags` parameter allows you to specify how the enumerator should treat the array elements passed to it. `flags` can take one of the values from the **CComEnumFlags** enumeration shown below:  
 
- `enum CComEnumFlags`  
-  
- `{`  
-  
- `AtlFlagNoCopy = 0,`  
-  
- `AtlFlagTakeOwnership = 2, // BitOwn`  
-  
- `AtlFlagCopy = 3           // BitOwn | BitCopy`  
-  
- `};`  
+```  
+enum CComEnumFlags  
+   {  
+   AtlFlagNoCopy = 0,  
+   AtlFlagTakeOwnership = 2, // BitOwn  
+   AtlFlagCopy = 3           // BitOwn | BitCopy  
+   };  
+```  
 
  **AtlFlagNoCopy** means that the array's lifetime is not controlled by the enumerator. In this case, either the array will be static or the object identified by *pUnk* will be responsible for freeing the array when it's no longer needed.  
 

docs/atl/reference/ccomsafearray-class.md

@@ -455,7 +455,7 @@ HRESULT MultiDimGetAt(const LONG* alIndex, T& t);
 
 ### Parameters  
  `alIndex`  
- Pointer to a vector of indexes for each dimension in the array. The leftmost (most significant) dimension is `alIndex`[0] *.*  
+ Pointer to a vector of indexes for each dimension in the array. The leftmost (most significant) dimension is `alIndex[0]`.  
 
  *t*  
  A reference to the data returned.  

docs/atl/reference/composite-control-global-functions.md

@@ -91,9 +91,10 @@ ATLAPI_(int) AtlAxDialogBox(
 ### Remarks  
  To use **AtlAxDialogBox** with a dialog template that contains an ActiveX control, specify a valid **CLSID**, **APPID** or URL string as the *text* field of the **CONTROL** section of the dialog resource, along with "AtlAxWin80" as the *class name* field under the same section. The following demonstrates what a valid **CONTROL** section might look like:  
 
- `CONTROL    "{04FE35E9-ADBC-4f1d-83FE-8FA4D1F71C7F}", IDC_TEST,`  
-  
- `"AtlAxWin80", WS_GROUP | WS_TABSTOP, 0, 0, 100, 100`  
+```  
+CONTROL    "{04FE35E9-ADBC-4f1d-83FE-8FA4D1F71C7F}", IDC_TEST,  
+    "AtlAxWin80", WS_GROUP | WS_TABSTOP, 0, 0, 100, 100  
+```  
 
  For more information on editing resource scripts, see [How to: Open a Resource Script File in Text Format](../../windows/how-to-open-a-resource-script-file-in-text-format.md). For more information on control resource-definition statements, see [Common Control Parameters](http://msdn.microsoft.com/library/windows/desktop/aa380902) under [!INCLUDE[winSDK](../../atl/includes/winsdk_md.md)]*: SDK Tools*.  
 

docs/atl/reference/csecuritydesc-class.md

@@ -473,7 +473,7 @@ bool SetControl(
  `ControlBitsOfInterest`  
  A **SECURITY_DESCRIPTOR_CONTROL** mask that indicates the control bits to set. For a list of the flags which can be set, see [SetSecurityDescriptorControl](http://msdn.microsoft.com/library/windows/desktop/aa379582\(v=vs.85\).aspx).  
 
- `ControlBitsToSe`t  
+ `ControlBitsToSet`  
  A `SECURITY_DESCRIPTOR_CONTROL` mask that indicates the new values for the control bits specified by the `ControlBitsOfInterest` mask. This parameter can be a combination of the flags listed for the `ControlBitsOfInterest` parameter.  
 
 ### Return Value  

docs/atl/reference/security-global-functions.md

@@ -82,10 +82,8 @@ inline bool AtlGetDacl(
  Returns true on success, false on failure.  
 
 ### Remarks  
- In debug builds, an assertion error will occur if either `hObject` or `pDacl` is invalid *.*  
-
-v
-
+ In debug builds, an assertion error will occur if either `hObject` or `pDacl` is invalid.  
+  
 ##  <a name="atlsetdacl"></a>  AtlSetDacl  
  Call this function to set the discretionary access-control list (DACL) information of a specified object.