Merge branch 'master' into master

Author: hwisungi

.gitignore

@@ -13,3 +13,4 @@ _themes.VS.Modern/
 
 # Documentation build
 /docs/vcppdocs
+debug.log

.openpublishing.redirection.json

@@ -8377,12 +8377,12 @@
     },
     {
       "source_path": "docs/windows/editing-properties-for-an-activex-control.md",
-      "redirect_url": "/cpp/windows/viewing-and-adding-activex-controls-to-a-dialog-box",
+      "redirect_url": "/cpp/windows/adding-editing-or-deleting-controls",
       "redirect_document_id": false
     },
     {
       "source_path": "docs/windows/insert-activex-control-dialog-box.md",
-      "redirect_url": "/cpp/windows/viewing-and-adding-activex-controls-to-a-dialog-box",
+      "redirect_url": "/cpp/windows/adding-editing-or-deleting-controls",
       "redirect_document_id": false
     },
     {
@@ -8607,42 +8607,42 @@
     },
     {
       "source_path": "docs/windows/creating-a-new-toolbar-button.md",
-      "redirect_url": "/cpp/windows/creating-moving-and-editing-toolbar-buttons",
+      "redirect_url": "/cpp/windows/toolbar-editor",
       "redirect_document_id": false
     },
     {
       "source_path": "docs/windows/moving-a-toolbar-button.md",
-      "redirect_url": "/cpp/windows/creating-moving-and-editing-toolbar-buttons",
+      "redirect_url": "/cpp/windows/toolbar-editor",
       "redirect_document_id": false
     },
     {
       "source_path": "docs/windows/copying-buttons-from-a-toolbar.md",
-      "redirect_url": "/cpp/windows/creating-moving-and-editing-toolbar-buttons",
+      "redirect_url": "/cpp/windows/toolbar-editor",
       "redirect_document_id": false
     },
     {
       "source_path": "docs/windows/deleting-a-toolbar-button.md",
-      "redirect_url": "/cpp/windows/creating-moving-and-editing-toolbar-buttons",
+      "redirect_url": "/cpp/windows/toolbar-editor",
       "redirect_document_id": false
     },
     {
       "source_path": "docs/windows/inserting-a-space-between-buttons-on-a-toolbar.md",
-      "redirect_url": "/cpp/windows/creating-moving-and-editing-toolbar-buttons",
+      "redirect_url": "/cpp/windows/toolbar-editor",
       "redirect_document_id": false
     },
     {
       "source_path": "docs/windows/removing-space-between-buttons-on-a-toolbar.md",
-      "redirect_url": "/cpp/windows/creating-moving-and-editing-toolbar-buttons",
+      "redirect_url": "/cpp/windows/toolbar-editor",
       "redirect_document_id": false
     },
     {
       "source_path": "docs/windows/changing-the-properties-of-a-toolbar-button.md",
-      "redirect_url": "/cpp/windows/creating-moving-and-editing-toolbar-buttons",
+      "redirect_url": "/cpp/windows/toolbar-editor",
       "redirect_document_id": false
     },
     {
       "source_path": "docs/windows/toolbar-button-properties.md",
-      "redirect_url": "/cpp/windows/creating-moving-and-editing-toolbar-buttons",
+      "redirect_url": "/cpp/windows/toolbar-editor",
       "redirect_document_id": false
     },
     {
@@ -13419,6 +13419,16 @@
       "source_path": "docs/parallel/openmp/a-31-thread-safe-lock-functions.md",
       "redirect_url": "/cpp/parallel/openmp/a-examples#a31-thread-safe-lock-functions",
       "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/c-runtime-library/operator-delete-crt.md",
+      "redirect_url": "docs/c-runtime-library/delete-operator-crt",
+      "redirect_document_id": false
+    },
+    {
+      "source_path": "docs/c-runtime-library/operator-new-crt.md",
+      "redirect_url": "docs/c-runtime-library/new-operator-crt",
+      "redirect_document_id": false
     }
   ]
 }

docs/atl-mfc-shared/date-type.md

@@ -49,7 +49,7 @@ The following points should be noted when working with these date and time forma
 > [!CAUTION]
 > Note that because 6:00 AM is always represented by a fractional value 0.25 regardless of whether the integer representing the day is positive (after December 30, 1899) or negative (before December 30, 1899), a simple floating point comparison would erroneously sort any DATE representing 6:00 AM on a day earlier than 12/30/1899 as *later* than a DATE representing 7:00 AM on that same day.
 
-More information on issues related to the DATE and `COleDateTime` types can be found under [COleDateTime Class](../atl-mfc-shared/reference/coledatetime-class.md) and [Date and Time: Automation Support](../atl-mfc-shared/date-and-time-automation-support.md).
+More information on issues related to the DATE and `COleDateTime` types can be found under [COleDateTime Class](../atl-mfc-shared/reference/coledatetime-class.md) and [Date and Time: Automation Support](./date-and-time.md).
 
 ## See also
 

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

