[automated] Merge branch 'release/9.0.2xx' => 'main' (#44212)

Author: ViktorHofer

.vsts-ci.yml

@@ -30,6 +30,7 @@ variables:
 # Helix testing requires a token when internally run.
 # Variables used: HelixApiAccessToken
 - group: DotNet-HelixApi-Access
+- group: AzureDevOps-Artifact-Feeds-Pats
 # Allows Arcade to run a signed build by disabling post-build signing for release-branch builds or manual builds that are not running tests.
 - ${{ if and(eq(parameters.runTestBuild, false), or(startswith(variables['Build.SourceBranch'], 'refs/heads/release/'), startswith(variables['Build.SourceBranch'], 'refs/heads/internal/release/'), eq(variables['Build.Reason'], 'Manual'))) }}:
   - name: PostBuildSign
@@ -68,12 +69,10 @@ extends:
         image: mcr.microsoft.com/dotnet-buildtools/prereqs:cbl-mariner-2.0-fpm
       centosStream9:
         image: mcr.microsoft.com/dotnet-buildtools/prereqs:centos-stream9
-      debian11Amd64:
-        image: mcr.microsoft.com/dotnet-buildtools/prereqs:debian-11-amd64
+      debian12Amd64:
+        image: mcr.microsoft.com/dotnet-buildtools/prereqs:debian-12-gcc14-amd64
       fedora39:
         image: mcr.microsoft.com/dotnet-buildtools/prereqs:fedora-39
-      ubuntu2204:
-        image: mcr.microsoft.com/dotnet-buildtools/prereqs:ubuntu-22.04
       mariner20CrossArm:
         image: mcr.microsoft.com/dotnet-buildtools/prereqs:cbl-mariner-2.0-cross-arm
       ubuntu2204DebPkg:
@@ -310,6 +309,7 @@ extends:
           parameters:
             oneESCompat:
               publishTaskPrefix: 1ES.
+            runtimeSourceProperties: /p:DotNetRuntimeSourceFeed=https://dotnetbuilds.blob.core.windows.net/internal /p:DotNetRuntimeSourceFeedKey=$(dotnetbuilds-internal-container-read-token-base64)
 
     ############### PUBLISH STAGE ###############
     - ${{ if and(eq(parameters.runTestBuild, false), ne(variables['Build.Reason'], 'PullRequest')) }}:

.vsts-pr.yml

@@ -25,12 +25,12 @@ resources:
     image: mcr.microsoft.com/dotnet-buildtools/prereqs:alpine-3.19-WithNode
   - container: centosStream9
     image: mcr.microsoft.com/dotnet-buildtools/prereqs:centos-stream9
-  - container: debian11Amd64
-    image: mcr.microsoft.com/dotnet-buildtools/prereqs:debian-11-amd64
+  - container: debian12Amd64
+    image: mcr.microsoft.com/dotnet-buildtools/prereqs:debian-12-gcc14-amd64
   - container: fedora39
     image: mcr.microsoft.com/dotnet-buildtools/prereqs:fedora-39
-  - container: ubuntu2204
-    image: mcr.microsoft.com/dotnet-buildtools/prereqs:ubuntu-22.04
+  - container: ubuntu2204DebPkg
+    image: mcr.microsoft.com/dotnet-buildtools/prereqs:ubuntu-22.04-debpkg
 
 stages:
 ############### BUILD STAGE ###############

documentation/manpages/sdk/dotnet-add-package.1

@@ -14,7 +14,7 @@
 . ftr VB CB
 . ftr VBI CBI
 .\}
-.TH "dotnet-add-package" "1" "2023-10-25" "" ".NET Documentation"
+.TH "dotnet-add-package" "1" "2024-10-02" "" ".NET Documentation"
 .hy
 .SH dotnet add package
 .PP

documentation/manpages/sdk/dotnet-add-reference.1

@@ -14,7 +14,7 @@
 . ftr VB CB
 . ftr VBI CBI
 .\}
-.TH "dotnet-add-reference" "1" "2023-10-25" "" ".NET Documentation"
+.TH "dotnet-add-reference" "1" "2024-10-02" "" ".NET Documentation"
 .hy
 .SH dotnet add reference
 .PP
@@ -55,7 +55,7 @@ But you can do that by editing your \f[I].csproj\f[R] file and adding markup sim
 \f[C]
 <ItemGroup>
   <Reference Include=\[dq]MyAssembly\[dq]>
