Skip to content

Commit 03ec106

Browse files
ghogenghogen
authored
Merge pull request MicrosoftDocs#1 from Microsoft/master-sync-work
Resolve syncing conflicts from master-sync-work to master
2 parents 1bb31f8 + 87c04cc commit 03ec106

15,556 files changed

Lines changed: 971796 additions & 1208036 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.openpublishing.publish.config.json‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@
1010
"locale": "en-us",
1111
"version": 0,
1212
"open_to_public_contributors": true,
13+
"git_repository_url_open_to_public_contributors": "https://github.com/Microsoft/cpp-docs",
1314
"type_mapping": {
1415
"Conceptual": "Content",
1516
"ManagedReference": "Content",
@@ -30,4 +31,4 @@
3031
}
3132
],
3233
"need_generate_pdf_url_template": false
33-
}
34+
}

‎CONTRIBUTING.md‎

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
# Contributing
2+
3+
Thank you for your interest in contributing to the Visual C++ documentation!
4+
5+
In this topic, you'll see the basic process for adding or updating content in the [Visual C++ documentation site](https://docs.microsoft.com/cpp-docs).
6+
7+
In this topic, we'll cover:
8+
9+
* [Process for contributing](#process-for-contributing)
10+
* [Guidance checklist](#guidance-checklist)
11+
* [Building the docs](#building-the-docs)
12+
* [Contributing to samples](#contributing-to-samples)
13+
* [Contributor License Agreement](#contributor-license-agreement)
14+
15+
## Process for contributing
16+
17+
**Step 1:** Open an issue describing the article you wish to write and how it relates to existing content.
18+
The content inside the **docs** folder is organized into sections that are organized by content area (e.g., debugger). Try to determine the correct folder for your new content. Get feedback on your proposal.
19+
20+
You can skip this first step for small changes.
21+
22+
**Step 2:** Fork the `Microsoft/cpp-docs` repo.
23+
24+
**Step 3:** Create a `branch` for your article.
25+
26+
**Step 4:** Write your article.
27+
28+
If it's a new topic, you can use this [template file](./styleguide/template.md) as your starting point. It contains the writing guidelines and also explains the metadata required for each article, such as author information.
29+
30+
Navigate to the folder that corresponds to the TOC location determined for your article in step 1.
31+
That folder contains the Markdown files for all articles in that section. If necessary, create a new folder to place the files for your content.
32+
33+
For images and other static resources, add them to the subfolder called **media**. If you are creating a new folder for content, add a media folder to the new folder.
34+
35+
Be sure to follow the proper Markdown syntax. See the [style guide](./styleguide/template.md) for more information.
36+
37+
### Example structure
38+
39+
docs
40+
/standard-library
41+
wstring-convert-class.md
42+
/media
43+
wstring-conversion.png
44+
45+
**Step 5:** Submit a Pull Request (PR) from your branch to `Microsoft/cpp-docs/master`.
46+
47+
If your PR is addressing an existing issue, add the `Fixes #Issue_Number` keyword to the commit message or PR description, so the issue can be automatically closed when the PR is merged. For more information, see [Closing issues via commit messages](https://help.github.com/articles/closing-issues-via-commit-messages/).
48+
49+
The Visual Studio team will review your PR and let you know if the change looks good or if there are any other updates/changes necessary in order to approve it.
50+
51+
**Step 6:** Make any necessary updates to your branch as discussed with the team.
52+
53+
The maintainers will merge your PR into the master branch once feedback has been applied and your change looks good.
54+
55+
On a certain cadence, we push all commits from master branch into the live branch and then you'll be able to see your contribution live at https://docs.microsoft.com/cpp-docs/.
56+
57+
## DOs and DON'Ts
58+
59+
Below is a short list of guiding rules that you should keep in mind when you are contributing to the .NET documentation.
60+
61+
- **DON'T** surprise us with big pull requests. Instead, file an issue and start a discussion so we can agree on a direction before you invest a large amount of time.
62+
- **DO** read the [style guide](./styleguide/template.md) and [voice and tone](./styleguide/voice-tone.md) guidelines.
63+
- **DO** use the [template](./styleguide/template.md) file as the starting point of your work.
64+
- **DO** create a separate branch on your fork before working on the articles.
65+
- **DO** follow the [GitHub Flow workflow](https://guides.github.com/introduction/flow/).
66+
- **DO** blog and tweet (or whatever) about your contributions, frequently!
67+
68+
> [!NOTE]
69+
> You might notice that some of the topics are not currently following all the guidelines specified here and on the [style guide](./styleguide/template.md) as well. We're working towards achieving consistency throughout the site. Check the list of [open issues](https://github.com/dotnet/docs/issues?q=is%3Aissue+is%3Aopen+label%3Aguidelines-adherence) we're currently tracking for that specific goal.
70+
71+
## Building the docs
72+
73+
The documentation is written in [GitHub Flavored Markdown](https://help.github.com/categories/writing-on-github/) and built using [DocFX](http://dotnet.github.io/docfx/) and other internal publishing/building tools. It is hosted at [docs.microsoft.com](https://docs.microsoft.com/dotnet).
74+
75+
If you want to build the docs locally, you need to install [DocFX](https://dotnet.github.io/docfx/); latest versions are the best.
76+
77+
There are several ways to use DocFX, and most of them are covered in the [DocFX getting started guide](https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html).
78+
The following instructions use the [command-line based](https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html#2-use-docfx-as-a-command-line-tool) version of the tool.
79+
If you are comfortable with other ways listed on the link above, feel free to use those.
80+
81+
**Note:** Currently DocFX requires the .NET Framework on Windows or Mono (for Linux or macOS). We hope to port it to .NET Core in the future.
82+
83+
You can build and preview the resulting site locally using a built-in web server. Navigate to the core-docs folder on your machine and type the following command:
84+
85+
```
86+
docfx -t default --serve
87+
```
88+
89+
This starts the local preview on [localhost:8080](http://localhost:8080). You can then view the changes by going to `http://localhost:8080/[path]`, such as http://localhost:8080/articles/welcome.html.
90+
91+
**Note:** the local preview currently doesn't contain any themes at the moment so the look and feel won't be the same as in the documentation site. We're working towards fixing that experience.
92+
93+
# Contributing to samples
94+
95+
For now, include required sample code as inline code blocks in your article. The repo has a codesnippets folder, but this is not ready for public contributions.

‎README.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# Visual Studio 2017 RC documentation for Visual C++
2+
3+
Welcome! This repo contains source files for the work-in-progress Visual C++ RC technical documentation. The topics are published on the [Visual Studio documentation site](https://docs.microsoft.com/cpp-docs).
4+
5+
The documentation for Visual Basic and Visual C# are located in a separate repo at [http://github.com/dotnet/core-docs](http://github.com/dotnet/core-docs), and the Visual C++ documentation is located in the repo located at [http://github.com/Microsoft/cpp-docs](http://github.com/Microsoft/cpp-docs).
6+
7+
## Contributing to the documentation
8+
9+
To contribute to this documentation, please see the [Contributing guide](CONTRIBUTING.md).
10+
We welcome your contributions to help us improve the Visual Studio docs. All the articles in this repository use GitHub flavored markdown.
11+
12+
Several feature areas of Visual Studio have their own folders in this repo, such as **debugger** for topics on debugging, **ide** for topics on the Visual Studio interactive development environment (IDE), and so forth. The **/media** subfolder in each folder contains art files for the topics. The [Contributing guide](CONTRIBUTING.md) has more information.
13+
14+
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.

‎docs/TOC.md‎

Lines changed: 25 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,25 @@
1-
# [Visual C++ in Visual Studio 2017 RC](top/visual-cpp-in-visual-studio.md)
2-
# [What's New for Visual C++ in Visual Studio 2017 RC](top/what-s-new-for-visual-cpp-in-visual-studio.md)
3-
# [Supported Platforms (Visual C++)](top/supported-platforms-visual-cpp.md)
4-
# [C Language](c-language\TOC.md)
5-
# [C++ Language](cpp\TOC.md)
6-
# [C/C++ Preprocessor](preprocessor\TOC.md)
7-
# [C Runtime Library](c-runtime-library\TOC.md)
8-
# [C++ Standard Library](standard-library\TOC.md)
9-
# [Windows Development](windows\TOC.md)
10-
# [Linux Development](linux\TOC.md)
11-
# [.NET Development](dotnet\TOC.md)
12-
# [Cloud and Web Programming in Visual C++](top/cloud-and-web-programming-in-visual-cpp.md)
13-
## [C++ REST SDK (Codename "Casablanca")](top/cpp-rest-sdk-codename-casablanca.md)
14-
# [Parallel Programming](parallel\TOC.md)
15-
# [Data Access](data\TOC.md)
16-
# [Text and Strings](text\TOC.md)
17-
# [Using the Visual Studio IDE for C++](ide\TOC.md)
18-
# [Compilers and Build Tools](build/TOC.md)
19-
# [Porting and Upgrading Visual C++ Code](porting\TOC.md)
20-
# [Security Best Practices for C++](top/security-best-practices-for-cpp.md)
21-
## [Running as a Member of the Users Group](top/running-as-a-member-of-the-users-group.md)
22-
## [How User Account Control (UAC) Affects Your Application](top/how-user-account-control-uac-affects-your-application.md)
23-
# [Visual C++ Samples](top/visual-cpp-samples.md)
24-
# [Visual C++ Help and Community](top/visual-cpp-help-and-community.md)
25-
# [How to Report a Problem with the Visual C++ Toolset](top/how-to-report-a-problem-with-the-visual-cpp-toolset.md)
26-
1+
# [Visual C++ in Visual Studio 2017 RC](top/visual-cpp-in-visual-studio.md)
2+
# [What's New for Visual C++ in Visual Studio 2017 RC](top/what-s-new-for-visual-cpp-in-visual-studio.md)
3+
# [Supported Platforms (Visual C++)](top/supported-platforms-visual-cpp.md)
4+
# [C Language](c-language/c-language-reference.md)
5+
# [C++ Language](cpp/cpp-language-reference.md)
6+
# [C/C++ Preprocessor](preprocessor/c-cpp-preprocessor-reference.md)
7+
# [C Runtime Library](c-runtime-library/c-run-time-library-reference.md)
8+
# [C++ Standard Library](standard-library/cpp-standard-library-reference.md)
9+
# [Windows Development](windows/overview-of-windows-programming-in-cpp.md)
10+
# [Linux Development](linux/download-install-and-setup-the-linux-development-workload.md)
11+
# [.NET Development with C++/CLI](dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md)
12+
# [Cloud and Web Programming in Visual C++](top/cloud-and-web-programming-in-visual-cpp.md)
13+
## [C++ REST SDK (Codename "Casablanca")](top/cpp-rest-sdk-codename-casablanca.md)
14+
# [Parallel Programming](parallel/parallel-programming-in-visual-cpp.md)
15+
# [Data Access](data/data-access-programming-mfc-atl.md)
16+
# [Text and Strings](text/text-and-strings-in-visual-cpp.md)
17+
# [Using the Visual Studio IDE for C++](ide/ide-and-tools-for-visual-cpp-development.md)
18+
# [Compilers and Build Tools](build/building-c-cpp-programs.md)
19+
# [Porting and Upgrading Visual C++ Code](porting/visual-cpp-porting-and-upgrading-guide.md)
20+
# [Security Best Practices for C++](top/security-best-practices-for-cpp.md)
21+
## [Running as a Member of the Users Group](top/running-as-a-member-of-the-users-group.md)
22+
## [How User Account Control (UAC) Affects Your Application](top/how-user-account-control-uac-affects-your-application.md)
23+
# [Visual C++ Samples](top/visual-cpp-samples.md)
24+
# [Visual C++ Help and Community](top/visual-cpp-help-and-community.md)
25+
# [How to Report a Problem with the Visual C++ Toolset](top/how-to-report-a-problem-with-the-visual-cpp-toolset.md)

‎docs/_breadcrumb/toc.yml‎

Lines changed: 116 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
- name: Docs
2+
tocHref: /
3+
topicHref: /
4+
items:
5+
- name: Visual C++
6+
tocHref: /cpp/
7+
topicHref: /cpp/top/visual-cpp-in-visual-studio
8+
items:
9+
- name: C++ Language
10+
tocHref: /cpp/cpp/
11+
topicHref: /cpp/cpp/cpp-language-reference
12+
- name: C Language
13+
tocHref: /cpp/c-language/
14+
topicHref: /cpp/c-language/c-language-reference
15+
- name: C/C++ Preprocessor
16+
tocHref: /cpp/preprocessor/
17+
topicHref: /cpp/c-cpp-preprocessor-reference
18+
- name: C Runtime Library
19+
tocHref: /cpp/c-runtime-library/
20+
topicHref: /cpp/c-runtime-library/c-runtime-library-reference
21+
items:
22+
- name: Reference
23+
tocHref: /cpp/c-runtime-library/reference/
24+
topicHref: /cpp/c-runtime-library/reference/alphabetical-function-reference
25+
- name: C++ Standard Library
26+
tocHref: /cpp/standard-library/
27+
topicHref: /cpp/standard-library/cpp-standard-library
28+
- name: Windows
29+
tocHref: /cpp/windows/
30+
topicHref: /cpp/windows/overview-of-windows-programming-in-cpp
31+
items:
32+
- name: ATL
33+
tocHref: /cpp/atl/
34+
topicHref: /cpp/atl/atl-com-desktop-components
35+
items:
36+
- name: Reference
37+
tocHref: /cpp/atl/reference/
38+
topicHref: /cpp/atl/reference/atl-classes
39+
- name: MFC
40+
tocHref: /cpp/mfc/
41+
topicHref: /cpp/mfc/mfc-desktop-applications
42+
items:
43+
- name: Reference
44+
tocHref: /cpp/mfc/reference/
45+
topicHref: /cpp/mfc/reference/mfc-classes
46+
- name: ATL/MFC Shared Classes
47+
tocHref: /cpp/atl-mfc-shared/
48+
topicHref: /cpp/atl-mfc-shared/atl-mfc-shared-classes
49+
items:
50+
- name: Reference
51+
tocHref: /cpp/atl-mfc-shared/reference/
52+
topicHref: /cpp/atl-mfc/shared/reference/classes-shared-by-atl-and-mfc
53+
- name: Linux
54+
tocHref: /cpp/linux/
55+
topicHref: /cpp/linux/download-install-and-setup-the-linux-development-workload
56+
- name: .NET
57+
tocHref: /cpp/dotnet/
58+
topicHref: /cpp/dotnet/dotnet-programming-with-cpp-cli
59+
- name: Parallel Programming
60+
tocHref: /cpp/parallel/
61+
topicHref: /cpp/parallel/parallel-programming-in-visual-cpp
62+
- name: Data Access
63+
tocHref: /cpp/data/
64+
topicHref: /cpp/data/data-access
65+
items:
66+
- name: OLEDB
67+
tocHref: /cpp/data/oledb/
68+
topicHref: /cpp/data/oledb/ole-db-programming
69+
- name: ODBC
70+
tocHref: /cpp/data/odbc/
71+
topicHref: /cpp/data/odbc/open-database-connectivity-odbc
72+
- name: ADO and RDO
73+
tocHref: /cpp/data/ado-rdo/
74+
topicHref: /cpp/data/ado-rdo/data-bound-controls-ado-and-rdo
75+
- name: IDE and Tools
76+
tocHref: /cpp/ide/
77+
topicHref: /cpp/ide/ide-and-tools-for-visual-cpp-development
78+
items:
79+
- name: IDE
80+
tocHref: /cpp/ide/
81+
topicHref: /cpp/ide/using-the-visual-studio-ide-for-cpp-desktop-development
82+
- name: Building
83+
tocHref: /cpp/build/
84+
tocHref: /cpp/build/building-c-cpp-programs
85+
- name: Compiler Intrinsics and Assembly Language
86+
tocHref: /cpp/intrinsics/
87+
topicHref: /cpp/intrinsics/c-cpp-intrinsics
88+
items:
89+
- name: ARM
90+
tocHref: /cpp/assembler/arm/
91+
topicHref: /cpp/assembler/arm/arm-assembler-reference
92+
- name: Inline assembler
93+
tocHref: /cpp/assembler/inline/
94+
topicHref: /cpp/assembler/inline-assembler-reference
95+
- name: MASM
96+
tocHref: /cpp/assembler/masm/
97+
topicHref: /cpp/assembler/masm/microsoft-macro-assembler-reference
98+
- name: Build Reference
99+
tocHref: /cpp/build/reference/
100+
topicHref: /cpp/build/reference/c-cpp-building-reference
101+
items:
102+
- name: Compiler Errors
103+
tocHref: /cpp/error-messages/compiler-errors-1/
104+
topicHref: /cpp/compiler-errors-1/c-cpp-build-errors
105+
- name: Compiler Warnings
106+
tocHref: /cpp/compiler-warnings/
107+
topicHref: /cpp/compiler-warnings/compiler-warnings-c4000-through-C4199
108+
- name: Other Tools
109+
tocHref: /cpp/error-messages/tool-errors/
110+
topicHref: /cpp/error-messages/tool-errors/vectorizer-and-parallelizer-messages
111+
- name: Porting and Upgrading
112+
tocHref: /cpp/porting/
113+
topicHref: /cpp/porting/porting-and-upgrading-guide
114+
- name: Text and Strings
115+
tocHref: /cpp/text/
116+
topicHref: /cpp/text/text-and-strings

‎docs/assembler/arm/TOC.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# [ARM Assembler Reference](arm-assembler-reference.md)
2-
## [ARM Assembler Command-Line Reference](arm-assembler-command-line-reference.md)
3-
## [ARM Assembler Diagnostic Messages](arm-assembler-diagnostic-messages.md)
4-
## [ARM Assembler Directives](arm-assembler-directives.md)
1+
# [ARM Assembler Reference](arm-assembler-reference.md)
2+
## [ARM Assembler Command-Line Reference](arm-assembler-command-line-reference.md)
3+
## [ARM Assembler Diagnostic Messages](arm-assembler-diagnostic-messages.md)
4+
## [ARM Assembler Directives](arm-assembler-directives.md)

‎docs/assembler/arm/arm-assembler-command-line-reference.md‎

Lines changed: 33 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,36 @@
1-
---
2-
title: "ARM Assembler Command-Line Reference | Microsoft Docs"
3-
ms.custom: ""
4-
ms.date: "11/04/2016"
5-
ms.prod: "visual-studio-dev14"
6-
ms.reviewer: ""
7-
ms.suite: ""
8-
ms.technology:
9-
- "devlang-cpp"
10-
ms.tgt_pltfrm: ""
11-
ms.topic: "article"
12-
dev_langs:
13-
- "C++"
14-
ms.assetid: f7b89478-1ab5-4995-8cde-a805f0462c45
15-
caps.latest.revision: 12
16-
author: "corob-msft"
17-
ms.author: "corob"
18-
manager: "ghogen"
19-
translation.priority.ht:
20-
- "cs-cz"
21-
- "de-de"
22-
- "es-es"
23-
- "fr-fr"
24-
- "it-it"
25-
- "ja-jp"
26-
- "ko-kr"
27-
- "pl-pl"
28-
- "pt-br"
29-
- "ru-ru"
30-
- "tr-tr"
31-
- "zh-cn"
32-
- "zh-tw"
33-
---
34-
# ARM Assembler Command-Line Reference
1+
---
2+
title: "ARM Assembler Command-Line Reference | Microsoft Docs"
3+
ms.custom: ""
4+
ms.date: "11/04/2016"
5+
ms.reviewer: ""
6+
ms.suite: ""
7+
ms.technology:
8+
- "devlang-cpp"
9+
ms.tgt_pltfrm: ""
10+
ms.topic: "article"
11+
dev_langs:
12+
- "C++"
13+
ms.assetid: f7b89478-1ab5-4995-8cde-a805f0462c45
14+
caps.latest.revision: 12
15+
author: "corob-msft"
16+
ms.author: "corob"
17+
manager: "ghogen"
18+
translation.priority.ht:
19+
- "cs-cz"
20+
- "de-de"
21+
- "es-es"
22+
- "fr-fr"
23+
- "it-it"
24+
- "ja-jp"
25+
- "ko-kr"
26+
- "pl-pl"
27+
- "pt-br"
28+
- "ru-ru"
29+
- "tr-tr"
30+
- "zh-cn"
31+
- "zh-tw"
32+
---
33+
# ARM Assembler Command-Line Reference
3534
This article provides command-line information about the Microsoft ARM assembler, *armasm*, which compiles ARMv7 Thumb assembly language into the Microsoft implementation of the Common Object File Format (COFF). The linker can link COFF code with object code that is produced by the ARM assembler or by the C compiler, together with object libraries that are created by the librarian.
3635

3736
## Syntax

0 commit comments

Comments
 (0)