@@ -104,7 +104,7 @@ To determine if an attached bitmap is a DIB section, call [IsDibSection](#isdibs
 
 `CImage` cannot be selected into a new [CDC](../../mfc/reference/cdc-class.md). `CImage` creates its own HDC for the image. Because an HBITMAP can only be selected into one HDC at a time, the HBITMAP associated with the `CImage` cannot be selected into another HDC. If you need a CDC, retrieve the HDC from the `CImage` and give it to [CDC::FromHandle](../../mfc/reference/cdc-class.md#fromhandle).
 
-## Example
+## Examples
 
 ```cpp
 // Get a CDC for the image
@@ -117,8 +117,6 @@ m_myImage.ReleaseDC();
 
 When you use `CImage` in an MFC project, note which member functions in your project expect a pointer to a [CBitmap](../../mfc/reference/cbitmap-class.md) object. If you want to use `CImage` with such a function, like [CMenu::AppendMenu](../../mfc/reference/cmenu-class.md#appendmenu), use [CBitmap::FromHandle](../../mfc/reference/cbitmap-class.md#fromhandle), pass it your `CImage` HBITMAP, and use the returned `CBitmap*`.
 
-## Example
-
 ```cpp
 void CMyDlg::OnRButtonDown(UINT nFlags, CPoint point)
 {

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

@@ -84,7 +84,7 @@ The `DATE` type is implemented as a floating-point value. Days are measured from
 > [!CAUTION]
 > In the table above, although day values become negative before midnight on December 30, 1899, time-of-day values do not. For example, 6:00 AM is always represented by a fractional value 0.25 regardless of whether the integer representing the day is positive (after December 30, 1899) or negative (before December 30, 1899). This means that a simple floating point comparison would erroneously sort a `COleDateTime` representing 6:00 AM on 12/29/1899 as **later** than one representing 7:00 AM on the same day.
 
-The `COleDateTime` class handles dates from January 1, 100, through December 31, 9999. The `COleDateTime` class uses the Gregorian calendar; it does not support Julian dates. `COleDateTime` ignores Daylight Saving Time. (See [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).)
+The `COleDateTime` class handles dates from January 1, 100, through December 31, 9999. The `COleDateTime` class uses the Gregorian calendar; it does not support Julian dates. `COleDateTime` ignores Daylight Saving Time. (See [Date and Time: Automation Support](../date-and-time.md).)
 
 > [!NOTE]
 > You can use the `%y` format to retrieve a two-digit year only for dates starting at 1900. If you use the `%y` format on a date before 1900, the code generates an ASSERT failure.
@@ -99,7 +99,7 @@ To avoid problems, specify a four-digit date. For example:
 
 Basic arithmetic operations for the `COleDateTime` values use the companion class [COleDateTimeSpan](../../atl-mfc-shared/reference/coledatetimespan-class.md). `COleDateTimeSpan` values define a time interval. The relationship between these classes is similar to the one between [CTime](../../atl-mfc-shared/reference/ctime-class.md) and [CTimeSpan](../../atl-mfc-shared/reference/ctimespan-class.md).
 
-For more information about the `COleDateTime` and `COleDateTimeSpan` classes, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the `COleDateTime` and `COleDateTimeSpan` classes, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ## Requirements
 
@@ -231,7 +231,7 @@ For more information on the `time_t` data type, see the [time](../../c-runtime-l
 
 For more information, see the [SYSTEMTIME](/windows/win32/api/minwinbase/ns-minwinbase-systemtime) and [FILETIME](/windows/win32/api/minwinbase/ns-minwinbase-filetime) structures in the Windows SDK.
 
-For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 > [!NOTE]
 > The constructor using `DBTIMESTAMP` parameter is only available when OLEDB.h is included.
@@ -617,7 +617,7 @@ Valid return values range between 0 and 59.
 > [!NOTE]
 > The `COleDateTime` class does not support leap seconds.
 
-For more information about the implementation for `COleDateTime`, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the implementation for `COleDateTime`, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 For information on other member functions that query the value of this `COleDateTime` object, see the following member functions:
 
@@ -699,7 +699,7 @@ For more information about the operations that may set the status to invalid, se
 
 - [operator +=, -=](#operator_add_eq_-_eq)
 
-For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ### Example
 
@@ -737,7 +737,7 @@ For information on other member functions that query the value of this `COleDate
 
 - [GetDayOfYear](#getdayofyear)
 
-For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ### Example
 
@@ -756,7 +756,7 @@ DATE m_dt;
 > [!CAUTION]
 > Changing the value in the `DATE` object accessed by the pointer returned by this function will change the value of this `COleDateTime` object. It does not change the status of this `COleDateTime` object.
 
-For more information about the implementation of the `DATE` object, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the implementation of the `DATE` object, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ## <a name="m_status"></a> COleDateTime::m_status
 
@@ -811,7 +811,7 @@ For more information on the `time_t` data type, see the [time](../../c-runtime-l
 
 For more information, see the [SYSTEMTIME](/windows/win32/api/minwinbase/ns-minwinbase-systemtime) and [FILETIME](/windows/win32/api/minwinbase/ns-minwinbase-filetime) structures in the Windows SDK.
 
-For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ## <a name="operator_add_-"></a> COleDateTime::operator +, -
 
@@ -837,7 +837,7 @@ The **+** and **-** operators will assert if the `COleDateTime` object is set to
 
 For more information on the valid, invalid, and null status values, see the [m_status](#m_status) member variable.
 
-For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ### Example
 
@@ -864,7 +864,7 @@ For more information on the valid, invalid, and null status values, see the [m_s
 
 The **+=** and **-=** operators will assert if the `COleDateTime` object is set to null. See [COleDateTime Relational Operators](#coledatetime_relational_operators) for an example.
 
-For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ## <a name="operator_date"></a> COleDateTime::operator DATE
 
@@ -876,7 +876,7 @@ operator DATE() const throw();
 
 ### Remarks
 
-This operator returns a `DATE` object whose value is copied from this `COleDateTime` object. For more information about the implementation of the `DATE` object, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+This operator returns a `DATE` object whose value is copied from this `COleDateTime` object. For more information about the implementation of the `DATE` object, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 The `DATE` operator will assert if the `COleDateTime` object is set to null. See [COleDateTime Relational Operators](#coledatetime_relational_operators) for an example.
 
@@ -939,7 +939,7 @@ In the case of VAR_DATEVALUEONLY, the time value is set to time 0, or midnight.
 
 If the string could not be converted to a date/time value or if there was a numerical overflow, the status of this `COleDateTime` object is invalid.
 
-For more information about the bounds and implementation for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds and implementation for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ## <a name="setdate"></a> COleDateTime::SetDate
 
@@ -1012,7 +1012,7 @@ For information on member functions that query the value of this `COleDateTime`
 
 - [GetDayOfYear](#getdayofyear)
 
-For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ### Example
 
@@ -1096,7 +1096,7 @@ For information on member functions that query the value of this `COleDateTime`
 
 - [GetDayOfYear](#getdayofyear)
 
-For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ### Example
 
@@ -1189,7 +1189,7 @@ For information on member functions that query the value of this `COleDateTime`
 
 - [GetDayOfYear](#getdayofyear)
 
-For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTime` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ### Example
 

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

@@ -65,7 +65,7 @@ A `COleDateTimeSpan` keeps time in days.
 
 `COleDateTimeSpan` is used with its companion class [COleDateTime](../../atl-mfc-shared/reference/coledatetime-class.md). `COleDateTime` encapsulates the `DATE` data type of OLE automation. `COleDateTime` represents absolute time values. All `COleDateTime` calculations involve `COleDateTimeSpan` values. The relation between these classes is analogous to the one between [CTime](../../atl-mfc-shared/reference/ctime-class.md) and [CTimeSpan](../../atl-mfc-shared/reference/ctimespan-class.md).
 
-For more information on the `COleDateTime` and `COleDateTimeSpan` classes, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information on the `COleDateTime` and `COleDateTimeSpan` classes, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ## Requirements
 
@@ -134,7 +134,7 @@ All of these constructors create new `COleDateTimeSpan` objects initialized to t
 
 The status of the new `COleDateTimeSpan` object is set to valid.
 
-For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ### Example
 
@@ -375,7 +375,7 @@ The status of a `COleDateTimeSpan` object is invalid in the following cases:
 
 For more information about the operations that may set the status to invalid, see [COleDateTimeSpan::operator +, -](../../atl-mfc-shared/reference/coledatetime-class.md#operator_add_-) and [COleDateTimeSpan::operator +=, -=](../../atl-mfc-shared/reference/coledatetime-class.md#operator_add_eq_-_eq).
 
-For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ## <a name="gettotaldays"></a> COleDateTimeSpan::GetTotalDays
 
@@ -575,7 +575,7 @@ For more information about the operations that may set the status to invalid, se
 > [!CAUTION]
 > This data member is for advanced programming situations. You should use the inline member functions [GetStatus](#getstatus) and [SetStatus](#setstatus). See `SetStatus` for further cautions regarding explicitly setting this data member.
 
-For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../../atl-mfc-shared/date-and-time-automation-support.md).
+For more information about the bounds for `COleDateTimeSpan` values, see the article [Date and Time: Automation Support](../date-and-time.md).
 
 ## <a name="operator_eq"></a> COleDateTimeSpan::operator =
 

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

@@ -284,15 +284,15 @@ Specifies the bottom-right position of `CRect`.
 
 ### Remarks
 
-If no arguments are given, `left`, `top`, `right`, and `bottom` members are not initialized.
+If no arguments are given, `left`, `top`, `right`, and `bottom` members are set to 0.
 
 The `CRect`(`const RECT&`) and `CRect`(`LPCRECT`) constructors perform a [CopyRect](#copyrect). The other constructors initialize the member variables of the object directly.
 
 ### Example
 
 ```cpp
-// default constructor doesn't initialize!
-CRect rectUnknown;
+// default constructor is equivalent to CRect(0, 0, 0, 0)
+CRect emptyRect;
 
 // four-integers are left, top, right, and bottom
 CRect rect(0, 0, 100, 50);