-    <HintPath>\[dq].\[rs]MyDLLFolder\[rs]MyAssembly.dll</HintPath>
+    <HintPath>.\[rs]MyDLLFolder\[rs]MyAssembly.dll</HintPath>
   </Reference>
 </ItemGroup>
 \f[R]

documentation/manpages/sdk/dotnet-build-server.1

@@ -14,7 +14,7 @@
 . ftr VB CB
 . ftr VBI CBI
 .\}
-.TH "dotnet-build-server" "1" "2023-10-25" "" ".NET Documentation"
+.TH "dotnet-build-server" "1" "2024-10-02" "" ".NET Documentation"
 .hy
 .SH dotnet build-server
 .PP

documentation/manpages/sdk/dotnet-build.1

@@ -14,7 +14,7 @@
 . ftr VB CB
 . ftr VBI CBI
 .\}
-.TH "dotnet-build" "1" "2023-10-25" "" ".NET Documentation"
+.TH "dotnet-build" "1" "2024-10-02" "" ".NET Documentation"
 .hy
 .SH dotnet build
 .PP
@@ -27,6 +27,7 @@ dotnet-build - Builds a project and all of its dependencies.
 .nf
 \f[C]
 dotnet build [<PROJECT>|<SOLUTION>] [-a|--arch <ARCHITECTURE>]
+    [--artifacts-path <ARTIFACTS_DIR>]
     [-c|--configuration <CONFIGURATION>] [-f|--framework <FRAMEWORK>]
     [--disable-build-servers]
     [--force] [--interactive] [--no-dependencies] [--no-incremental]
@@ -35,7 +36,7 @@ dotnet build [<PROJECT>|<SOLUTION>] [-a|--arch <ARCHITECTURE>]
     [-p|--property:<PROPERTYNAME>=<VALUE>]
     [-r|--runtime <RUNTIME_IDENTIFIER>]
     [--self-contained [true|false]] [--source <SOURCE>]
-    [--tl [auto|on|off]] [--use-current-runtime, --ucr [true|false]]
+    [--tl:[auto|on|off]] [--use-current-runtime, --ucr [true|false]]
     [-v|--verbosity <LEVEL>] [--version-suffix <VERSION_SUFFIX>]
 
 dotnet build -h|--help
@@ -132,6 +133,14 @@ If you use this option, don\[cq]t use the \f[V]-r|--runtime\f[R] option.
 Available since .NET 6 Preview 7.
 .RE
 .IP \[bu] 2
+\f[B]\f[VB]--artifacts-path <ARTIFACTS_DIR>\f[B]\f[R]
+.RS 2
+.PP
+All build output files from the executed command will go in subfolders under the specified path, separated by project.
+For more information see Artifacts Output Layout.
+Available since .NET 8 SDK.
+.RE
+.IP \[bu] 2
 \f[B]\f[VB]-c|--configuration <CONFIGURATION>\f[B]\f[R]
 .RS 2
 .PP
@@ -273,7 +282,7 @@ Available since .NET 6.
 The URI of the NuGet package source to use during the restore operation.
 .RE
 .IP \[bu] 2
-\f[B]\f[VB]--tl [auto|on|off]\f[B]\f[R]
+\f[B]\f[VB]--tl:[auto|on|off]\f[B]\f[R]
 .RS 2
 .PP
 Specifies whether the \f[I]terminal logger\f[R] should be used for the build output.
@@ -286,17 +295,17 @@ The terminal logger shows you the restore phase followed by the build phase.
 During each phase, the currently building projects appear at the bottom of the terminal.
 Each project that\[cq]s building outputs both the MSBuild target currently being built and the amount of time spent on that target.
 You can search this information to learn more about the build.
-When a project is finished building, a single \[lq]build completed\[rq] section is written for that captures:
+When a project is finished building, a single \[lq]build completed\[rq] section is written that captures:
 .IP \[bu] 2
-The name of the built project
+The name of the built project.
 .IP \[bu] 2
-The target framework (if multi-targeted)
+The target framework (if multi-targeted).
 .IP \[bu] 2
-The status of that build
+The status of that build.
 .IP \[bu] 2
-The primary output of that build (which is hyperlinked)
+The primary output of that build (which is hyperlinked).
 .IP \[bu] 2
-Any diagnostics generated for that project
+Any diagnostics generated for that project.
 .PP
 This option is available starting in .NET 8.
 .RE
@@ -349,12 +358,12 @@ dotnet build --configuration Release
 .fi
 .RE
 .IP \[bu] 2
