diff --git a/Documentation/manpages/sdk/dotnet-add-package.1 b/Documentation/manpages/sdk/dotnet-add-package.1 index 5da0a9104..9710291b4 100644 --- a/Documentation/manpages/sdk/dotnet-add-package.1 +++ b/Documentation/manpages/sdk/dotnet-add-package.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.1.3 +.\" Automatically generated by Pandoc 2.2.1 .\" .TH "dotnet add package command \- .NET Core CLI" "1" "" "" ".NET Core" .hy @@ -9,7 +9,7 @@ \f[C]dotnet\ add\ package\f[] \- Adds a package reference to a project file. .SH SYNOPSIS .PP -\f[C]dotnet\ add\ []\ package\ \ [\-h|\-\-help]\ [\-v|\-\-version]\ [\-f|\-\-framework]\ [\-n|\-\-no\-restore]\ [\-s|\-\-source]\ [\-\-package\-directory]\f[] +\f[C]dotnet\ add\ []\ package\ \ [\-h|\-\-help]\ [\-f|\-\-framework]\ [\-n|\-\-no\-restore]\ [\-\-package\-directory]\ [\-s|\-\-source]\ [\-v|\-\-version]\f[] .SH DESCRIPTION .PP The \f[C]dotnet\ add\ package\f[] command provides a convenient option to add a package reference to a project file. @@ -54,10 +54,6 @@ The package reference to add. .PP Prints out a short help for the command. .PP -\f[C]\-v|\-\-version\ \f[] -.PP -Version of the package. -.PP \f[C]\-f|\-\-framework\ \f[] .PP Adds a package reference only when targeting a specific framework. @@ -66,13 +62,17 @@ Adds a package reference only when targeting a specific framework. .PP Adds a package reference without performing a restore preview and compatibility check. .PP +\f[C]\-\-package\-directory\ \f[] +.PP +Restores the package to the specified directory. +.PP \f[C]\-s|\-\-source\ \f[] .PP Uses a specific NuGet package source during the restore operation. .PP -\f[C]\-\-package\-directory\ \f[] +\f[C]\-v|\-\-version\ \f[] .PP -Restores the package to the specified directory. +Version of the package. .SH EXAMPLES .PP Add \f[C]Newtonsoft.Json\f[] NuGet package to a project: diff --git a/Documentation/manpages/sdk/dotnet-add-reference.1 b/Documentation/manpages/sdk/dotnet-add-reference.1 index b3ff3b02e..2af1448ed 100644 --- a/Documentation/manpages/sdk/dotnet-add-reference.1 +++ b/Documentation/manpages/sdk/dotnet-add-reference.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.1.3 +.\" Automatically generated by Pandoc 2.2.1 .\" .TH "dotnet\-add reference command \- .NET Core CLI" "1" "" "" ".NET Core" .hy diff --git a/Documentation/manpages/sdk/dotnet-build-server.1 b/Documentation/manpages/sdk/dotnet-build-server.1 new file mode 100644 index 000000000..e9ee54c7b --- /dev/null +++ b/Documentation/manpages/sdk/dotnet-build-server.1 @@ -0,0 +1,43 @@ +.\" Automatically generated by Pandoc 2.2.1 +.\" +.TH "dotnet build\-server command \- .NET Core CLI" "1" "" "" ".NET Core" +.hy +.SH dotnet\-build +.PP +.SH NAME +.PP +\f[C]dotnet\ build\-server\f[] \- Interacts with servers started by a build. +.SH SYNOPSIS +.IP +.nf +\f[C] +dotnet\ build\-server\ shutdown\ [\-\-msbuild]\ [\-\-razor]\ [\-\-vbcscompiler] +dotnet\ build\-server\ shutdown\ [\-h|\-\-help] +dotnet\ build\-server\ [\-h|\-\-help] +\f[] +.fi +.SS Commands +.PP +\f[C]shutdown\f[] +.PP +Shuts down build servers that are started from dotnet. +By default, all servers are shut down. +.SH OPTIONS +.PP +\f[C]\-h|\-\-help\f[] +.PP +Prints out a short help for the command. +.PP +\f[C]\-\-msbuild\f[] +.PP +Shuts down the MSBuild build server. +.PP +\f[C]\-\-razor\f[] +.PP +Shuts down the Razor build server. +.PP +\f[C]\-\-vbcscompiler\f[] +.PP +Shuts down the VB/C# compiler build server. +.SH AUTHORS +mairaw. diff --git a/Documentation/manpages/sdk/dotnet-build.1 b/Documentation/manpages/sdk/dotnet-build.1 index 25f1b5d09..ebdc2313e 100644 --- a/Documentation/manpages/sdk/dotnet-build.1 +++ b/Documentation/manpages/sdk/dotnet-build.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.1.3 +.\" Automatically generated by Pandoc 2.2.1 .\" .TH "dotnet build command \- .NET Core CLI" "1" "" "" ".NET Core" .hy @@ -44,19 +44,19 @@ For more information, see .NET Core Application Deployment. Building requires the \f[I]project.assets.json\f[] file, which lists the dependencies of your application. The file is created when \f[C]dotnet\ restore\f[] is executed. Without the assets file in place, the tooling cannot resolve reference assemblies, which results in errors. -With .NET Core 1.x SDK, you needed to explicitily run the \f[C]dotnet\ restore\f[] before running \f[C]dotnet\ build\f[]. -Starting with .NET Core 2.0 SDK, \f[C]dotnet\ restore\f[] runs implicitily when you run \f[C]dotnet\ build\f[]. +With .NET Core 1.x SDK, you needed to explicitly run the \f[C]dotnet\ restore\f[] before running \f[C]dotnet\ build\f[]. +Starting with .NET Core 2.0 SDK, \f[C]dotnet\ restore\f[] runs implicitly when you run \f[C]dotnet\ build\f[]. If you want to disable implicit restore when running the build command, you can pass the \f[C]\-\-no\-restore\f[] option. .PP .PP -\f[C]dotnet\ build\f[] uses MSBuild to build the project; thus, it supports both parallel and incremental builds. -Refer to Incremental Builds for more information. +\f[C]dotnet\ build\f[] uses MSBuild to build the project, so it supports both parallel and incremental builds. +For more information, see Incremental Builds. .PP In addition to its options, the \f[C]dotnet\ build\f[] command accepts MSBuild options, such as \f[C]/p\f[] for setting properties or \f[C]/l\f[] to define a logger. -Learn more about these options in the MSBuild Command\-Line Reference. +For more information about these options, see the MSBuild Command\-Line Reference. .PP Whether the project is executable or not is determined by the \f[C]\f[] property in the project file. -The following example shows a project that will produce executable code: +The following example shows a project that produces executable code: .IP .nf \f[C] @@ -90,7 +90,7 @@ The framework must be defined in the project file. \f[C]\-\-force\f[] .PP Forces all dependencies to be resolved even if the last restore was successful. -This is equivalent to deleting the \f[I]project.assets.json\f[] file. +Specifying this flag is the same as deleting the \f[I]project.assets.json\f[] file. .PP \f[C]\-h|\-\-help\f[] .PP @@ -98,16 +98,16 @@ Prints out a short help for the command. .PP \f[C]\-\-no\-dependencies\f[] .PP -Ignores project\-to\-project (P2P) references and only builds the root project specified to build. +Ignores project\-to\-project (P2P) references and only builds the specified root project. .PP \f[C]\-\-no\-incremental\f[] .PP Marks the build as unsafe for incremental build. -This turns off incremental compilation and forces a clean rebuild of the project's dependency graph. +This flag turns off incremental compilation and forces a clean rebuild of the project's dependency graph. .PP \f[C]\-\-no\-restore\f[] .PP -Doesn't perform an implicit restore during build. +Doesn't execute an implicit restore during build. .PP \f[C]\-o|\-\-output\ \f[] .PP @@ -146,12 +146,12 @@ Prints out a short help for the command. .PP \f[C]\-\-no\-dependencies\f[] .PP -Ignores project\-to\-project (P2P) references and only builds the root project specified to build. +Ignores project\-to\-project (P2P) references and only builds the specified root project. .PP \f[C]\-\-no\-incremental\f[] .PP Marks the build as unsafe for incremental build. -This turns off incremental compilation and forces a clean rebuild of the project's dependency graph. +This flag turns off incremental compilation and forces a clean rebuild of the project's dependency graph. .PP \f[C]\-o|\-\-output\ \f[] .PP diff --git a/Documentation/manpages/sdk/dotnet-clean.1 b/Documentation/manpages/sdk/dotnet-clean.1 index a95fbe7b8..4789e11bf 100644 --- a/Documentation/manpages/sdk/dotnet-clean.1 +++ b/Documentation/manpages/sdk/dotnet-clean.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.1.3 +.\" Automatically generated by Pandoc 2.2.1 .\" .TH "dotnet clean command \- .NET Core CLI" "1" "" "" ".NET Core" .hy diff --git a/Documentation/manpages/sdk/dotnet-compile-native.1 b/Documentation/manpages/sdk/dotnet-compile-native.1 deleted file mode 100644 index 17b4fed31..000000000 --- a/Documentation/manpages/sdk/dotnet-compile-native.1 +++ /dev/null @@ -1,125 +0,0 @@ -.\" Automatically generated by Pandoc 1.15.1 -.\" -.hy -.TH "dotnet-native" "1" "January 2016" "" "" -.SH NAME -.PP -dotnet\-compile\-native \-\- Compiles IL binaries to native binaries. -.SH SYNOPSIS -.PP -dotnet compile [\-\-appdepsdk] [\-\-configuration] [\-\-ilcargs] -[\-\-linklib] [\-\-logpath] [\-\-mode] [\-\-out] [\-\-reference] -[\-\-temp\-out] [\-\-verbose] -.SH DESCRIPTION -.PP -The \f[C]compile\-native\f[] command compiles IL assemblies to native -machine code. -It is used by \f[C]dotnet\-compile\ \-\-native\f[]. -.PP -The output is a native exe that conforms to the architecture of the -underlying operating system (i.e. -running on 64\-bit OS will produce a native 64\-bit exe). -This can be overriden via the \-\-arch switch and specifying the wanted -architecture. -The executable has a default extension of "" on Linux and OS X and -".exe" on Windows. -The source must include a `static void Main(string[] args) entry point -and specify compilationOptions.emitEntryPoint in the project.json. -.PP -Output files are written to the child \f[C]bin\f[] folder, which will be -created if it doesn\[aq]t exist. -Files will be overwritten as needed. -.SH OPTIONS -.PP -\f[C]\-\-appdepsdk\ \f[] -.IP -.nf -\f[C] -Path\ to\ custom\ AppDepSDK -\f[] -.fi -.PP -\f[C]\-c,\ \-\-configuration\ [debug|release]\f[] -.IP -.nf -\f[C] -Build\ configuration.\ Defaults\ to\ `debug`. -\f[] -.fi -.PP -\f[C]\-\-ilcargs\ \f[] -.IP -.nf -\f[C] -Custom\ arguments\ for\ the\ IL\ Compiler. -\f[] -.fi -.PP -\f[C]\-\-ilcpath\ \f[] -.IP -.nf -\f[C] -Path\ to\ a\ custom\ ilc.exe -\f[] -.fi -.PP -\f[C]\-\-linklib\ \f[] -.IP -.nf -\f[C] -Path\ to\ static\ lib\ to\ link -\f[] -.fi -.PP -\f[C]\-\-logpath\ \f[] -.IP -.nf -\f[C] -Enables\ logging\ and\ writes\ native\ compilation\ logs\ to\ the\ given\ path. -\f[] -.fi -.PP -\f[C]\-m,\ \-\-mode\ [cpp|ryujit|custom]\f[] -.IP -.nf -\f[C] -Code\ generation\ mode.\ Defaults\ to\ ryujit. -\f[] -.fi -.PP -\f[C]\-o,\ \-\-out\ directoryname\f[] -.IP -.nf -\f[C] -Output\ directory\ for\ the\ native\ executable. -\f[] -.fi -.PP -\f[C]\-r,\ \-\-reference\f[] -.IP -.nf -\f[C] -Path\ to\ a\ managed\ dll\ reference\ for\ the\ app. -\f[] -.fi -.PP -\f[C]\-t,\ \-\-temp\-out\f[] -.IP -.nf -\f[C] -Specifies\ temporary\ directory\ for\ intermediate\ files. -\f[] -.fi -.PP -\f[C]\-v,\ \-\-verbose\f[] -.IP -.nf -\f[C] -Prints\ verbose\ logging\ information,\ to\ follow\ the\ flow\ of\ execution\ of\ the\ command. -\f[] -.fi -.SH SEE ALSO -.PP -dotnet\-compile(1), dotnet(1), dotnet\-restore(1) -.SH AUTHORS -Zlatko Knezevic zlakne\@microsoft.com. diff --git a/Documentation/manpages/sdk/dotnet-compile.1 b/Documentation/manpages/sdk/dotnet-compile.1 deleted file mode 100644 index de2963110..000000000 --- a/Documentation/manpages/sdk/dotnet-compile.1 +++ /dev/null @@ -1,157 +0,0 @@ -.\" Automatically generated by Pandoc 1.15.1 -.\" -.hy -.TH "dotnet-compiler" "1" "January 2016" "" "" -.SH NAME -.PP -dotnet\-compile \-\- Compiles source files for a single project to a -binary format and saves to a target file. -.SH SYNOPSIS -.PP -dotnet compile [\-\-native] [\-\-output] [\-\-temp\-output] -[\-\-framework] [\-\-configuration] [\-\-output] [\-\-arch] [\-\-cpp] -[\-ilc\-args] [\-\-verbose] -.SH DESCRIPTION -.PP -The compile command compiles source files from a single project to a -binary file, either intermediate language (IL) byte code or native -machine code, depending on the options provided. -The default option is compilation to IL byte code, but may change in the -future. -Users who want to benefit from incremental builds and who want to -compile both the project and its dependencies should use the -dotnet\-build(1) command. -.PP -The result of compilation is by default an executable file that can be -ran. -Output files, are written to the child \f[C]bin\f[] folder, which will -be created if it doesn\[aq]t exist. -Files will be overwritten as needed. -The temporary files that are created during compilation are placed in -the child \f[C]obj\f[] folder. -.PP -The executables also require a special configuration section in -project.json: -.IP -.nf -\f[C] -{\ -\ \ \ \ "compilationOptions":\ { -\ \ \ \ \ \ "emitEntryPoint":\ true -\ \ \ \ } -} -\f[] -.fi -.PP -The default native [\-\-native] output is a native exe that conforms to -the architecture of the underlying operating system (i.e. -running on 64\-bit OS will produce a native 64\-bit exe). -This can be overriden via the \-\-arch switch and specifying the wanted -architecture. -The executable has a default extension of "" on Linux and OS X and -".exe" on Windows. -The source must include a static void main entry point, or it is an -error, unless otherwise specified in the project.json. -The dynamic library [dylib] output option has the default extension of -".so" on Linux/UNIX, ".dynlib" on OS X and ".dll" on Windows. -The static library [staticlib] option has the default extension of ".a" -on Linux, UNIX and OS X and ".lib" on Windows. -.PP -This command relies on the following artifacts: source files, -project.json project file and the "lock" file (project.lock.json). -Prior to invoking dotnet\-compile, dotnet\-restore(1) should be run to -restore any dependencies that are needed for the application. -.SH OPTIONS -.PP -\f[C]\-n,\ \-\-native\f[] -.IP -.nf -\f[C] -Compiles\ source\ to\ native\ machine\ code,\ for\ the\ local\ machine.\ The\ default\ is\ a\ native\ executable.\ The\ default\ executable\ extension\ is\ no\ extension\ and\ ".exe"\ on\ Windows. -\f[] -.fi -.PP -\f[C]\-t,\ \-\-temp\-output\ \f[] -.IP -.nf -\f[C] -Path\ where\ to\ drop\ the\ temporary\ binaries\ that\ are\ produced\ during\ compile.\ By\ default,\ the\ temporary\ binaries\ are\ dropped\ in\ the\ `obj`\ directory\ in\ the\ directory\ where\ `project.json`\ files\ lives,\ that\ is,\ where\ the\ application\ lives.\ \ -\f[] -.fi -.PP -\f[C]\-f,\ \-\-framework\ \f[] -.IP -.nf -\f[C] -Compile\ the\ application\ for\ the\ specified\ framework.\ If\ the\ framework\ is\ not\ specified,\ one\ specified\ in\ `project.json`\ will\ be\ used.\ -\f[] -.fi -.PP -\f[C]\-c,\ \-\-configuration\ \f[] -.IP -.nf -\f[C] -Compile\ the\ application\ under\ the\ specified\ configuration.\ If\ not\ specified,\ the\ configuration\ will\ default\ to\ "Debug".\ \ -\f[] -.fi -.PP -\f[C]\-o,\ \-\-output\ filename\f[] -.IP -.nf -\f[C] -Specifies\ the\ filename\ to\ be\ used.\ By\ default,\ the\ resulting\ filename\ will\ be\ the\ same\ as\ the\ project\ name\ specified\ in\ `project.json`,\ if\ one\ exists,\ or\ the\ directory\ in\ which\ the\ source\ files\ reside.\ -\f[] -.fi -.PP -\f[C]\-\-no\-project\-dependencies\f[] -.IP -.nf -\f[C] -Skips\ building\ cross\-project\ references.\ The\ effect\ of\ this\ is\ that\ only\ the\ current\ project\ will\ be\ built.\ -\f[] -.fi -.PP -\f[C]\-a,\ \-\-arch\f[] -.IP -.nf -\f[C] -The\ architecture\ for\ which\ to\ compile.\ x64\ only\ currently\ supported. -\f[] -.fi -.PP -\f[C]\-\-ilc\-args\ \f[] -.IP -.nf -\f[C] -Specified\ parameters\ are\ passed\ through\ to\ ILC\ and\ are\ used\ by\ the\ engine\ when\ doing\ native\ compilation.\ -\f[] -.fi -.PP -\f[C]\-\-cpp\f[] -.IP -.nf -\f[C] -Specify\ the\ C++\ code\ generator\ to\ do\ native\ compilation\ of\ code\ instead\ of\ the\ default\ RyuJIT.\ \ \ \ \ \ \ -\f[] -.fi -.PP -\f[C]\-v,\ \-\-verbose\f[] -.IP -.nf -\f[C] -Prints\ verbose\ logging\ information,\ to\ follow\ the\ flow\ of\ execution\ of\ the\ command. -\f[] -.fi -.PP -\f[C]\-h,\ \-\-help\f[] -.IP -.nf -\f[C] -Show\ short\ help.\ -\f[] -.fi -.SH SEE ALSO -.PP -dotnet\-restore(1), dotnet\-publish(1), dotnet(1) -.SH AUTHORS -Zlatko Knezevic zlakne\@microsoft.com. diff --git a/Documentation/manpages/sdk/dotnet-help.1 b/Documentation/manpages/sdk/dotnet-help.1 index 0a1b4eb6c..433ab81e3 100644 --- a/Documentation/manpages/sdk/dotnet-help.1 +++ b/Documentation/manpages/sdk/dotnet-help.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.1.3 +.\" Automatically generated by Pandoc 2.2.1 .\" .TH "dotnet help command \- .NET Core CLI" "1" "" "" ".NET Core" .hy diff --git a/Documentation/manpages/sdk/dotnet-install-script.1 b/Documentation/manpages/sdk/dotnet-install-script.1 index d7717db09..3b01fd619 100644 --- a/Documentation/manpages/sdk/dotnet-install-script.1 +++ b/Documentation/manpages/sdk/dotnet-install-script.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.1.3 +.\" Automatically generated by Pandoc 2.2.1 .\" .TH "dotnet\-install scripts" "1" "" "" ".NET Core" .hy diff --git a/Documentation/manpages/sdk/dotnet-list-reference.1 b/Documentation/manpages/sdk/dotnet-list-reference.1 index 0d961002a..849bb70a7 100644 --- a/Documentation/manpages/sdk/dotnet-list-reference.1 +++ b/Documentation/manpages/sdk/dotnet-list-reference.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.1.3 +.\" Automatically generated by Pandoc 2.2.1 .\" .TH "dotnet list reference command \- .NET Core CLI" "1" "" "" ".NET Core" .hy @@ -6,7 +6,7 @@ .PP .SH NAME .PP -\f[C]dotnet\ list\ reference\f[] \- Lists project to project references. +\f[C]dotnet\ list\ reference\f[] \- Lists project\-to\-project references. .SH SYNOPSIS .PP \f[C]dotnet\ list\ []\ reference\ [\-h|\-\-help]\f[] @@ -18,7 +18,7 @@ The \f[C]dotnet\ list\ reference\f[] command provides a convenient option to lis \f[C]PROJECT\f[] .PP Specifies the project file to use for listing references. -If not specified, the command will search the current directory for a project file. +If not specified, the command searches the current directory for a project file. .SH OPTIONS .PP \f[C]\-h|\-\-help\f[] diff --git a/Documentation/manpages/sdk/dotnet-migrate.1 b/Documentation/manpages/sdk/dotnet-migrate.1 index dd5de60b1..a649e6895 100644 --- a/Documentation/manpages/sdk/dotnet-migrate.1 +++ b/Documentation/manpages/sdk/dotnet-migrate.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.1.3 +.\" Automatically generated by Pandoc 2.2.1 .\" .TH "dotnet migrate command \- .NET Core CLI" "1" "" "" ".NET Core" .hy @@ -8,8 +8,13 @@ .PP \f[C]dotnet\ migrate\f[] \- Migrates a Preview 2 .NET Core project to a .NET Core SDK 1.0 project. .SH SYNOPSIS -.PP -\f[C]dotnet\ migrate\ []\ [\-t|\-\-template\-file]\ [\-v|\-\-sdk\-package\-version]\ [\-x|\-\-xproj\-file]\ [\-s|\-\-skip\-project\-references]\ [\-r|\-\-report\-file]\ [\-\-format\-report\-file\-json]\ [\-\-skip\-backup]\ [\-h|\-\-help]\f[] +.IP +.nf +\f[C] +dotnet\ migrate\ []\ [\-\-format\-report\-file\-json]\ [\-r|\-\-report\-file]\ [\-s|\-\-skip\-project\-references]\ [\-\-skip\-backup]\ [\-t|\-\-template\-file]\ [\-v|\-\-sdk\-package\-version]\ [\-x|\-\-xproj\-file] +dotnet\ migrate\ [\-h|\-\-help] +\f[] +.fi .SH DESCRIPTION .PP The \f[C]dotnet\ migrate\f[] command migrates a valid Preview 2 \f[I]project.json\f[]\-based project to a valid .NET Core SDK 1.0 \f[I]csproj\f[] project. @@ -17,7 +22,7 @@ The \f[C]dotnet\ migrate\f[] command migrates a valid Preview 2 \f[I]project.jso By default, the command migrates the root project and any project references that the root project contains. This behavior is disabled using the \f[C]\-\-skip\-project\-references\f[] option at runtime. .PP -Migration is performed on the following: +Migration can be performed on the following assets: .IP \[bu] 2 A single project by specifying the \f[I]project.json\f[] file to migrate. .IP \[bu] 2 @@ -25,7 +30,7 @@ All of the directories specified in the \f[I]global.json\f[] file by passing in .IP \[bu] 2 A \f[I]solution.sln\f[] file, where it migrates the projects referenced in the solution. .IP \[bu] 2 -On all sub\-directories of the given directory recursively. +On all subdirectories of the given directory recursively. .PP The \f[C]dotnet\ migrate\f[] command keeps the migrated \f[I]project.json\f[] file inside a \f[C]backup\f[] directory, which it creates if the directory doesn't exist. This behavior is overridden using the \f[C]\-\-skip\-backup\f[] option. @@ -44,19 +49,36 @@ The path to one of the following: .IP \[bu] 2 a \f[I]project.json\f[] file to migrate. .IP \[bu] 2 -a \f[I]global.json\f[] file, it will migrate the folders specified in \f[I]global.json\f[]. +a \f[I]global.json\f[] file: the folders specified in \f[I]global.json\f[] are migrated. .IP \[bu] 2 -a \f[I]solution.sln\f[] file, it will migrate the projects referenced in the solution. +a \f[I]solution.sln\f[] file: the projects referenced in the solution are migrated. .IP \[bu] 2 -a directory to migrate, it will recursively search for \f[I]project.json\f[] files to migrate. +a directory to migrate: recursively searches for \f[I]project.json\f[] files to migrate inside the specified directory. .PP Defaults to current directory if nothing is specified. .SH OPTIONS .PP +\f[C]\-\-format\-report\-file\-json\ \f[] +.PP +Output migration report file as JSON rather than user messages. +.PP \f[C]\-h|\-\-help\f[] .PP Prints out a short help for the command. .PP +\f[C]\-r|\-\-report\-file\ \f[] +.PP +Output migration report to a file in addition to the console. +.PP +\f[C]\-s|\-\-skip\-project\-references\ [Debug|Release]\f[] +.PP +Skip migrating project references. +By default, project references are migrated recursively. +.PP +\f[C]\-\-skip\-backup\f[] +.PP +Skip moving \f[I]project.json\f[], \f[I]global.json\f[], and \f[I]*.xproj\f[] to a \f[C]backup\f[] directory after successful migration. +.PP \f[C]\-t|\-\-template\-file\ \f[] .PP Template csproj file to use for migration. @@ -71,23 +93,6 @@ The default is the version of the SDK in \f[C]dotnet\ new\f[]. .PP The path to the xproj file to use. Required when there is more than one xproj in a project directory. -.PP -\f[C]\-s|\-\-skip\-project\-references\ [Debug|Release]\f[] -.PP -Skip migrating project references. -By default, project references are migrated recursively. -.PP -\f[C]\-r|\-\-report\-file\ \f[] -.PP -Output migration report to a file in addition to the console. -.PP -\f[C]\-\-format\-report\-file\-json\ \f[] -.PP -Output migration report file as JSON rather than user messages. -.PP -\f[C]\-\-skip\-backup\f[] -.PP -Skip moving \f[I]project.json\f[], \f[I]global.json\f[], and \f[I]*.xproj\f[] to a \f[C]backup\f[] directory after successful migration. .SH EXAMPLES .PP Migrate a project in the current directory and all of its project\-to\-project dependencies: diff --git a/Documentation/manpages/sdk/dotnet-msbuild.1 b/Documentation/manpages/sdk/dotnet-msbuild.1 index 7e86576a4..ecd93ca15 100644 --- a/Documentation/manpages/sdk/dotnet-msbuild.1 +++ b/Documentation/manpages/sdk/dotnet-msbuild.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 2.1.3 +.\" Automatically generated by Pandoc 2.2.1 .\" .TH "dotnet msbuild command \- .NET Core CLI" "1" "" "" ".NET Core" .hy @@ -16,7 +16,7 @@ The \f[C]dotnet\ msbuild\f[] command allows access to a fully functional MSBuild .PP The command has the exact same capabilities as existing MSBuild command\-line client. The options are all the same. -Use the MSBuild Command\-Line Reference to obtain information on the available options. +For more information about the available options, see the MSBuild Command\-Line Reference. .SH EXAMPLES .PP Build a project and its dependencies: diff --git a/Documentation/manpages/sdk/dotnet-new.1 b/Documentation/manpages/sdk/dotnet-new.1 index f1242f3c1..897b6b508 100644 --- a/Documentation/manpages/sdk/dotnet-new.1 +++ b/Documentation/manpages/sdk/dotnet-new.1 @@ -1,5 +1,5 @@ .\"t -.\" Automatically generated by Pandoc 2.1.3 +.\" Automatically generated by Pandoc 2.2.1 .\" .TH "dotnet new command \- .NET Core CLI" "1" "" "" ".NET Core" .hy @@ -9,6 +9,16 @@ .PP \f[C]dotnet\ new\f[] \- Creates a new project, configuration file, or solution based on the specified template. .SH SYNOPSIS +.SS .NET Core 2.1 +.IP +.nf +\f[C] +dotnet\ new\