diff --git a/documentation/manpages/sdk/dotnet-build-server.1 b/documentation/manpages/sdk/dotnet-build-server.1 index ab1714b3cca2..107c9699e830 100644 --- a/documentation/manpages/sdk/dotnet-build-server.1 +++ b/documentation/manpages/sdk/dotnet-build-server.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-build-server" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-build-server" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet build-server .PP diff --git a/documentation/manpages/sdk/dotnet-build.1 b/documentation/manpages/sdk/dotnet-build.1 index f6878f38c329..8f5fc601bb33 100644 --- a/documentation/manpages/sdk/dotnet-build.1 +++ b/documentation/manpages/sdk/dotnet-build.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-build" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-build" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet build .PP diff --git a/documentation/manpages/sdk/dotnet-clean.1 b/documentation/manpages/sdk/dotnet-clean.1 index 1d2f8f09a3c5..ccf20d94422b 100644 --- a/documentation/manpages/sdk/dotnet-clean.1 +++ b/documentation/manpages/sdk/dotnet-clean.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-clean" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-clean" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet clean .PP diff --git a/documentation/manpages/sdk/dotnet-dev-certs.1 b/documentation/manpages/sdk/dotnet-dev-certs.1 index d061cc94cdf6..be46e908b9d8 100644 --- a/documentation/manpages/sdk/dotnet-dev-certs.1 +++ b/documentation/manpages/sdk/dotnet-dev-certs.1 @@ -15,7 +15,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-dev-certs" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-dev-certs" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet dev-certs .PP @@ -119,6 +119,7 @@ successfully removed from the machine. .PP Exports the certificate to a file so that it can be used by other tools. Specify the full path to the exported certificate file, including the file name. +The containing directories must already exist and access to them should be restricted. The type of certificate files that are created depends on which options are used with \f[V]--export-path\f[R]: .PP .TS diff --git a/documentation/manpages/sdk/dotnet-environment-variables.7 b/documentation/manpages/sdk/dotnet-environment-variables.7 index cf9140fe4d57..4978d8d48032 100644 --- a/documentation/manpages/sdk/dotnet-environment-variables.7 +++ b/documentation/manpages/sdk/dotnet-environment-variables.7 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-environment-variables" "7" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-environment-variables" "7" "2025-05-30" "" ".NET Documentation" .hy .SH NAME .PP @@ -439,7 +439,7 @@ For more information, see the \f[V]--roll-forward\f[R] option for the \f[V]dotne If set to \f[V]1\f[R] (enabled), enables rolling forward to a pre-release version from a release version. By default (\f[V]0\f[R] - disabled), when a release version of .NET runtime is requested, roll-forward will only consider installed release versions. .PP -For more information, see the \f[V]--roll-forward\f[R] option for the \f[V]dotnet\f[R] command +For more information, see the \f[V]--roll-forward\f[R] option for the \f[V]dotnet\f[R] command. .SS \f[V]DOTNET_ROLL_FORWARD_ON_NO_CANDIDATE_FX\f[R] .PP Disables minor version roll forward, if set to \f[V]0\f[R]. diff --git a/documentation/manpages/sdk/dotnet-format.1 b/documentation/manpages/sdk/dotnet-format.1 index de2870a41082..b387ead86c0c 100644 --- a/documentation/manpages/sdk/dotnet-format.1 +++ b/documentation/manpages/sdk/dotnet-format.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-format" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-format" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet format .PP diff --git a/documentation/manpages/sdk/dotnet-help.1 b/documentation/manpages/sdk/dotnet-help.1 index dda34df0732e..95375cfc75e5 100644 --- a/documentation/manpages/sdk/dotnet-help.1 +++ b/documentation/manpages/sdk/dotnet-help.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-help" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-help" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet help reference .PP diff --git a/documentation/manpages/sdk/dotnet-migrate.1 b/documentation/manpages/sdk/dotnet-migrate.1 index 488833f8c5e6..76f1de8f6ce4 100644 --- a/documentation/manpages/sdk/dotnet-migrate.1 +++ b/documentation/manpages/sdk/dotnet-migrate.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-migrate" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-migrate" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet migrate .PP @@ -49,7 +49,7 @@ A single project by specifying the \f[I]project.json\f[R] file to migrate. .IP \[bu] 2 All of the directories specified in the \f[I]global.json\f[R] file by passing in a path to the \f[I]global.json\f[R] file. .IP \[bu] 2 -A \f[I]solution.sln\f[R] file, where it migrates the projects referenced in the solution. +A \f[I]solution.sln(x)\f[R] file, where it migrates the projects referenced in the solution. .IP \[bu] 2 On all subdirectories of the given directory recursively. .PP @@ -72,7 +72,7 @@ a \f[I]project.json\f[R] file to migrate. .IP \[bu] 2 a \f[I]global.json\f[R] file: the folders specified in \f[I]global.json\f[R] are migrated. .IP \[bu] 2 -a \f[I]solution.sln\f[R] file: the projects referenced in the solution are migrated. +a \f[I]solution.sln(x)\f[R] file: the projects referenced in the solution are migrated. .IP \[bu] 2 a directory to migrate: recursively searches for \f[I]project.json\f[R] files to migrate inside the specified directory. .PP diff --git a/documentation/manpages/sdk/dotnet-msbuild.1 b/documentation/manpages/sdk/dotnet-msbuild.1 index 3961ccf06801..e62a0bc415e6 100644 --- a/documentation/manpages/sdk/dotnet-msbuild.1 +++ b/documentation/manpages/sdk/dotnet-msbuild.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-msbuild" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-msbuild" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet msbuild .PP diff --git a/documentation/manpages/sdk/dotnet-new-details.1 b/documentation/manpages/sdk/dotnet-new-details.1 index 4d26bc738627..1aeb3edf28bc 100644 --- a/documentation/manpages/sdk/dotnet-new-details.1 +++ b/documentation/manpages/sdk/dotnet-new-details.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-new-details" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-new-details" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet new details .PP @@ -50,7 +50,7 @@ The package identifier to display the details for. By default, \f[V]dotnet new details\f[R] uses the hierarchy of NuGet configuration files from the current directory to determine the NuGet source the package can be installed from. If \f[V]--nuget-source\f[R] is specified, the source is added to the list of sources to be checked. To check the configured sources for the current directory use \f[V]dotnet nuget list source\f[R]. -For more information, see Common NuGet Configurations +For more information, see Common NuGet Configurations. .RE .IP \[bu] 2 \f[B]\f[VB]--interactive\f[B]\f[R] diff --git a/documentation/manpages/sdk/dotnet-new-install.1 b/documentation/manpages/sdk/dotnet-new-install.1 index 07172f5ced35..e0bb5e119d4b 100644 --- a/documentation/manpages/sdk/dotnet-new-install.1 +++ b/documentation/manpages/sdk/dotnet-new-install.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-new-install" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-new-install" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet new install .PP @@ -26,7 +26,7 @@ dotnet-new-install - installs a template package. .IP .nf \f[C] -dotnet new install [--interactive] [--add-source|--nuget-source ] [--force] +dotnet new install [--interactive] [--add-source|--nuget-source ] [--force] [-d|--diagnostics] [--verbosity ] [-h|--help] \f[R] .fi @@ -85,11 +85,8 @@ If you want to install a specific version or prerelease version of a template pa .PP By default, \f[V]dotnet new install\f[R] uses the hierarchy of NuGet configuration files from the current directory to determine the NuGet source the package can be installed from. If \f[V]--nuget-source\f[R] is specified, the source will be added to the list of sources to be checked. -.PD 0 -.P -.PD To check the configured sources for the current directory use \f[V]dotnet nuget list source\f[R]. -For more information, see Common NuGet Configurations +For more information, see Common NuGet Configurations. .RS .PP Following NuGet\[cq]s Https Everywhere (https://devblogs.microsoft.com/nuget/https-everywhere/) initiative, \f[V]dotnet new\f[R] is phasing out \f[V]http\f[R] feeds. @@ -161,7 +158,7 @@ Install version 2.0 of the SPA templates for ASP.NET Core from a custom NuGet so .IP .nf \f[C] -dotnet new --install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source \[dq]https://api.my-custom-nuget.com/v3/index.json\[dq] --interactive +dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source \[dq]https://api.my-custom-nuget.com/v3/index.json\[dq] --interactive \f[R] .fi .RE diff --git a/documentation/manpages/sdk/dotnet-new-list.1 b/documentation/manpages/sdk/dotnet-new-list.1 index 0fdd0d18d463..6cd7cc642be9 100644 --- a/documentation/manpages/sdk/dotnet-new-list.1 +++ b/documentation/manpages/sdk/dotnet-new-list.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-new-list" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-new-list" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet new list .PP diff --git a/documentation/manpages/sdk/dotnet-new-sdk-templates.7 b/documentation/manpages/sdk/dotnet-new-sdk-templates.7 index 19fad24c72c3..bd9c878c1006 100644 --- a/documentation/manpages/sdk/dotnet-new-sdk-templates.7 +++ b/documentation/manpages/sdk/dotnet-new-sdk-templates.7 @@ -15,7 +15,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-new-sdk-templates" "7" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-new-sdk-templates" "7" "2025-05-30" "" ".NET Documentation" .hy .SH NAME .PP @@ -150,7 +150,7 @@ T}@T{ 3.0 T} T{ -Unit Test Project +MSTest Test Project T}@T{ \f[V]mstest\f[R] T}@T{ @@ -161,6 +161,17 @@ T}@T{ 1.0 T} T{ +MSTest Test Class +T}@T{ +\f[V]mstest-class\f[R] +T}@T{ +[C#], F#, VB +T}@T{ +Test/MSTest +T}@T{ +1.0 +T} +T{ NUnit 3 Test Project T}@T{ \f[V]nunit\f[R] @@ -530,6 +541,11 @@ Default value T} _ T{ +9.0 +T}@T{ +\f[V]net9.0\f[R] +T} +T{ 8.0 T}@T{ \f[V]net8.0\f[R] @@ -539,23 +555,12 @@ T{ T}@T{ \f[V]net7.0\f[R] T} -T{ -6.0 -T}@T{ -\f[V]net6.0\f[R] -T} -T{ -3.1 -T}@T{ -\f[V]netcoreapp3.1\f[R] -T} .TE .PP The ability to create a project for an earlier TFM depends on having that version of the SDK installed. -For example, if you have only the .NET 7 SDK installed, then the only value available for \f[V]--framework\f[R] is \f[V]net7.0\f[R]. -If you install the .NET 6 SDK the value \f[V]net6.0\f[R] becomes available for \f[V]--framework\f[R]. -If you install the .NET Core 3.1 SDK, \f[V]netcoreapp3.1\f[R] becomes available, and so on. -So by specifying \f[V]--framework netcoreapp3.1\f[R] you can target .NET Core 3.1 even while running \f[V]dotnet new\f[R] in the .NET 6 SDK. +For example, if you have only the .NET 9 SDK installed, then the only value available for \f[V]--framework\f[R] is \f[V]net9.0\f[R]. +If, for example, you install the .NET 8 SDK, the value \f[V]net8.0\f[R] becomes available for \f[V]--framework\f[R]. +So by specifying \f[V]--framework net8.0\f[R] you can target .NET 8 even while running \f[V]dotnet new\f[R] in the .NET 9 SDK. .PP Alternatively, to create a project that targets a framework earlier than the SDK that you\[cq]re using, you might be able to do it by installing the NuGet package for the template. Common (https://www.nuget.org/packages?q=Microsoft.DotNet.Common.ProjectTemplates), web (https://www.nuget.org/packages?q=Microsoft.DotNet.Web.ProjectTemplates), and SPA (https://www.nuget.org/packages?q=Microsoft.DotNet.Web.Spa.ProjectTemplates) project types use different packages per target framework moniker (TFM). @@ -568,7 +573,6 @@ For example, to create a \f[V]console\f[R] project that targets \f[V]netcoreapp1 Sets the \f[V]LangVersion\f[R] property in the created project file. For example, use \f[V]--langVersion 7.3\f[R] to use C# 7.3. Not supported for F#. -Available since .NET Core 2.2 SDK. .PP For a list of default C# versions, see Defaults. .RE @@ -577,7 +581,6 @@ For a list of default C# versions, see Defaults. .RS 2 .PP If specified, doesn\[cq]t execute an implicit restore during project creation. -Available since .NET Core 2.2 SDK. .RE .IP \[bu] 2 \f[B]\f[VB]--use-program-main\f[B]\f[R] @@ -596,8 +599,8 @@ Available only for C#. .RS 2 .PP Specifies the framework to target. -Values: \f[V]net8.0\f[R], \f[V]net7.0\f[R], or \f[V]net6.0\f[R] to create a .NET Class Library, or \f[V]netstandard2.1\f[R] or \f[V]netstandard2.0\f[R] to create a .NET Standard Class Library. -The default value for .NET SDK 8.0.x is \f[V]net8.0\f[R]. +Values: \f[V]net9.0\f[R], \f[V]net8.0\f[R], or \f[V]net7.0\f[R] to create a .NET Class Library, or \f[V]netstandard2.1\f[R] or \f[V]netstandard2.0\f[R] to create a .NET Standard Class Library. +The default value for .NET SDK 9.0.x is \f[V]net9.0\f[R]. .PP To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. .RE @@ -608,7 +611,6 @@ To create a project that targets a framework earlier than the SDK that you\[cq]r Sets the \f[V]LangVersion\f[R] property in the created project file. For example, use \f[V]--langVersion 7.3\f[R] to use C# 7.3. Not supported for F#. -Available since .NET Core 2.2 SDK. .PP For a list of default C# versions, see Defaults. .RE @@ -626,8 +628,7 @@ Doesn\[cq]t execute an implicit restore during project creation. .RS 2 .PP Specifies the framework to target. -For the .NET 8 SDK, the default value is \f[V]net8.0\f[R]. -Available since .NET Core 3.1 SDK. +For the .NET 9 SDK, the default value is \f[V]net9.0\f[R]. .RE .IP \[bu] 2 \f[B]\f[VB]--langVersion \f[B]\f[R] @@ -670,8 +671,7 @@ Doesn\[cq]t execute an implicit restore during project creation. .RS 2 .PP Specifies the framework to target. -The default value for .NET 8 SDK is \f[V]net8.0\f[R]. -Available since .NET Core 3.1 SDK. +The default value for .NET 9 SDK is \f[V]net9.0\f[R]. .PP To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. .RE @@ -697,13 +697,12 @@ Default value: \f[V]false\f[R]. .RE .PP * * * * * -.SS \f[V]mstest\f[R], \f[V]xunit\f[R] +.SS \f[V]mstest\f[R] .IP \[bu] 2 \f[B]\f[VB]-f|--framework \f[B]\f[R] .RS 2 .PP Specifies the framework to target. -Option available since .NET Core 3.0 SDK. .PP The following table lists the default values according to the SDK version number you\[cq]re using: .PP @@ -717,6 +716,11 @@ Default value T} _ T{ +9.0 +T}@T{ +\f[V]net9.0\f[R] +T} +T{ 8.0 T}@T{ \f[V]net8.0\f[R] @@ -726,29 +730,157 @@ T{ T}@T{ \f[V]net7.0\f[R] T} +.TE +.RE +.PP +The ability to create a project for an earlier TFM depends on having that version of the SDK installed. +For example, if you have only the .NET 9 SDK installed, then the only value available for \f[V]--framework\f[R] is \f[V]net9.0\f[R]. +If you install, for example, the .NET 8 SDK, the value \f[V]net8.0\f[R] becomes available for \f[V]--framework\f[R]. +So by specifying \f[V]--framework net8.0\f[R] you can target .NET 8 even while running \f[V]dotnet new\f[R] in the .NET 9 SDK. +.IP \[bu] 2 +\f[B]\f[VB]--no-restore\f[B]\f[R] +.RS 2 +.PP +Doesn\[cq]t execute an implicit restore during project creation. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--sdk\f[B]\f[R] +.RS 2 +.PP +Use MSTest.Sdk project style. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--test-runner \f[B]\f[R] +.RS 2 +.PP +The runner/platform for the test project. +The possible values are: +.IP \[bu] 2 +\f[V]VSTest\f[R] - VSTest platform (Default). +.IP \[bu] 2 +\f[V]MSTest\f[R] - Microsoft.Testing.Platform. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--coverage-tool \f[B]\f[R] +.RS 2 +.PP +The coverage tool to use for the test project. +The possible values are: +.IP \[bu] 2 +\f[V]Microsoft.CodeCoverage\f[R] - Microsoft Code Coverage (Default). +.IP \[bu] 2 +\f[V]coverlet\f[R] - coverlet coverage tool. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--extensions-profile \f[B]\f[R] +.RS 2 +.PP +The SDK extensions profile when using Microsoft.Testing.Platform. +The possible values are: +.IP \[bu] 2 +\f[V]Default\f[R] - Default extensions profile (Default). +.IP \[bu] 2 +\f[V]None\f[R] - No extensions are enabled. +.IP \[bu] 2 +\f[V]AllMicrosoft\f[R] - Enable all extensions shipped by Microsoft (including extensions with a restrictive license). +.RE +.IP \[bu] 2 +\f[B]\f[VB]--fixture \f[B]\f[R] +.RS 2 +.PP +The fixture kinds to include in the test project. +The possible values are: +.IP \[bu] 2 +\f[V]None\f[R] - No fixture methods. +.IP \[bu] 2 +\f[V]AssemblyInitialize\f[R] - AssemblyInitialize fixture method. +.IP \[bu] 2 +\f[V]AssemblyCleanup\f[R] - AssemblyCleanup fixture method. +.IP \[bu] 2 +\f[V]ClassInitialize\f[R] - ClassInitialize fixture method. +.IP \[bu] 2 +\f[V]ClassCleanup\f[R] - ClassCleanup fixture method. +.IP \[bu] 2 +\f[V]TestInitialize\f[R] - TestInitialize fixture method. +.IP \[bu] 2 +\f[V]TestCleanup\f[R] - TestCleanup fixture method. +.PP +Where multiple values are allowed. +.RE +.IP \[bu] 2 +\f[B]\f[VB]-p|--enable-pack\f[B]\f[R] +.RS 2 +.PP +Enables packaging for the project using dotnet pack. +.RE +.PP + * * * * * +.SS \f[V]mstest-class\f[R] +.IP \[bu] 2 +\f[B]\f[VB]--fixture \f[B]\f[R] +.RS 2 +.PP +The fixture kinds to include in the test project. +The possible values are: +.IP \[bu] 2 +\f[V]None\f[R] - No fixture methods. +.IP \[bu] 2 +\f[V]AssemblyInitialize\f[R] - AssemblyInitialize fixture method. +.IP \[bu] 2 +\f[V]AssemblyCleanup\f[R] - AssemblyCleanup fixture method. +.IP \[bu] 2 +\f[V]ClassInitialize\f[R] - ClassInitialize fixture method. +.IP \[bu] 2 +\f[V]ClassCleanup\f[R] - ClassCleanup fixture method. +.IP \[bu] 2 +\f[V]TestInitialize\f[R] - TestInitialize fixture method. +.IP \[bu] 2 +\f[V]TestCleanup\f[R] - TestCleanup fixture method. +.PP +Where multiple values are allowed. +.RE +.PP + * * * * * +.SS \f[V]xunit\f[R] +.IP \[bu] 2 +\f[B]\f[VB]-f|--framework \f[B]\f[R] +.RS 2 +.PP +Specifies the framework to target. +.PP +The following table lists the default values according to the SDK version number you\[cq]re using: +.PP +.TS +tab(@); +l l. T{ -6.0 +SDK version +T}@T{ +Default value +T} +_ +T{ +9.0 T}@T{ -\f[V]net6.0\f[R] +\f[V]net9.0\f[R] T} T{ -5.0 +8.0 T}@T{ -\f[V]net5.0\f[R] +\f[V]net8.0\f[R] T} T{ -3.1 +7.0 T}@T{ -\f[V]netcoreapp3.1\f[R] +\f[V]net7.0\f[R] T} .TE .RE .PP The ability to create a project for an earlier TFM depends on having that version of the SDK installed. -For example, if you have only the .NET 6 SDK installed, then the only value available for \f[V]--framework\f[R] is \f[V]net6.0\f[R]. -If you install the .NET 5 SDK, the value \f[V]net5.0\f[R] becomes available for \f[V]--framework\f[R]. -If you install the .NET Core 3.1 SDK, \f[V]netcoreapp3.1\f[R] becomes available, and so on. -So by specifying \f[V]--framework netcoreapp3.1\f[R] you can target .NET Core 3.1 even while running \f[V]dotnet new\f[R] in the .NET 6 SDK. +For example, if you have only the .NET 9 SDK installed, then the only value available for \f[V]--framework\f[R] is \f[V]net9.0\f[R]. +If you install, for example, the .NET 8 SDK, the value \f[V]net8.0\f[R] becomes available for \f[V]--framework\f[R]. +So by specifying \f[V]--framework net8.0\f[R] you can target .NET 8 even while running \f[V]dotnet new\f[R] in the .NET 9 SDK. .IP \[bu] 2 \f[B]\f[VB]-p|--enable-pack\f[B]\f[R] .RS 2 @@ -763,7 +895,7 @@ Doesn\[cq]t execute an implicit restore during project creation. .RE .PP * * * * * -.SS \f[V]nunit\f[R] +.SS \f[V]nunit\f[R] .IP \[bu] 2 \f[B]\f[VB]-f|--framework \f[B]\f[R] .RS 2 @@ -782,6 +914,11 @@ Default value T} _ T{ +9.0 +T}@T{ +\f[V]net9.0\f[R] +T} +T{ 8.0 T}@T{ \f[V]net8.0\f[R] @@ -791,29 +928,13 @@ T{ T}@T{ \f[V]net7.0\f[R] T} -T{ -6.0 -T}@T{ -\f[V]net6.0\f[R] -T} -T{ -5.0 -T}@T{ -\f[V]net5.0\f[R] -T} -T{ -3.1 -T}@T{ -\f[V]netcoreapp3.1\f[R] -T} .TE .RE .PP The ability to create a project for an earlier TFM depends on having that version of the SDK installed. -For example, if you have only the .NET 6 SDK installed, then the only value available for \f[V]--framework\f[R] is \f[V]net6.0\f[R]. -If you install the .NET 5 SDK, the value \f[V]net5.0\f[R] becomes available for \f[V]--framework\f[R]. -If you install the .NET Core 3.1 SDK, \f[V]netcoreapp3.1\f[R] becomes available, and so on. -So by specifying \f[V]--framework netcoreapp3.1\f[R] you can target .NET Core 3.1 even while running \f[V]dotnet new\f[R] in the .NET 6 SDK. +For example, if you have only the .NET 9 SDK installed, then the only value available for \f[V]--framework\f[R] is \f[V]net9.0\f[R]. +If you install, for example, the .NET 8 SDK, the value \f[V]net8.0\f[R] becomes available for \f[V]--framework\f[R]. +So by specifying \f[V]--framework net8.0\f[R] you can target .NET 8 even while running \f[V]dotnet new\f[R] in the .NET 9 SDK. .IP \[bu] 2 \f[B]\f[VB]-p|--enable-pack\f[B]\f[R] .RS 2 @@ -1104,6 +1225,11 @@ Default value T} _ T{ +9.0 +T}@T{ +\f[V]net9.0\f[R] +T} +T{ 8.0 T}@T{ \f[V]net8.0\f[R] @@ -1113,21 +1239,6 @@ T{ T}@T{ \f[V]net7.0\f[R] T} -T{ -6.0 -T}@T{ -\f[V]net6.0\f[R] -T} -T{ -5.0 -T}@T{ -\f[V]net5.0\f[R] -T} -T{ -3.1 -T}@T{ -\f[V]netcoreapp3.1\f[R] -T} .TE .PP To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. @@ -1344,6 +1455,11 @@ Default value T} _ T{ +9.0 +T}@T{ +\f[V]net9.0\f[R] +T} +T{ 8.0 T}@T{ \f[V]net8.0\f[R] @@ -1353,31 +1469,6 @@ T{ T}@T{ \f[V]net7.0\f[R] T} -T{ -6.0 -T}@T{ -\f[V]net6.0\f[R] -T} -T{ -5.0 -T}@T{ -\f[V]net5.0\f[R] -T} -T{ -3.1 -T}@T{ -\f[V]netcoreapp3.1\f[R] -T} -T{ -3.0 -T}@T{ -\f[V]netcoreapp3.0\f[R] -T} -T{ -2.1 -T}@T{ -\f[V]netcoreapp2.1\f[R] -T} .TE .PP To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. @@ -1553,6 +1644,11 @@ Default value T} _ T{ +9.0 +T}@T{ +\f[V]net9.0\f[R] +T} +T{ 8.0 T}@T{ \f[V]net8.0\f[R] @@ -1562,26 +1658,6 @@ T{ T}@T{ \f[V]net7.0\f[R] T} -T{ -6.0 -T}@T{ -\f[V]net6.0\f[R] -T} -T{ -5.0 -T}@T{ -\f[V]net5.0\f[R] -T} -T{ -3.1 -T}@T{ -\f[V]netcoreapp3.1\f[R] -T} -T{ -3.0 -T}@T{ -\f[V]netcoreapp3.0\f[R] -T} .TE .PP To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. @@ -1597,14 +1673,12 @@ Doesn\[cq]t execute an implicit restore during project creation. .RS 2 .PP Includes BrowserLink in the project. -Option not available in .NET Core 2.2 and 3.1 SDK. .RE .IP \[bu] 2 \f[B]\f[VB]-rrc|--razor-runtime-compilation\f[B]\f[R] .RS 2 .PP Determines if the project is configured to use Razor runtime compilation in Debug builds. -Option available since .NET Core 3.1.201 SDK. .RE .IP \[bu] 2 \f[B]\f[VB]--kestrelHttpPort\f[B]\f[R] @@ -1637,7 +1711,6 @@ Default value: \f[V]false\f[R]. .RS 2 .PP The type of authentication to use. -Available since .NET Core 3.0 SDK. .PP The possible values are: .IP \[bu] 2 @@ -1677,7 +1750,6 @@ Available since .NET Core 3.0 SDK. .RS 2 .PP Specifies the framework to target. -Option not available in .NET Core 2.2 SDK. .PP The following table lists the default values according to the SDK version number you\[cq]re using: .RS @@ -1699,31 +1771,6 @@ T{ T}@T{ \f[V]net7.0\f[R] T} -T{ -6.0 -T}@T{ -\f[V]net6.0\f[R] -T} -T{ -5.0 -T}@T{ -\f[V]net5.0\f[R] -T} -T{ -3.1 -T}@T{ -\f[V]netcoreapp3.1\f[R] -T} -T{ -3.0 -T}@T{ -\f[V]netcoreapp3.0\f[R] -T} -T{ -2.1 -T}@T{ -\f[V]netcoreapp2.0\f[R] -T} .TE .PP To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. @@ -1763,7 +1810,6 @@ Doesn\[cq]t execute an implicit restore during project creation. .RS 2 .PP Supports adding traditional Razor pages and Views in addition to components to this library. -Available since .NET Core 3.0 SDK. .RE .PP * * * * * @@ -1795,6 +1841,11 @@ Default value T} _ T{ +9.0 +T}@T{ +\f[V]net9.0\f[R] +T} +T{ 8.0 T}@T{ \f[V]net8.0\f[R] @@ -1916,7 +1967,7 @@ Excludes \f[I]launchSettings.json\f[R] from the generated template. .RS 2 .PP Turns off OpenAPI (Swagger) support. -\f[V]AddSwaggerGen\f[R], \f[V]UseSwagger\f[R], and \f[V]UseSwaggerUI\f[R] aren\[cq]t called. +\f[V]AddOpenApi\f[R] and \f[V]MapOpenApi\f[R] aren\[cq]t called. .RE .IP \[bu] 2 \f[B]\f[VB]--no-https\f[B]\f[R] @@ -1953,6 +2004,11 @@ Default value T} _ T{ +9.0 +T}@T{ +\f[V]net9.0\f[R] +T} +T{ 8.0 T}@T{ \f[V]net8.0\f[R] @@ -1962,31 +2018,6 @@ T{ T}@T{ \f[V]net7.0\f[R] T} -T{ -6.0 -T}@T{ -\f[V]net6.0\f[R] -T} -T{ -5.0 -T}@T{ -\f[V]net5.0\f[R] -T} -T{ -3.1 -T}@T{ -\f[V]netcoreapp3.1\f[R] -T} -T{ -3.0 -T}@T{ -\f[V]netcoreapp3.0\f[R] -T} -T{ -2.1 -T}@T{ -\f[V]netcoreapp2.1\f[R] -T} .TE .PP To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. diff --git a/documentation/manpages/sdk/dotnet-new-search.1 b/documentation/manpages/sdk/dotnet-new-search.1 index c5411ca680ba..e20201e5dc96 100644 --- a/documentation/manpages/sdk/dotnet-new-search.1 +++ b/documentation/manpages/sdk/dotnet-new-search.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-new-search" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-new-search" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet new search .PP diff --git a/documentation/manpages/sdk/dotnet-new-uninstall.1 b/documentation/manpages/sdk/dotnet-new-uninstall.1 index f9838d1a963f..4f7c0a35360d 100644 --- a/documentation/manpages/sdk/dotnet-new-uninstall.1 +++ b/documentation/manpages/sdk/dotnet-new-uninstall.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-new-uninstall" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-new-uninstall" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet new uninstall .PP diff --git a/documentation/manpages/sdk/dotnet-new-update.1 b/documentation/manpages/sdk/dotnet-new-update.1 index b96cc6b9b9d3..55eb43d20272 100644 --- a/documentation/manpages/sdk/dotnet-new-update.1 +++ b/documentation/manpages/sdk/dotnet-new-update.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-new-update" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-new-update" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet new update .PP diff --git a/documentation/manpages/sdk/dotnet-new.1 b/documentation/manpages/sdk/dotnet-new.1 index 164fb0b70674..91b2faa72719 100644 --- a/documentation/manpages/sdk/dotnet-new.1 +++ b/documentation/manpages/sdk/dotnet-new.1 @@ -15,7 +15,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-new" "1" "2024-10-02" "" ".NET Documentation" +.TH "dotnet-new" "1" "2025-05-30" "" ".NET Documentation" .hy .SH dotnet new