github issues fixes

Tyler Whitney · Tyler Whitney · commit 03201642444e · 2020-06-24T16:19:18.000-07:00
diff --git a/docs/c-runtime-library/reference/strtod-strtod-l-wcstod-wcstod-l.md b/docs/c-runtime-library/reference/strtod-strtod-l-wcstod-wcstod-l.md
@@ -49,9 +49,13 @@ The locale to use.
 
 ## Return Value
 
-**strtod** returns the value of the floating-point number, except when the representation would cause an overflow, in which case the function returns +/-**HUGE_VAL**. The sign of **HUGE_VAL** matches the sign of the value that cannot be represented. **strtod** returns 0 if no conversion can be performed or an underflow occurs.
+**strtod** returns the value of the floating-point number, except when the representation would cause an overflow, in which case the function returns +/-**HUGE_VAL**. The sign of **HUGE_VAL** matches the sign of the value that cannot be represented. **strtod** returns `0` if no conversion can be performed or an underflow occurs.
 
-**wcstod** returns values analogously to **strtod**. For both functions, **errno** is set to **ERANGE** if overflow or underflow occurs and the invalid parameter handler is invoked, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md). See [_doserrno, errno, _sys_errlist, and _sys_nerr](../../c-runtime-library/errno-doserrno-sys-errlist-and-sys-nerr.md) for more information on this and other return codes.
+**wcstod** returns values analogously to **strtod**:
+- For both functions, **errno** is set to **ERANGE** if overflow or underflow occurs.
+- If there are invalid parameters, **errno** is set to **EINVAL** and the invalid parameter handler is invoked, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md).
+
+See [_doserrno, errno, _sys_errlist, and _sys_nerr](../../c-runtime-library/errno-doserrno-sys-errlist-and-sys-nerr.md) for more information on this and other return codes.
 
 ## Remarks
 
diff --git a/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md b/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md
@@ -1,6 +1,6 @@
 ---
 title: "strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l"
-ms.date: "4/2/2020"
+ms.date: "6/24/2020"
 api_name: ["_mbstok_l", "_mbstok", "wcstok", "_mbstok", "strtok", "_wcstok_l", "_o__mbstok", "_o__mbstok_l", "_o_strtok", "_o_wcstok"]
 api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-multibyte-l1-1-0.dll", "api-ms-win-crt-string-l1-1-0.dll", "api-ms-win-crt-private-l1-1-0.dll"]
 api_type: ["DLLExport"]
@@ -32,6 +32,11 @@ wchar_t *wcstok(
    wchar_t *strToken,
    const wchar_t *strDelimit
 );
