diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 774861bd193a8..1e110cd4f777f 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -1,5 +1,10 @@ { "redirections": [ + { + "source_path": "docs/core/tools/dotnet-migrate.md", + "redirect_url": "/previous-versions/dotnet/core/tools/dotnet-migrate", + "redirect_document_id": false + }, { "source_path": "docs/core/install/localized-intellisense.md", "redirect_url": "/previous-versions/dotnet/core/install/localized-intellisense", diff --git a/docs/core/tools/dotnet-migrate.md b/docs/core/tools/dotnet-migrate.md deleted file mode 100644 index 718f3d6284c87..0000000000000 --- a/docs/core/tools/dotnet-migrate.md +++ /dev/null @@ -1,103 +0,0 @@ ---- -title: dotnet migrate command -description: The dotnet migrate command migrates a project and all of its dependencies. -ms.date: 02/14/2020 ---- -# dotnet migrate - -**This article applies to:** ✔️ .NET Core 2.x SDK - -## Name - -`dotnet migrate` - Migrates a Preview 2 .NET Core project to a .NET Core SDK-style project. - -## Synopsis - -```dotnetcli -dotnet migrate [] [--format-report-file-json ] - [-r|--report-file ] [-s|--skip-project-references [Debug|Release]] - [--skip-backup] [-t|--template-file ] [-v|--sdk-package-version] - [-x|--xproj-file] - -dotnet migrate -h|--help -``` - -## Description - -This command is deprecated. The `dotnet migrate` command is no longer available starting with .NET Core 3.0 SDK. It can only migrate a Preview 2 .NET Core project to a 1.x .NET Core project, which is out of support. - -By default, the command migrates the root project and any project references that the root project contains. This behavior is disabled using the `--skip-project-references` option at run time. - -Migration can be performed on the following assets: - -* A single project by specifying the *project.json* file to migrate. -* All of the directories specified in the *global.json* file by passing in a path to the *global.json* file. -* A *solution.sln* file, where it migrates the projects referenced in the solution. -* On all subdirectories of the given directory recursively. - -The `dotnet migrate` command keeps the migrated *project.json* file inside a `backup` directory, which it creates if the directory doesn't exist. This behavior is overridden using the `--skip-backup` option. - -By default, the migration operation outputs the state of the migration process to standard output (STDOUT). If you use the `--report-file ` option, the output is saved to the file specify. - -The `dotnet migrate` command only supports valid Preview 2 *project.json*-based projects. This means that you cannot use it to migrate DNX or Preview 1 *project.json*-based projects directly to MSBuild/csproj projects. You first need to manually migrate the project to a Preview 2 *project.json*-based project and then use the `dotnet migrate` command to migrate the project. - -## Arguments - -`PROJECT_JSON/GLOBAL_JSON/SOLUTION_FILE/PROJECT_DIR` - -The path to one of the following: - -* a *project.json* file to migrate. -* a *global.json* file: the folders specified in *global.json* are migrated. -* a *solution.sln* file: the projects referenced in the solution are migrated. -* a directory to migrate: recursively searches for *project.json* files to migrate inside the specified directory. - -Defaults to current directory if nothing is specified. - -## Options - -`--format-report-file-json ` - -Output migration report file as JSON rather than user messages. - -`-h|--help` - -Prints out a short help for the command. - -`-r|--report-file ` - -Output migration report to a file in addition to the console. - -`-s|--skip-project-references [Debug|Release]` - -Skip migrating project references. By default, project references are migrated recursively. - -`--skip-backup` - -Skip moving *project.json*, *global.json*, and *\*.xproj* to a `backup` directory after successful migration. - -`-t|--template-file ` - -Template csproj file to use for migration. By default, the same template as the one dropped by `dotnet new console` is used. - -`-v|--sdk-package-version ` - -The version of the sdk package that's referenced in the migrated app. The default is the version of the SDK in `dotnet new`. - -`-x|--xproj-file ` - -The path to the xproj file to use. Required when there is more than one xproj in a project directory. - -## Examples - -Migrate a project in the current directory and all of its project-to-project dependencies: - -`dotnet migrate` - -Migrate all projects that *global.json* file includes: - -`dotnet migrate path/to/global.json` - -Migrate only the current project and no project-to-project (P2P) dependencies. Also, use a specific SDK version: - -`dotnet migrate -s -v 1.0.0-preview4` diff --git a/docs/navigate/tools-diagnostics/toc.yml b/docs/navigate/tools-diagnostics/toc.yml index 52b37667a3956..4b6e89ba49398 100644 --- a/docs/navigate/tools-diagnostics/toc.yml +++ b/docs/navigate/tools-diagnostics/toc.yml @@ -1,4151 +1,4149 @@ items: - - name: .NET tools and diagnostics - href: index.yml - displayName: productivity,instrumentation - - name: .NET SDK +- name: .NET tools and diagnostics + displayName: productivity,instrumentation + href: index.yml +- name: .NET SDK + items: + - name: Overview + displayName: .net sdk,software development kit,software dev kit,tool + href: ../../core/sdk.md + - name: Environment variables + href: ../../core/tools/dotnet-environment-variables.md + - name: dotnet-install scripts + href: ../../core/tools/dotnet-install-script.md + - name: global.json overview + href: ../../core/tools/global-json.md + - name: Telemetry + href: ../../core/tools/telemetry.md + - name: Signed-package verification + href: ../../core/tools/nuget-signed-package-verification.md + - name: Artifacts output layout + href: ../../core/sdk/artifacts-output.md + - name: Error messages items: + - name: NETSDK errors + items: + - name: List of NETSDK errors + href: ../../core/tools/sdk-errors/index.md + - name: NETSDK1004 + href: ../../core/tools/sdk-errors/netsdk1004.md + - name: NETSDK1005 and NETSDK1047 + href: ../../core/tools/sdk-errors/netsdk1005.md + - name: NETSDK1013 + href: ../../core/tools/sdk-errors/netsdk1013.md + - name: NETSDK1022 + href: ../../core/tools/sdk-errors/netsdk1022.md + - name: NETSDK1032 + href: ../../core/tools/sdk-errors/netsdk1032.md + - name: NETSDK1045 + href: ../../core/tools/sdk-errors/netsdk1045.md + - name: NETSDK1059 + href: ../../core/tools/sdk-errors/netsdk1059.md + - name: NETSDK1064 + href: ../../core/tools/sdk-errors/netsdk1064.md + - name: NETSDK1071 + href: ../../core/tools/sdk-errors/netsdk1071.md + - name: NETSDK1073 + href: ../../core/tools/sdk-errors/netsdk1073.md + - name: NETSDK1079 + href: ../../core/tools/sdk-errors/netsdk1079.md + - name: NETSDK1080 + href: ../../core/tools/sdk-errors/netsdk1080.md + - name: NETSDK1082 + href: ../../core/tools/sdk-errors/netsdk1082.md + - name: NETSDK1083 + href: ../../core/tools/sdk-errors/netsdk1083.md + - name: NETSDK1100 + href: ../../core/tools/sdk-errors/netsdk1100.md + - name: NETSDK1112 + href: ../../core/tools/sdk-errors/netsdk1112.md + - name: NETSDK1130 + href: ../../core/tools/sdk-errors/netsdk1130.md + - name: NETSDK1135 + href: ../../core/tools/sdk-errors/netsdk1135.md + - name: NETSDK1136 + href: ../../core/tools/sdk-errors/netsdk1136.md + - name: NETSDK1137 + href: ../../core/tools/sdk-errors/netsdk1137.md + - name: NETSDK1138 + href: ../../core/tools/sdk-errors/netsdk1138.md + - name: NETSDK1141 + href: ../../core/tools/sdk-errors/netsdk1141.md + - name: NETSDK1144 + href: ../../core/tools/sdk-errors/netsdk1144.md + - name: NETSDK1145 + href: ../../core/tools/sdk-errors/netsdk1145.md + - name: NETSDK1147 + href: ../../core/tools/sdk-errors/netsdk1147.md + - name: NETSDK1149 + href: ../../core/tools/sdk-errors/netsdk1149.md + - name: NETSDK1174 + href: ../../core/tools/sdk-errors/netsdk1174.md + - name: NETSDK1182 + href: ../../core/tools/sdk-errors/netsdk1182.md + - name: NETSDK1195 + href: ../../core/tools/sdk-errors/netsdk1195.md + - name: NETSDK1202 + href: ../../core/tools/sdk-errors/netsdk1202.md + - name: NETSDK1206 + href: ../../core/tools/sdk-errors/netsdk1206.md + - name: BuildCheck rules + items: + - name: Index of rules + href: ../../core/tools/buildcheck-rules/index.md + - name: BC0101 + href: ../../core/tools/buildcheck-rules/bc0101.md + - name: BC0102 + href: ../../core/tools/buildcheck-rules/bc0102.md +- name: .NET CLI + items: + - name: Overview + displayName: .net cli,command-line interface,cli,tool + href: ../../core/tools/index.md + - name: dotnet command reference + items: + - name: dotnet + href: ../../core/tools/dotnet.md + - name: dotnet build + href: ../../core/tools/dotnet-build.md + - name: dotnet build-server + href: ../../core/tools/dotnet-build-server.md + - name: dotnet clean + href: ../../core/tools/dotnet-clean.md + - name: dotnet dev-certs + href: ../../core/tools/dotnet-dev-certs.md + - name: dotnet format + href: ../../core/tools/dotnet-format.md + - name: dotnet help + href: ../../core/tools/dotnet-help.md + - name: dotnet msbuild + href: ../../core/tools/dotnet-msbuild.md + - name: dotnet new + items: + - name: dotnet new