Skip to content

Commit 1abb9cf

Browse files
authored
Merge pull request #3157 from MicrosoftDocs/master
10/26 AM Publish
2 parents 12d6398 + 09a4af4 commit 1abb9cf

File tree

35 files changed

+118
-106
lines changed

35 files changed

+118
-106
lines changed

docs/code-quality/ca1720-identifiers-should-not-contain-type-names.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@ In addition, the names of a parameter are also checked against the following lan
132132
Replace the language-specific data type identifier in the name of the member with a term that better describes its meaning, a language-independent equivalent, or a more generic term, such as 'value'.
133133

134134
## When to suppress warnings
135-
Occasional use of type-based parameter and member names might be appropriate. However, for new development, no known scenarios occur where you should suppress a warning from this rule. For libraries that have previous shipped, you might have to suppress a warning from this rule.
135+
Occasional use of type-based parameter and member names might be appropriate. However, for new development, no known scenarios occur where you should suppress a warning from this rule. For libraries that have previously shipped, you might have to suppress a warning from this rule.
136136

137137
## Related rules
138138
[CA1709: Identifiers should be cased correctly](../code-quality/ca1709-identifiers-should-be-cased-correctly.md)
@@ -141,4 +141,4 @@ In addition, the names of a parameter are also checked against the following lan
141141

142142
[CA1707: Identifiers should not contain underscores](../code-quality/ca1707-identifiers-should-not-contain-underscores.md)
143143

144-
[CA1719: Parameter names should not match member names](../code-quality/ca1719-parameter-names-should-not-match-member-names.md)
144+
[CA1719: Parameter names should not match member names](../code-quality/ca1719-parameter-names-should-not-match-member-names.md)

docs/code-quality/cpp-core-guidelines-warnings.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -122,10 +122,10 @@ These macros correspond to the rule sets and expand into a space-separated lists
122122
The Microsoft Visual C++ compiler has a limited support for the GSL suppress attribute. It can be used to suppress warnings on expression and block statements inside of a function.
123123

124124
```cpp
125-
// Supress only warnings from the 'r.11' rule in expression.
125+
// Suppress only warnings from the 'r.11' rule in expression.
126126
[[gsl::suppress(r.11)]] new int;
127127

128-
// Supress all warnings from the 'r' rule group (resource management) in block.
128+
// Suppress all warnings from the 'r' rule group (resource management) in block.
129129
[[gsl::suppress(r)]]
130130
{
131131
new int;

docs/code-quality/how-to-enable-and-disable-automatic-code-analysis-for-managed-code.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: "How to: Enable and Disable Automatic Code Analysis for Managed Code"
3-
ms.date: 09/28/2018
2+
title: Enable or disable code analysis
3+
ms.date: 10/25/2018
44
ms.prod: visual-studio-dev15
55
ms.technology: vs-ide-code-analysis
66
ms.topic: conceptual
@@ -12,14 +12,19 @@ ms.workload:
1212
---
1313
# How to: Enable and disable automatic code analysis for managed code
1414

15-
You can configure code analysis to run after each build of a managed code project. You can set different code analysis properties for each build configuration, for example, debug and release.
15+
You can configure (static) code analysis to run after each build of a managed code project. You can set different code analysis properties for each build configuration, for example, debug and release.
16+
17+
This article applies only to static code analysis and not live code analysis using [Roslyn code analyzers](roslyn-analyzers-overview.md).
1618

1719
## To enable or disable automatic code analysis
1820

1921
1. In **Solution Explorer**, right-click the project, and then choose **Properties**.
2022

2123
1. In the properties dialog box for the project, choose the **Code Analysis** tab.
2224

25+
> [!TIP]
26+
> Newer project types such as .NET Core and .NET Standard applications don't have a **Code Analysis** tab. Static code analysis is not available for these project types, but you can still get live code analysis using [Roslyn code analyzers](roslyn-analyzers-overview.md). To suppress warnings from Roslyn code analyzers, see the note at the end of this article.
27+
2328
1. Specify the build type in **Configuration** and the target platform in **Platform**.
2429

2530
1. To enable or disable automatic code analysis, select or clear the **Enable Code Analysis on Build** check box.

docs/code-quality/using-the-cpp-core-guidelines-checkers.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -129,10 +129,10 @@ These macros correspond to the rule sets and expand into a space-separated list
129129
The Microsoft Visual C++ compiler has a limited support for the GSL suppress attribute. It can be used to suppress warnings on expression and block statements inside of a function.
130130

131131
```cpp
132-
// Supress only warnings from the 'r.11' rule in expression.
132+
// Suppress only warnings from the 'r.11' rule in expression.
133133
[[gsl::suppress(r.11)]] new int;
134134