+wchar_t *wcstok(
+   wchar_t *strToken,
+   const wchar_t *strDelimit,
+   wchar_t **context
+);
 wchar_t *wcstok_l(
    wchar_t *strToken,
    const wchar_t *strDelimit,
@@ -59,6 +64,9 @@ Set of delimiter characters.
 *locale*<br/>
 Locale to use.
 
+*context*<br/>
+Points to memory used to store the internal state of the parser so that the parser can continue from where it left off during subsequent calls.
+
 ## Return Value
 
 Returns a pointer to the next token found in *strToken*. The functions return **NULL** when no more tokens are found. Each call modifies *strToken* by substituting a null character for the first delimiter that occurs after the returned token.
@@ -67,6 +75,8 @@ Returns a pointer to the next token found in *strToken*. The functions return **
 
 The **strtok** function finds the next token in *strToken*. The set of characters in *strDelimit* specifies possible delimiters of the token to be found in *strToken* on the current call. **wcstok** and **_mbstok** are wide-character and multibyte-character versions of **strtok**. The arguments and return value of **wcstok** are wide-character strings; those of **_mbstok** are multibyte-character strings. These three functions behave identically otherwise.
 
+The two argument version of **wcstok** is not standard. If you need to use that version, you'll need to define `_CRT_NON_CONFORMING_WCSTOK` before you `#include <wchar.h>` (or `#include <string.h>`).
+
 > [!IMPORTANT]
 > These functions incur a potential threat brought about by a buffer overrun problem. Buffer overrun problems are a frequent method of system attack, resulting in an unwarranted elevation of privilege. For more information, see [Avoiding Buffer Overruns](/windows/win32/SecBP/avoiding-buffer-overruns).
 
@@ -94,6 +104,7 @@ By default, this function's global state is scoped to the application. To change
 |-------------|---------------------|
 |**strtok**|\<string.h>|
 |**wcstok**|\<string.h> or \<wchar.h>|
+|**_wcstok_l**|<tchar.h>|
 |**_mbstok**, **_mbstok_l**|\<mbstring.h>|
 
 For additional compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
diff --git a/docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md b/docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md
@@ -1,6 +1,6 @@
 ---
 title: "vsnprintf, _vsnprintf, _vsnprintf_l, _vsnwprintf, _vsnwprintf_l"
-ms.date: "11/04/2016"
+ms.date: "06/24/2020"
 api_name: ["_vsnprintf", "_vsnprintf_l", "_vsnwprintf", "_vsnwprintf_l", "_vsnprintf", "_vsnprintf;", "vsnprintf; _vsnprintf", "_vsnwprintf;", "_vsnprintf_l;", "_vsnwprintf_l;"]
 api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ntoskrnl.exe", "ucrtbase.dll"]
 api_type: ["DLLExport"]
@@ -112,9 +112,11 @@ The **vsnprintf** function returns the number of characters written, not countin
 
 Both **_vsnprintf** and **_vsnwprintf** functions return the number of characters written if the number of characters to write is less than or equal to *count*; if the number of characters to write is greater than *count*, these functions return -1 indicating that output has been truncated.
 
-The value returned by all these functions does not include the terminating null, whether one is written or not. When *count* is zero, the value returned is the number of characters the functions would write, not including any terminating null. You can use this result to allocate sufficient buffer space for the string and its terminating null, and then call the function again to fill the buffer.
+The value returned by all these functions does not include the terminating null, whether one is written or not.
 
-If *format* is **NULL**, or if *buffer* is **NULL** and *count* is not equal to zero, these functions invoke the invalid parameter handler, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md). If execution is allowed to continue, these functions return -1 and set **errno** to **EINVAL**.
+- If *count* is zero and *buffer* is **NULL**, the value returned is the number of characters the functions would write, not including any terminating null. You can use this result to allocate sufficient buffer space for the string and its terminating null, and then call the function again to fill the buffer.
+- If *count* is zero but *buffer* is not **NULL**, nothing is written and the function returns `-1`.
+- If *format* is **NULL**, or if *buffer* is **NULL** and *count* is not equal to zero, these functions invoke the invalid parameter handler, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md). If execution is allowed to continue, these functions return -1 and set **errno** to **EINVAL**.
 
 ## Remarks
 
diff --git a/docs/mfc/reference/cmdiframewndex-class.md b/docs/mfc/reference/cmdiframewndex-class.md
@@ -767,13 +767,13 @@ DWORD GetMDITabsContextMenuAllowedItems();
 
 A bitwise-OR combination of the following flags:
 
-- BCGP_MDI_CREATE_VERT_GROUP - can create a vertical tab group.
+- AFX_MDI_CREATE_VERT_GROUP - can create a vertical tab group.
 
-- BCGP_MDI_CREATE_HORZ_GROUP - can create a horizontal tab group.
+- AFX_MDI_CREATE_HORZ_GROUP - can create a horizontal tab group.
 
-- BCGP_MDI_CAN_MOVE_PREV - can move a tab to the previous tab group.
+- AFX_MDI_CAN_MOVE_PREV - can move a tab to the previous tab group.
 
-- BCGP_MDI_CAN_MOVE_NEXT - can move a tab to the next tab group.
+- AFX_MDI_CAN_MOVE_NEXT - can move a tab to the next tab group.
 
 ### Remarks
 
