Skip to content

Commit 3777dca

Browse files
Fixed some URLs in the documentation (#8078)
- Changed http:// links to https:// where that was the case (a handful of http:// links remain), but all changed ones were checked - Where GitHub links changed from `master` to `main` - Where source lines were referenced it now points to a given revision, because pointing to a branch name means the line number may be incorrect. NB: so this was very much intentional! - Linked to the archived page for dead links - Updated old MSDN and docs.microsoft.com and blog links to point to the current location (even if it's the archive on learn.microsoft.com) - Remove en-us from canonical links to learn.microsoft.com ... Co-authored-by: Rainer Sigwald <[email protected]>
1 parent 3b7246b commit 3777dca

14 files changed

+48
-48
lines changed

documentation/wiki/Binary-Log.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Goals:
99
* structure (preserves the exact build event args that can later be replayed to reconstruct the exact events and information as if a real build was running). File logs erase structure and are harder to parse (especially for multicore /m builds). Build analyzer tools are conceivable that could benefit from the structure in a binary log. An API is available to load and query binary logs.
1010
* optionally collect the project files (and all imported targets files) used during the build. This can help analyzing the logs and even view preprocessed source for all projects (with all imported projects inlined).
1111

12-
See http://msbuildlog.com for more information.
12+
See https://msbuildlog.com/ for more information.
1313

1414
# Creating a binary log during a build
1515

@@ -62,7 +62,7 @@ Once you have the `StructuredLogger.dll` on disk you can pass it to MSBuild like
6262
# Using MSBuild Structured Log Viewer
6363

6464
You can use the MSBuild Structured Log Viewer tool to view `.binlog` files:
65-
http://msbuildlog.com
65+
https://msbuildlog.com/
6666

6767
# Collecting binary logs from Visual Studio builds
6868

documentation/wiki/Building-Testing-and-Debugging-on-.Net-Core-MSBuild.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,13 @@ MSBuild can be successfully built on Windows, OS X 10.13, Ubuntu 14.04, and Ubun
1010

1111
## The easy way
1212

13-
Install the latest .NET Core SDK from http://dot.net/core. That will ensure all prerequisites for our build are met.
13+
Install the latest .NET SDK from https://dotnet.microsoft.com/download. That will ensure all prerequisites for our build are met.
1414

1515
## Manually installing required packages for OSX & Ubuntu
1616

17-
[.NET Core prerequisites](https://github.com/dotnet/core/blob/master/Documentation/prereqs.md).
17+
[.NET Core prerequisites](https://github.com/dotnet/core/blob/main/Documentation/prereqs.md).
1818

19-
* *OpenSSL*: MSBuild uses the .Net CLI during its build process. The CLI requires a recent OpenSSL library available in `/usr/lib`. This can be downloaded using [brew](http://brew.sh/) on OS X (`brew install openssl`) and apt-get (`apt-get install openssl`) on Ubuntu, or [building from source](https://wiki.openssl.org/index.php/Compilation_and_Installation#Mac). If you use a different package manager and see an error that says `Unable to load DLL 'System.Security.Cryptography.Native'`, `dotnet` may be looking in the wrong place for the library.
19+
* *OpenSSL*: MSBuild uses the .Net CLI during its build process. The CLI requires a recent OpenSSL library available in `/usr/lib`. This can be downloaded using [brew](https://brew.sh/) on OS X (`brew install openssl`) and apt-get (`apt-get install openssl`) on Ubuntu, or [building from source](https://wiki.openssl.org/index.php/Compilation_and_Installation#Mac). If you use a different package manager and see an error that says `Unable to load DLL 'System.Security.Cryptography.Native'`, `dotnet` may be looking in the wrong place for the library.
2020

2121
## Build
2222

documentation/wiki/Building-Testing-and-Debugging-on-Full-Framework-MSBuild.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ These instructions refer to working with the `master` branch.
44

55
## Required Software
66

7-
**Latest Microsoft Visual Studio 2022**: You can download the Visual Studio Community edition from [https://www.visualstudio.com/en-us/products/visual-studio-community-vs.aspx](https://www.visualstudio.com/en-us/products/visual-studio-community-vs.aspx).
7+
**Latest Microsoft Visual Studio 2022**: You can download the Visual Studio Community edition from [visualstudio.microsoft.com/vs/community/](https://visualstudio.microsoft.com/vs/community/).
88

99
All command lines should be executed from a Visual Studio developer command prompt.
1010

@@ -31,7 +31,7 @@ The CI does two builds. In the second build, it uses the binaries from the first
3131

3232
## Contributing
3333

34-
Please see [Contributing Code](https://github.com/dotnet/msbuild/blob/master/documentation/wiki/Contributing-Code.md) for details on contributing changes back to the code. Please read this carefully and engage with us early to ensure work is not wasted.
34+
Please see [Contributing Code](https://github.com/dotnet/msbuild/blob/main/documentation/wiki/Contributing-Code.md) for details on contributing changes back to the code. Please read this carefully and engage with us early to ensure work is not wasted.
3535

3636
## Walkthroughs
3737

documentation/wiki/Building-Testing-and-Debugging-on-Mono-MSBuild.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Mono maintains a fork of msbuild (for now) at `https://github.com/mono/msbuild/`
66

77
**Required packages for OSX & Ubuntu**
88

9-
MSBuild requires a stable version of [Mono](http://www.mono-project.com/download/) to build itself.
9+
MSBuild requires a stable version of [Mono](https://www.mono-project.com/download/stable/) to build itself.
1010

1111
## Build process ##
1212

@@ -23,9 +23,9 @@ If you encounter errors, see [Something's wrong in my build](Something's-wrong-i
2323
`./install-mono-prefix.sh </your/mono/prefix>`
2424

2525
## Getting Mono MSBuild binaries without building the code ##
26-
The best way to get Mono MSBuild for OSX/macOS is to get the official [Mono package](http://www.mono-project.com/download/#download-mac). After installing it, you can run `msbuild`.
26+
The best way to get Mono MSBuild for OSX/macOS is to get the official [Mono package](https://www.mono-project.com/download/stable/#download-mac). After installing it, you can run `msbuild`.
2727
<br/>
28-
For Linux, you can install mono and msbuild from [here](http://www.mono-project.com/download/#download-lin).
28+
For Linux, you can install mono and msbuild from [here](https://www.mono-project.com/download/stable/#download-lin).
2929

3030
## Debugging
3131

documentation/wiki/Contributing-Code.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Because our focus right now is on maintaining backwards compatibility, the team
77
- Only contributions referencing an approved Issue will be accepted.
88
- Pull requests that do not merge easily with the tip of the master branch will be declined. The author will be asked to merge with tip and submit a new pull request.
99
- Submissions must meet functional and performance expectations, including scenarios for which the team doesn't yet have open source tests. This means you may be asked to fix and resubmit your pull request against a new open test case if it fails one of these tests.
10-
- Submissions must follow the [.NET Runtime Coding Guidelines](https://github.com/dotnet/runtime/blob/master/docs/coding-guidelines/coding-style.md)
10+
- Submissions must follow the [.NET Runtime Coding Guidelines](https://github.com/dotnet/runtime/blob/main/docs/coding-guidelines/coding-style.md)
1111

1212
When you are ready to proceed with making a change, get set up to [build](Home.md "See 'Building Testing and Debugging'") the code and familiarize yourself with our workflow and our coding conventions. These two blogs posts on contributing code to open source projects are good too: [Open Source Contribution Etiquette by Miguel de Icaza](https://tirania.org/blog/archive/2010/Dec-31.html) and [Don’t “Push” Your Pull Requests by Ilya Grigorik](https://www.igvita.com/2011/12/19/dont-push-your-pull-requests/).
1313

@@ -33,4 +33,4 @@ Please follow these guidelines when creating new issues in the issue tracker:
3333
- Subscribe to notifications for the created issue in case there are any follow up questions.
3434

3535
### Coding Conventions
36-
- Use the coding style outlined in the [.NET Runtime Coding Guidelines](https://github.com/dotnet/runtime/blob/master/docs/coding-guidelines/coding-style.md)
36+
- Use the coding style outlined in the [.NET Runtime Coding Guidelines](https://github.com/dotnet/runtime/blob/main/docs/coding-guidelines/coding-style.md)

documentation/wiki/Contributing-Tasks.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,15 @@ The following requirements are in place for contributed tasks:
1313
3. The task must have unit tests in place to prevent regressions.
1414

1515
## Developing a new Task
16-
Review the existing documentation on [Task Writing](https://docs.microsoft.com/en-us/visualstudio/msbuild/task-writing) to learn about the fundamentals. You can also looking at existing tasks in the [Microsoft.Build.Tasks.Core assembly](https://github.com/dotnet/msbuild/tree/master/src/Tasks) for a great starting point.
16+
Review the existing documentation on [Task Writing](https://learn.microsoft.com/visualstudio/msbuild/task-writing) to learn about the fundamentals. You can also looking at existing tasks in the [Microsoft.Build.Tasks.Core assembly](https://github.com/dotnet/msbuild/tree/main/src/Tasks) for a great starting point.
1717

1818
Tasks are generally simple and should not require much effort to develop. If you find a task becoming very complicated, consider breaking it up into smaller tasks which can be run together in a target.
1919

2020
## Developing unit tests
21-
Contributed tasks must have unit tests in place to prove they work and to prevent regressions caused by other code changes. There are a lot of examples in the [Microsoft.Build.Tasks.UnitTests](https://github.com/dotnet/msbuild/tree/master/src/Tasks.UnitTests) project. Please provide a reasonable amount of test coverage so ensure the quality of the product.
21+
Contributed tasks must have unit tests in place to prove they work and to prevent regressions caused by other code changes. There are a lot of examples in the [Microsoft.Build.Tasks.UnitTests](https://github.com/dotnet/msbuild/tree/main/src/Tasks.UnitTests) project. Please provide a reasonable amount of test coverage so ensure the quality of the product.
2222

2323
## Documentation
24-
You can document the new task in the [visualstudio-docs](https://github.com/MicrosoftDocs/visualstudio-docs/tree/master/docs/msbuild) repository. This helps users discover the new functionality. The easiest way is to copy the documentation page for an existing task as a template.
24+
You can document the new task in the [visualstudio-docs](https://github.com/MicrosoftDocs/visualstudio-docs/tree/main/docs/msbuild) repository. This helps users discover the new functionality. The easiest way is to copy the documentation page for an existing task as a template.
2525

2626
## Ship schedule
2727
MSBuild ships regularly with Visual Studio. It also is updated in Preview releases. Once your contribution is merged, expect it to be available in the next release.

documentation/wiki/Localization.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
- `Strings.shared.resx` is a shared resource and gets embedded into all msbuild dlls
77
- each neutral resource has a directory named `xlf` besides it which contains its localized strings in .xlf format
88
- there is one language per xlf
9-
- the logical name for a resource is: `<Assembly Name>.<Neutral Resx File Name>.resources`. In the ResourceManager this appears as `<Assembly Name>.<Neutral Resx File Name>` (without the trailing `.resources`). For example, the `Microsoft.Build` assembly uses the `Microsoft.Build.Strings.resources` [logical resource name](https://github.com/dotnet/msbuild/blob/master/src/XMakeBuildEngine/Microsoft.Build.csproj#L659) (the resource file is `Strings.resx`), and its corresponding [ResourceManager](https://github.com/dotnet/msbuild/blob/master/src/XMakeBuildEngine/Resources/AssemblyResources.cs#L116) uses `Microsoft.Build.Strings`.
9+
- the logical name for a resource is: `<Assembly Name>.<Neutral Resx File Name>.resources`. In the ResourceManager this appears as `<Assembly Name>.<Neutral Resx File Name>` (without the trailing `.resources`). For example, the `Microsoft.Build` assembly uses the `Microsoft.Build.Strings.resources` [logical resource name](https://github.com/dotnet/msbuild/blob/cc3db358d34ad4cd1ec0c67e17582d7ca2a15040/src/Build/Microsoft.Build.csproj#L792) (the resource file is `Strings.resx`), and its corresponding [ResourceManager](https://github.com/dotnet/msbuild/blob/518c041f4511a6bc23eb40703b69a94ea46c65fd/src/Build/Resources/AssemblyResources.cs#L118) uses `Microsoft.Build.Strings`.
1010

1111
## How to edit a resource
1212

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
11
# General Resources
2-
* [MSBuild Concepts](https://msdn.microsoft.com/en-us/library/dd637714.aspx)
3-
* [MSBuild Reserved and Well-Known Properties](https://msdn.microsoft.com/en-us/library/ms164309.aspx)
2+
* [MSBuild Concepts](https://learn.microsoft.com/visualstudio/msbuild/msbuild-concepts)
3+
* [MSBuild Reserved and Well-Known Properties](https://learn.microsoft.com/visualstudio/msbuild/msbuild-reserved-and-well-known-properties)
44
* [MSBuild Tips & Tricks](MSBuild-Tips-&-Tricks.md)
55
* [Target Maps](Target-Maps.md)
66

77
# MSBuild Source Code
88
* [https://github.com/dotnet/msbuild](https://github.com/dotnet/msbuild)
99
* [https://source.dot.net](https://source.dot.net)
10-
* Use [http://referencesource.microsoft.com](http://referencesource.microsoft.com) or [http://source.roslyn.io](http://source.roslyn.io) to browse Microsoft MSBuild targets. Examples:
11-
* search for "[_FindDependencies MSBuildProperty](http://referencesource.microsoft.com/#q=_FindDependencies%20MSBuildProperty)"
12-
* find targets [http://referencesource.microsoft.com/#MSBuildTarget=ResolveAssemblyReferences](http://referencesource.microsoft.com/#MSBuildTarget=ResolveAssemblyReferences)
10+
* Use [referencesource.microsoft.com](https://referencesource.microsoft.com) or [sourceroslyn.io/](https://sourceroslyn.io/) to browse Microsoft MSBuild targets. Examples:
11+
* search for "[_FindDependencies MSBuildProperty](https://referencesource.microsoft.com/#q=_FindDependencies%20MSBuildProperty)"
12+
* find targets [referencesource.microsoft.com/#MSBuildTarget=ResolveAssemblyReferences](https://referencesource.microsoft.com/#MSBuildTarget=ResolveAssemblyReferences)
1313

1414
# Tools
1515
**Note:** These are third party tools
16-
* [MSBuildStructuredLog](http://msbuildlog.com/)
16+
* [MSBuildStructuredLog](https://msbuildlog.com/)
1717
* A log viewer that displays a structured representation of executed targets, tasks, property and item values.
18-
* [MSBuildExtensionPack](http://www.msbuildextensionpack.com)
18+
* [MSBuildExtensionPack](https://github.com/mikefourie-zz/MSBuildExtensionPack) (also via [NuGet](https://www.nuget.org/packages/MSBuild.Extension.Pack))
1919
* Provides a large collection of MSBuild Tasks, MSBuild Loggers and MSBuild TaskFactories.
2020
* [MSBuilder](https://github.com/MobileEssentials/MSBuilder)
2121
* Reusable blocks of MSBuild helpers; MSBuilder's goal is to provide fine-grained nuget packages that can be installed when only a certain MSBuild extension (task, property, target) is needed.
@@ -34,13 +34,13 @@
3434
* Lets you build Visual Studio solutions and projects as well as any MSBuild file through a context menu without opening Visual Studio.
3535

3636
# Books
37-
* [Inside the Microsoft Build Engine: Using MSBuild and Team Foundation Build (2nd Edition) by Sayed Hashimi, William Bartholomew](http://www.amazon.com/Inside-Microsoft-Build-Engine-Foundation/dp/0735645248)
38-
* [MSBuild Trickery: 99 Ways to Bend the Build Engine to Your Will, by Brian Kretzler](http://www.amazon.com/MSBuild-Trickery-Ways-Build-Engine/dp/061550907X)
37+
* [Inside the Microsoft Build Engine: Using MSBuild and Team Foundation Build (2nd Edition) by Sayed Hashimi, William Bartholomew](https://www.amazon.com/Inside-Microsoft-Build-Engine-Foundation/dp/0735645248)
38+
* [MSBuild Trickery: 99 Ways to Bend the Build Engine to Your Will, by Brian Kretzler](https://www.amazon.com/MSBuild-Trickery-Ways-Build-Engine/dp/061550907X)
3939

4040
# Blogs
41-
* [https://blogs.msdn.microsoft.com/msbuild](https://blogs.msdn.microsoft.com/msbuild)
42-
* [Sayed Hashimi's blog http://sedodream.com](http://sedodream.com)
41+
* [MSBuild Team Blog](https://learn.microsoft.com/archive/blogs/msbuild/) (archive)
42+
* [Sayed Hashimi's blog at sedodream.com](http://sedodream.com)
4343
* [Mike Fourie's blog https://mikefourie.wordpress.com](https://mikefourie.wordpress.com)
4444

4545
# MSBuild Assemblies
46-
![MSBuild Assemblies](https://raw.githubusercontent.com/KirillOsenkov/MSBuildStructuredLog/master/docs/MSBuildAssemblies.png)
46+
![MSBuild Assemblies](https://raw.githubusercontent.com/KirillOsenkov/MSBuildStructuredLog/main/docs/MSBuildAssemblies.png)

documentation/wiki/MSBuild-Tips-&-Tricks.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# MSBuild Command-Line Switches
2-
See the [MSBuild Command-Line Reference](https://docs.microsoft.com/visualstudio/msbuild/msbuild-command-line-reference) for more information on switches.
2+
See the [MSBuild Command-Line Reference](https://learn.microsoft.com/visualstudio/msbuild/msbuild-command-line-reference) for more information on switches.
33
* `MSBuild.exe -pp:<FILE>`
44
* MSBuild preprocessor. Pass /pp to the command line to create a single huge XML project file with all project imports inlined in the correct order. This is useful to investigate the ordering of imports and property and target overrides during evaluation.
55
* Example usage: `msbuild MyProject.csproj /pp:inlined.xml`
@@ -14,13 +14,13 @@ See the [MSBuild Command-Line Reference](https://docs.microsoft.com/visualstudio
1414

1515
# Environment Variables
1616
* `MSBUILDTARGETOUTPUTLOGGING=1`
17-
* Set this to enable [printing all target outputs to the log](https://blogs.msdn.microsoft.com/msbuild/2010/03/31/displaying-target-output-items-using-the-console-logger).
17+
* Set this to enable [printing all target outputs to the log](https://learn.microsoft.com/archive/blogs/msbuild/displaying-target-output-items-using-the-console-logger).
1818
* `MSBUILDLOGTASKINPUTS=1`
1919
* Log task inputs (not needed if there are any diagnostic loggers already).
2020
* `MSBUILDEMITSOLUTION=1`
2121
* Save the generated .proj file for the .sln that is used to build the solution.
2222
* `MSBUILDENABLEALLPROPERTYFUNCTIONS=1`
23-
* Enable [additional property functions](https://blogs.msdn.microsoft.com/visualstudio/2010/04/02/msbuild-property-functions).
23+
* Enable [additional property functions](https://devblogs.microsoft.com/visualstudio/msbuild-property-functions/).
2424
* `MSBUILDLOGVERBOSERARSEARCHRESULTS=1`
2525
* In ResolveAssemblyReference task, log verbose search results.
2626
* `MSBUILDLOGCODETASKFACTORYOUTPUT=1`
@@ -45,7 +45,7 @@ If MSBuild.exe is passed properties on the command line, such as `/p:Platform=An
4545
This will make sure that your local assignments to the `Platform` property are respected. You can specify multiple properties in `TreatAsLocalProperty` separated by semicolon.
4646

4747
# Visual Studio Background Builds
48-
Set the `TRACEDESIGNTIME=true` environment variable to output design-time build logs to TEMP: read more here: https://blogs.msdn.microsoft.com/jeremykuhne/2016/06/06/vs-background-builds
48+
Set the `TRACEDESIGNTIME=true` environment variable to output design-time build logs to TEMP: read more here: https://learn.microsoft.com/archive/blogs/jeremykuhne/vs-background-builds
4949

5050
# Visual Studio Design-time (IntelliSense) builds
5151

@@ -56,7 +56,7 @@ Use this command-line to approximate what the design-time build does:
5656
```
5757

5858
# Extend all builds (at system-wide level)
59-
See https://www.simple-talk.com/dotnet/.net-tools/extending-msbuild, "Extending all builds" section. Also read about [MSBuildUserExtensionsPath](http://referencesource.microsoft.com/#MSBuildFiles/C/ProgramFiles(x86)/MSBuild/14.0/Microsoft.Common.props,33), [CustomBeforeMicrosoftCommonProps](http://referencesource.microsoft.com/#MSBuildFiles/C/ProgramFiles(x86)/MSBuild/14.0/Microsoft.Common.props,68), [CustomBeforeMicrosoftCommonTargets](http://referencesource.microsoft.com/#MSBuildFiles/C/ProgramFiles(x86)/MSBuild/14.0/bin_/amd64/Microsoft.Common.targets,71), and CustomAfterMicrosoftCommonProps/CustomAfterMicrosoftCommonTargets.
59+
See https://www.simple-talk.com/dotnet/.net-tools/extending-msbuild, "Extending all builds" section. Also read about [MSBuildUserExtensionsPath](https://referencesource.microsoft.com/#MSBuildFiles/C/ProgramFiles(x86)/MSBuild/14.0/Microsoft.Common.props,33), [CustomBeforeMicrosoftCommonProps](https://referencesource.microsoft.com/#MSBuildFiles/C/ProgramFiles(x86)/MSBuild/14.0/Microsoft.Common.props,68), [CustomBeforeMicrosoftCommonTargets](https://referencesource.microsoft.com/#MSBuildFiles/C/ProgramFiles(x86)/MSBuild/14.0/bin_/amd64/Microsoft.Common.targets,71), and CustomAfterMicrosoftCommonProps/CustomAfterMicrosoftCommonTargets.
6060

6161
Example:
6262
Create this file (Custom.props) in `C:\Users\username\AppData\Local\Microsoft\MSBuild\Current\Microsoft.Common.targets\ImportAfter`:

0 commit comments

Comments
 (0)