135-
// Supress all warnings from the 'r' rule group (resource management) in block.
135+
// Suppress all warnings from the 'r' rule group (resource management) in block.
136136
[[gsl::suppress(r)]]
137137
{
138138
new int;

docs/ide/reference/autorecover-environment-options-dialog-box.md

Lines changed: 13 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ ms.prod: visual-studio-dev15
55
ms.technology: vs-ide-general
66
ms.topic: reference
77
f1_keywords:
8-
- "VS.ToolsOptionsPag.Environment.AutoRecover"
98
- "VS.DialogAutoRestore"
109
- "VS.ToolsOptionsPages.Environment.AutoRecover"
1110
- "VS.ToolsOptionsPages.Environment.Auto_Save_and_Restore"
@@ -21,18 +20,23 @@ manager: douge
2120
ms.workload:
2221
- "multiple"
2322
---
24-
# AutoRecover, Environment, Options Dialog Box
25-
Use this page of the Options dialog box to specify whether or not files are automatically backed up. This page also allows you to specify whether or not modified files are restored when the integrated development environment (IDE) shuts down unexpectedly. You can access this dialog box by selecting the **Tools** menu and choosing **Options**, and then selecting the **Environment** folder and choosing the **AutoRecover** page. If this page does not appear in the list, select **Show all setting** in the **Options** dialog box.
23+
# AutoRecover, Environment, Options dialog box
24+
25+
Use this page in the **Options** dialog box to specify whether to automatically back up files or not. This page also lets you specify if you want to restore modified files if Visual Studio shuts down unexpectedly.
26+
27+
Access this dialog box by selecting the **Tools** menu, selecting **Options**, and then selecting **Environment** > **AutoRecover**. If this page doesn't appear in the list, select **Show all setting** in the **Options** dialog box.
2628

2729
> [!NOTE]
28-
> The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings or edition. To change your settings, choose Import and Export Settings on the Tools menu. For more information, see [Personalize the Visual Studio IDE](../../ide/personalizing-the-visual-studio-ide.md).
30+
> The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings or edition. To change your settings, choose **Import and Export Settings** on the **Tools** menu. For more information, see [Personalize the Visual Studio IDE](../../ide/personalizing-the-visual-studio-ide.md).
31+
32+
**Save AutoRecover information every [n] minutes**
33+
34+
Use this option to customize how often a file is automatically saved in the editor. For previously saved files, a copy of the file is saved in *%USERPROFILE%\Documents\Visual Studio \<version>\Backup Files\\<projectname>*. If the file is new and you haven't saved it yet, the file is autosaved using a randomly generated file name.
2935

30-
**Save AutoRecover information every \<n> minutes**
31-
Use this option to customize how often a file is automatically saved in the editor. For previously saved files, a copy of the file is saved in \\...\My Documents\Visual Studio \<*version*>\Backup Files\\<*projectname*>. If the file is new and has not been manually saved, the file is auto-saved using a randomly generated file name.
36+
**Keep AutoRecover information for [n] days**
3237

33-
**Keep AutoRecover information for \<n> days**
34-
Use this option to specify how long Visual Studio keeps files created for autorecovery.
38+
Use this option to specify how long Visual Studio keeps files created for autorecovery.
3539

36-
## See Also
40+
## See also
3741

3842
- [Options Dialog Box](../../ide/reference/options-dialog-box-visual-studio.md)

docs/ide/reference/documents-environment-options-dialog-box.md

Lines changed: 33 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,6 @@ ms.topic: reference
77
f1_keywords:
88
- "VS.Environment.Documents"
99
- "VS.ToolsOptionsPages.Environment.Documents"
10-
- "VS.ToolsOptionsPag.Environment.Documents"
1110
helpviewer_keywords:
1211
- "Documents Environment Options dialog box"
1312
- "defaults, directories"
@@ -36,50 +35,60 @@ ms.workload:
3635
- "multiple"
3736
---
3837
# Documents, Environment, Options Dialog Box
38+
3939
Use this page of the **Options** dialog box to control the display of documents in the integrated development environment (IDE) and manage external changes to documents and files. You can access this dialog box by clicking **Options** on the **Tools** menu and then selecting **Documents** in the **Environment** node. If **Documents** does not appear in the list, select **Show all settings** in the **Options** dialog box.
4040

4141
> [!NOTE]
4242
> The options available in dialog boxes, and the names and locations of menu commands you see, might differ from what is described in Help depending on your active settings or edition. To change your settings, choose **Import and Export Settings** on the **Tools** menu. For more information, see [Personalize the Visual Studio IDE](../../ide/personalizing-the-visual-studio-ide.md).
4343
44+
**Reuse current document window, if saved**
45+
46+
When selected, closes your current document if it has been saved, and opens a new document in the same window. If your current document has not been saved, it remains open and the new document is opened in a separate window. When this option is cleared, new documents always open in separate windows.
47+
48+
If you perform multi-document cut and paste operations infrequently and want to minimize the number of open documents and windows in your working space, try this option.
49+
50+
**Detect when file is changed outside the environment**
51+
52+
When this option is selected, a message immediately notifies you of changes to an open file that have been made by an editor outside the IDE. The message lets you reload the file from storage.
4453

45-
**Reuse current document window, if saved**
46-
When selected, closes your current document if it has been saved, and opens a new document in the same window. If your current document has not been saved, it remains open and the new document is opened in a separate window. When this option is cleared, new documents always open in separate windows.
54+
**Auto-load changes, if saved**
4755

48-
If you perform multi-document cut and paste operations infrequently and want to minimize the number of open documents and windows in your working space, try this option.
56+
When you have **Detect when file is changed outside the environment** selected and an open file in the IDE changes outside the IDE, a warning message is generated by default. If this option is enabled, no warning appears and the document is reloaded in the IDE to pick up the external changes.
4957

50-
**Detect when file is changed outside the environment**
51-
When this option is selected, a message immediately notifies you of changes to an open file that have been made by an editor outside the IDE. The message lets you reload the file from storage.
58+
**Allow editing of read-only files; warn when attempt to save**
5259

53-
**Auto-load changes, if saved**
54-
When you have **Detect when file is changed outside the environment** selected and an open file in the IDE changes outside the IDE, a warning message is generated by default. If this option is enabled, no warning appears and the document is reloaded in the IDE to pick up the external changes.
60+
When this option is enabled, you can open and edit a read-only file. When you are finished, you must use the **Save As** command to save the file by a new name if you want to save a record of your changes.
5561

56-
**Allow editing of read-only files; warn when attempt to save**
57-
When this option is enabled you can open and edit a read-only file. When you are finished, you must use the **Save As**command to save the file by a new name if you want to save a record of your changes.
62+
**Open file using directory of currently active document**
5863

59-
**Open file using directory of currently active document**
60-
When selected, this option specifies that the **Open File** dialog box displays the directory of the active document. When this option is cleared, the **Open File** dialog box displays the directory last used to open a file.
64+
When selected, this option specifies that the **Open File** dialog box displays the directory of the active document. When this option is cleared, the **Open File** dialog box displays the directory last used to open a file.
6165

62-
**Check for consistent line endings on load**
63-
Select this option to have the editor scan the line endings in a file and display a message box if inconsistencies are detected in how line endings are formatted.
66+
**Check for consistent line endings on load**
6467

65-
**Display warning when global undo will modify edited files**
66-
Select this option to display a message box when the **Global Undo** command will roll back refactoring changes made in files that also were changed after the refactoring operation. Returning a file to its pre-refactoring state might discard subsequent changes made in the file.
68+
Select this option to have the editor scan the line endings in a file and display a message box if inconsistencies are detected in how line endings are formatted.
6769

68-
**Show Miscellaneous files in Solution Explorer**
69-
Select this option to display the **Miscellaneous Files** node in **Solution Explorer**. Miscellaneous files are files that are not associated with a project or solution but can appear in **Solution Explorer** for your convenience.
70+
**Display warning when global undo will modify edited files**
71+
72+
Select this option to display a message box when the **Global Undo** command will roll back refactoring changes made in files that also were changed after the refactoring operation. Returning a file to its pre-refactoring state might discard subsequent changes made in the file.
73+
74+
**Show Miscellaneous files in Solution Explorer**
75+
76+
Select this option to display the **Miscellaneous Files** node in **Solution Explorer**. Miscellaneous files are files that are not associated with a project or solution but can appear in **Solution Explorer** for your convenience.
7077

7178
> [!NOTE]
7279
> Select this option to enable the **View in Browser** command on the **File** menu for web documents not included in the active web application.
7380
74-
**\<** *n* **> items saved in the Miscellaneous files project**
75-
Specifies the number of files to persist in the **MiscellaneousFiles** folder of **Solution Explorer**. These files are listed even if they are no longer open in an editor. You can specify any whole number from 0 to 256. The default number is 0.
81+
**\<** *n* **> items saved in the Miscellaneous files project**
82+
83+
Specifies the number of files to persist in the **MiscellaneousFiles** folder of **Solution Explorer**. These files are listed even if they are no longer open in an editor. You can specify any whole number from 0 to 256. The default number is 0.
84+
85+
For example, if you set this option to 5 and have 10 miscellaneous files open, when you close all 10 files, the first 5 will still be shown in the **Miscellaneous Files** folder.
7686

77-
For example, if you set this option to 5 and have 10 miscellaneous files open, when you close all 10 files, the first 5 will still be shown in the **Miscellaneous Files** folder.
87+
**Save documents as Unicode when data cannot be saved in codepage**
7888

79-
**Save documents as Unicode when data cannot be saved in codepage**
80-
Select this option to cause files containing information incompatible with the selected codepage to be saved as Unicode by default.
89+
Select this option to cause files containing information incompatible with the selected codepage to be saved as Unicode by default.
8190

82-
## See Also
91+
## See also
8392

8493
- [Environment Options Dialog Box](../../ide/reference/environment-options-dialog-box.md)
8594
- [Miscellaneous Files](../../ide/reference/miscellaneous-files.md)

docs/ide/reference/fonts-and-colors-environment-options-dialog-box.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ ms.prod: visual-studio-dev15
55
ms.technology: vs-ide-general
66
ms.topic: reference
77
f1_keywords:
8-
- "VS.ToolsOptionsPag.Environment.Fonts_And_Colors"
98
- "VS.ToolsOptionsPages.FontsAndColors"
109
- "VS.ToolsOptionsPages.Environment.Fonts_And_Colors"
1110
- "VS.Environment.Fonts And Colors"

docs/ide/reference/international-settings-environment-options-dialog-box.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@ f1_keywords:
88
- "VS.ToolsOptionsPages.Environment.InternationalSettings"
99
- "VS.ToolsOptionsPages.Environment.International_Settings"
1010
- "VS.Environment.International Settings"
11-
- "VS.ToolsOptionsPag.Environment.International_Settings"
1211
helpviewer_keywords:
1312
- "International Settings dialog box"
1413
- "languages, environment settings"
@@ -22,19 +21,18 @@ ms.workload:
2221
- "multiple"
2322
---
2423
# International Settings, Environment, Options Dialog Box
24+
2525
The International Settings page allows you to change the default language when you have more than one language version of the integrated development environment (IDE) installed on your machine. You can access this dialog box by selecting **Options** from the **Tools** menu and then choosing **International Settings** from the **Environment** folder. If this page does not appear in the list, select **Show all settings** in the **Options** dialog box.
2626

2727
> [!NOTE]
2828
> The options available in dialog boxes, and the names and locations of menu commands you see, might differ from what is described in Help depending on your active settings or edition. To change your settings, choose **Import and Export Settings** on the **Tools** menu. For more information, see [Personalize the Visual Studio IDE](../../ide/personalizing-the-visual-studio-ide.md).
2929
30-
3130
**Language**
3231
Lists the available languages for the installed product language versions. This option is unavailable unless you have more than one language version installed on your machine. If multiple languages of products or a mixed language installation of products share the environment, the language selection is changed to **Same as Microsoft Windows**.
3332

3433
> [!CAUTION]
3534
> In a system with multiple languages installed, the Visual C++ build tools (cl.exe, link.exe, nmake.exe, bscmake.exe and related files) are not affected by this setting. These tools use the version for the last language installed. The build tools for the previously installed language are overwritten, because the Visual C++ build tools do not use the satellite DLL model.
3635
37-
3836
## See Also
3937

4038
- [Install language packs](../../install/install-visual-studio.md#step-6---install-language-packs-optional)

docs/ide/reference/options-dialog-box-projects-and-solutions-build-and-run.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ ms.technology: vs-ide-general
66
ms.topic: reference
77
f1_keywords:
88
- "VS.ToolsOptionsPages.Projects.Build_and_Run"
9-
- "VS.ToolsOptionsPag.Projects.Build_and_Run"
109
helpviewer_keywords:
1110
- "builds [Visual Studio], setting up"
1211
- "run actions"

docs/ide/reference/task-list-environment-options-dialog-box.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ ms.technology: vs-ide-general
66
ms.topic: reference
77
f1_keywords:
88
- "VS.ToolsOptionsPages.Environment.Task_List"
9-
- "VS.ToolsOptionsPag.Environment.Task_List"
109
- "VS.ToolsOptionsPages.Environment.TaskList"
1110
- "VS.Environment.Task List"
1211
helpviewer_keywords:

docs/ide/reference/web-browser-environment-options-dialog-box.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,6 @@ ms.topic: reference
77
f1_keywords:
88
- "VS.Environment.Web Browser"
99
- "VS.ToolsOptionsPages.Environment.WebBrowser"
10-
- "VS.ToolsOptionsPag.Environment.Web_Browser"
1110
- "VS.ToolsOptionsPages.Environment.Web_Browser"
1211
helpviewer_keywords:
1312
- "browsers, customizing"

docs/ide/walkthrough-building-an-application.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -94,7 +94,7 @@ You can temporarily hide certain warning messages during a build rather than hav
9494

9595
1. Choose the **Build** page and then, in the **Suppress warnings** box, specify the warning number **0168**.
9696

97-
![Build page, Project Designer](../ide/media/buildwalk_csharpsupresswarnings.png)
97+
![Build page, Project Designer](../ide/media/buildwalk_csharpsuppresswarnings.png)
9898

9999
For more information, see [Build Page, Project Designer (C#)](../ide/reference/build-page-project-designer-csharp.md).
100100

@@ -114,7 +114,7 @@ You can temporarily hide certain warning messages during a build rather than hav
114114

115115
3. On the **Compile** page, select the **Disable all warnings** check box.
116116

117-
![Compile page, Project Designer](../ide/media/buildwalk_vbsupresswarnings.png)
117+
![Compile page, Project Designer](../ide/media/buildwalk_vbsuppresswarnings.png)
118118

119119
For more information, see [Configure warnings in Visual Basic](../ide/configuring-warnings-in-visual-basic.md).
120120

0 commit comments

Comments
 (0)