-Build a project and its dependencies for a specific runtime (in this example, Ubuntu 18.04):
+Build a project and its dependencies for a specific runtime (in this example, Linux):
 .RS 2
 .IP
 .nf
 \f[C]
-dotnet build --runtime ubuntu.18.04-x64
+dotnet build --runtime linux-x64
 \f[R]
 .fi
 .RE

documentation/manpages/sdk/dotnet-clean.1

@@ -14,7 +14,7 @@
 . ftr VB CB
 . ftr VBI CBI
 .\}
-.TH "dotnet-clean" "1" "2023-10-25" "" ".NET Documentation"
+.TH "dotnet-clean" "1" "2024-10-02" "" ".NET Documentation"
 .hy
 .SH dotnet clean
 .PP
@@ -26,10 +26,12 @@ dotnet-clean - Cleans the output of a project.
 .IP
 .nf
 \f[C]
-dotnet clean [<PROJECT>|<SOLUTION>] [-c|--configuration <CONFIGURATION>]
+dotnet clean [<PROJECT>|<SOLUTION>] [--artifacts-path <ARTIFACTS_DIR>]
+    [-c|--configuration <CONFIGURATION>]
     [-f|--framework <FRAMEWORK>] [--interactive]
     [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
-    [-r|--runtime <RUNTIME_IDENTIFIER>] [-v|--verbosity <LEVEL>]
+    [-r|--runtime <RUNTIME_IDENTIFIER>] [--tl:[auto|on|off]]
+    [-v|--verbosity <LEVEL>]
 
 dotnet clean -h|--help
 \f[R]
@@ -48,6 +50,14 @@ The MSBuild project or solution to clean.
 If a project or solution file is not specified, MSBuild searches the current working directory for a file that has a file extension that ends in \f[I]proj\f[R] or \f[I]sln\f[R], and uses that file.
 .SH OPTIONS
 .IP \[bu] 2
+\f[B]\f[VB]--artifacts-path <ARTIFACTS_DIR>\f[B]\f[R]
+.RS 2
+.PP
+All build output files from the executed command will go in subfolders under the specified path, separated by project.
+For more information see Artifacts Output Layout.
+Available since .NET 8 SDK.
+.RE
+.IP \[bu] 2
 \f[B]\f[VB]-c|--configuration <CONFIGURATION>\f[B]\f[R]
 .RS 2
 .PP
@@ -106,6 +116,34 @@ Cleans the output folder of the specified runtime.
 This is used when a self-contained deployment was created.
 .RE
 .IP \[bu] 2
+\f[B]\f[VB]--tl:[auto|on|off]\f[B]\f[R]
+.RS 2
+.PP
+Specifies whether the \f[I]terminal logger\f[R] should be used for the build output.
+The default is \f[V]auto\f[R], which first verifies the environment before enabling terminal logging.
+The environment check verifies that the terminal is capable of using modern output features and isn\[cq]t using a redirected standard output before enabling the new logger.
+\f[V]on\f[R] skips the environment check and enables terminal logging.
+\f[V]off\f[R] skips the environment check and uses the default console logger.
+.PP
+The terminal logger shows you the restore phase followed by the build phase.
+During each phase, the currently building projects appear at the bottom of the terminal.
+Each project that\[cq]s building outputs both the MSBuild target currently being built and the amount of time spent on that target.
+You can search this information to learn more about the build.
+When a project is finished building, a single \[lq]build completed\[rq] section is written that captures:
+.IP \[bu] 2
+The name of the built project.
+.IP \[bu] 2
+The target framework (if multi-targeted).
+.IP \[bu] 2
+The status of that build.
+.IP \[bu] 2
+The primary output of that build (which is hyperlinked).
+.IP \[bu] 2
+Any diagnostics generated for that project.
+.PP
+This option is available starting in .NET 8.
+.RE
+.IP \[bu] 2
 \f[B]\f[VB]-v|--verbosity <LEVEL>\f[B]\f[R]
 .RS 2
 .PP

documentation/manpages/sdk/dotnet-dev-certs.1

@@ -15,7 +15,7 @@
 . ftr VB CB
 . ftr VBI CBI
 .\}
-.TH "dotnet-dev-certs" "1" "2023-10-25" "" ".NET Documentation"
+.TH "dotnet-dev-certs" "1" "2024-10-02" "" ".NET Documentation"
 .hy
 .SH dotnet dev-certs
 .PP