@@ -1058,7 +1058,7 @@ To load or save the state of MDI tabs and groups and the list of opened document
 
 - Call [CMDIFrameWndEx::SaveMDIState](#savemdistate) when the main frame is being closed
 
-- Call [CMDIFrameWndEx::LoadMDIState](#loadmdistate) when the main frame is being created. The recommended place for this call is before the main frame is displayed for the first time. Add `CWinAppEx::EnableLoadWindowPlacement` `(FALSE);` before `pMainFrame->LoadFrame (IDR_MAINFRAME);.` Add `CBCGPWorkspace::ReloadWindowPlacement` `(pMainFrame);` after the call to `LoadMDIState` to display the main frame at the position that was stored in the registry.
+- Call [CMDIFrameWndEx::LoadMDIState](#loadmdistate) when the main frame is being created. The recommended place for this call is before the main frame is displayed for the first time. Add `CWinAppEx::EnableLoadWindowPlacement` `(FALSE);` before `pMainFrame->LoadFrame (IDR_MAINFRAME);.` Add `CWinAppEx::ReloadWindowPlacement` `(pMainFrame);` after the call to `LoadMDIState` to display the main frame at the position that was stored in the registry.
 
 - Override `GetDocumentName` in the `CMDIChildWndEx`- derived class if your application displays documents that are not stored as files. The returned string will be saved in the registry as the document identifier. The base implementation of [CMDIChildWndEx::GetDocumentName](../../mfc/reference/cmdichildwndex-class.md#getdocumentname) returns a value obtained from [CDocument::GetPathName](../../mfc/reference/cdocument-class.md#getpathname).
 
@@ -1440,22 +1440,22 @@ virtual BOOL OnShowMDITabContextMenu(
 *dwAllowedItems*<br/>
 [in] A bitwise-OR combination of flags that indicates what actions are allowed for the current tab:
 
-- BCGP_MDI_CREATE_VERT_GROUP - can create a vertical tab group.
+- AFX_MDI_CREATE_VERT_GROUP - can create a vertical tab group.
 
-- BCGP_MDI_CREATE_HORZ_GROUP - can create a horizontal tab group.
+- AFX_MDI_CREATE_HORZ_GROUP - can create a horizontal tab group.
 
-- BCGP_MDI_CAN_MOVE_PREV - can move a tab to the previous tab group.
+- AFX_MDI_CAN_MOVE_PREV - can move a tab to the previous tab group.
 
-- BCGP_MDI_CAN_MOVE_NEXT - can move a tab to the next tab group.
+- AFX_MDI_CAN_MOVE_NEXT - can move a tab to the next tab group.
 
-- BCGP_MDI_CAN_BE_DOCKED - switch a tabbed document to docked state (relevant for tabbed documents only).
+- AFX_MDI_CAN_BE_DOCKED - switch a tabbed document to docked state (relevant for tabbed documents only).
 
 *bTabDrop*<br/>
 [in] TRUE to display the menu as a result of dragging the tab onto another tabbed group. FALSE to display the menu as a shortcut menu on the currently active tab.
 
 ### Return Value
 
-Override this method in a [CBCGPMDIFrameWnd](../../mfc/reference/cmdiframewndex-class.md)-derived class.
+Override this method in a [CMDIFrameWndEx](../../mfc/reference/cmdiframewndex-class.md)-derived class.
 
 ### Remarks
 
diff --git a/docs/mfc/reference/cmultidoctemplate-class.md b/docs/mfc/reference/cmultidoctemplate-class.md
@@ -17,6 +17,8 @@ class CMultiDocTemplate : public CDocTemplate
 
 ## Members
 
+Note: The member functions for this class are virtual. See [CDocTemplate](../../mfc/reference/cdoctemplate-class.md) and [CCmdTarget](../../mfc/reference/ccmdtarget-class.md) for documentation.
+
 ### Public Constructors
 
 |Name|Description|
diff --git a/docs/safeint/safeint-class.md b/docs/safeint/safeint-class.md
@@ -11,7 +11,7 @@ ms.assetid: 27a8f087-2511-46f9-8d76-2aeb66ca272f
 Extends the integer primitives to help prevent integer overflow and lets you compare different types of integers.
 
 > [!NOTE]
-> The latest version of this library is located at [https://github.com/dcleblanc/SafeInt](https://github.com/dcleblanc/SafeInt).
+> The latest version of the SafeInt library is located at [https://github.com/dcleblanc/SafeInt](https://github.com/dcleblanc/SafeInt). To use the SafeInt library, clone the repo and `#include "SafeInt.hpp"`
 
 ## Syntax
 
@@ -214,7 +214,10 @@ There are two options to customize the error policy. The first option is to set
 
 ## Requirements
 
-**Header:** safeint.h
+**Header:** SafeInt.hpp
+> [!NOTE]
+> The latest version of this library is located at [https://github.com/dcleblanc/SafeInt](https://github.com/dcleblanc/SafeInt). Clone the library and include SafeInt.hpp to use the SafeInt library.
+> Prefer this github repo to <safeint.h>. It is a modern version of <safeint.h> that includes a small number of bug fixes, uses modern features of C++ resulting in more efficient code, and is portable to any platform using gcc, clang, or Intel compilers.
 
 **Namespace:** msl::utilities
 
@@ -225,39 +228,47 @@ Constructs a `SafeInt` object.
 ```cpp
 SafeInt() throw
 
-SafeInt (
-   const T& i
-) throw ()
+SafeInt (const T& i) throw ()
 
-SafeInt (
-   bool b
-) throw ()
+SafeInt (bool b) throw ()
 
 template <typename U>
-SafeInt (
-   const SafeInt <U, E>& u
-)
+SafeInt (const SafeInt <U, E>& u)
 
 I template <typename U>
-SafeInt (
-   const U& i
-)
+SafeInt (const U& i)
 ```
 
 ### Parameters
 
-*i*<br/>
+`i`<br/>
 [in] The value for the new `SafeInt` object. This must be a parameter of type T or U, depending on the constructor.
 
-*b*<br/>
+`b`<br/>
 [in] The Boolean value for the new `SafeInt` object.
 
-*u*<br/>
+`u`<br/>
 [in] A `SafeInt` of type U. The new `SafeInt` object will have the same value as *u*, but will be of type T.
 
-U
+`U`
 The type of data stored in the `SafeInt`. This can be either a Boolean, character, or integer type. If it is an integer type, it can be signed or unsigned and be between 8 and 64 bits.
 
+### Example
+
+```c
+#include "SafeInt.hpp" // set path to your clone of the SafeInt GitHub repo (https://github.com/dcleblanc/SafeInt)
+
+int main()
+{
+    int divisor = 3;
+    int dividend = 6;
+    int result;
+
+    bool success = SafeDivide(dividend, divisor, result); // result = 2
+    success = SafeDivide(dividend, 0, result); // expect fail. result is not modified.
+}
+```
+
 ### Remarks
 
 The input parameter for the constructor, *i* or *u*, must be a Boolean, character, or integer type. If it is another type of parameter, the `SafeInt` class calls [static_assert](../cpp/static-assert.md) to indicate an invalid input parameter.
diff --git a/docs/standard-library/error-category-class.md b/docs/standard-library/error-category-class.md
@@ -61,7 +61,7 @@ virtual error_condition default_error_condition(int _Errval) const;
 
 ### Parameters
 
-*_Errval*\
+`_Errval`\
 The error code value to store in the [error_condition](../standard-library/error-condition-class.md).
 
 ### Return Value
@@ -124,7 +124,7 @@ The error code value to describe.
 
 #### Return Value
 
-Returns a descriptive name of the error code *val* for the category.
+Returns a descriptive name of the error code *val* for the category. If the error code is unrecognized, returns `"unknown error"`.
 
 #### Remarks
 
