mirrors/dotnet-installer
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
dotnet-installer/src/dotnet/commands/dotnet-publish/README.md

87 lines
3 KiB
Markdown
Raw Normal View History

Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
% DOTNET-PUBLISH(1)
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
% Microsoft Corporation dotnetclifeedback@microsoft.com
% April 2016
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
## NAME
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
`dotnet-publish` - packs the application and all of its dependencies into a folder getting it ready for publishing
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
## SYNOPSIS
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
dotnet-publish [--framework]
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
[--runtime] [--build-base-path] [--output]
[--version-suffix] [--configuration]
Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
[< project >]
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
## DESCRIPTION
`dotnet-publish` compiles the application, reads through its dependencies specified in `project.json` and publishes the resulting set of files to a directory.
Depending on the type of portable app, the directory contains the following:
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
1. **Portable application** - application's intermediate language (IL) code and all of application's managed dependencies.
* **Portable application with native dependencies** - as above with a sub-directory for each native dependencies'
supported platform.
2. **Self-contained application** - as above as well as the entire runtime for the targeted platform.
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
The above types are covered in more details in the [types of portable applications](app-types.md) document.
Update formatting on Publish/Readme.md Line breaks where they were missing (after headings and before lists). Commands in `code` format. Filenames and paths in _italics_ Indenting done with using the &gt; (as white space is ignored)
2015-12-02 22:37:37 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
## OPTIONS
Update dotnet-publish README.md Update the README.md for dotnet-publish and add the information about the Microsoft.NETCore.Runtime dependency. Fixes #289 /cc @brthor @Sridhar-MS
2015-12-21 20:23:46 +00:00
Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
`[project]`
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
`dotnet-publish` needs access to `project.json` to work. If it is not specified on invocation via [project],
`project.json` in the current directory will be the default.
If no `project.json` can be found, `dotnet-publish` will error out.
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Update formatting on Publish/Readme.md Line breaks where they were missing (after headings and before lists). Commands in `code` format. Filenames and paths in _italics_ Indenting done with using the &gt; (as white space is ignored)
2015-12-02 22:37:37 +00:00
`-f`, `--framework` [FID]
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
Publish the application for a given framework identifier (FID). If not specified, FID is read from `project.json`. In case of no valid framework found, the command will error out. In case of multiple valid frameworks found, the command will publish for all valid frameworks.
Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
Update formatting on Publish/Readme.md Line breaks where they were missing (after headings and before lists). Commands in `code` format. Filenames and paths in _italics_ Indenting done with using the &gt; (as white space is ignored)
2015-12-02 22:37:37 +00:00
`-r`, `--runtime` [RID]
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
Publish the application for a given runtime.
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
`-b`, `--build-base-path` [DIR]
Directory in which to place temporary outputs
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Update formatting on Publish/Readme.md Line breaks where they were missing (after headings and before lists). Commands in `code` format. Filenames and paths in _italics_ Indenting done with using the &gt; (as white space is ignored)
2015-12-02 22:37:37 +00:00
`-o`, `--output`
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
Specify the path where to place the directory. If not specified, will default to _./bin/[configuration]/[framework]/_
for portable applications. For self-contained applications, will default to _./bin/[configuration]/[framework]/[runtime]_
--version-suffix [VERSION_SUFFIX]
Defines what `*` should be replaced with in the version field in project.json.
Update formatting on Publish/Readme.md Line breaks where they were missing (after headings and before lists). Commands in `code` format. Filenames and paths in _italics_ Indenting done with using the &gt; (as white space is ignored)
2015-12-02 22:37:37 +00:00
`-c`, `--configuration [Debug|Release]`
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
Configuration to use when publishing. If not specified, will default to "Debug".
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
## EXAMPLES
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
`dotnet publish`
Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
Publish an application using the framework found in `project.json`. If `project.json` contains `runtimes` node, publish
for the RID of the current platform.
Update formatting on Publish/Readme.md Line breaks where they were missing (after headings and before lists). Commands in `code` format. Filenames and paths in _italics_ Indenting done with using the &gt; (as white space is ignored)
2015-12-02 22:37:37 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
`dotnet publish ~/projects/app1/project.json`
Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
Publish the application using the specified `project.json`.
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
`dotnet publish --framework netcoreapp1.0`
Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
Publish the current application using the `netcoreapp1.0` framework.
Add MD files per command and documentation directory Add README.md files with the contents of the "man pages" per directory that implements all or part of the command. This way, we will enable easier perusal of our repo as well as have an initial set of documentation published. Add "documentation" directory as well for future work.
2015-11-16 14:37:00 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
`dotnet publish --framework netcoreapp1.0 --runtime osx.10.11-x64`
Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
Publish the current application using the `netcoreapp1.0` framework and runtime for `OS X 10.10`. This RID has to
exist in the `project.json` `runtimes` node.
Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
Add and modify commands' README files (#2338) * Add and modify commands' README files Update those READMEs that are outdated. Add READMEs for dotnet pack and dotnet restore as well. * Removing private info, adding feedback alias
2016-04-15 17:36:31 +00:00
## SEE ALSO
Update formatting on Publish/Readme.md Line breaks where they were missing (after headings and before lists). Commands in `code` format. Filenames and paths in _italics_ Indenting done with using the &gt; (as white space is ignored)
2015-12-02 22:37:37 +00:00
Fix README.md files to be like man pages Change the SYNOPSIS section. Add ENVIRONMENT section where needed. Change the driver's man page to include all of the current commands. The MD files now conform to the man pages outline. The manpages are updated as well. Fix #673
2016-01-05 02:25:15 +00:00
dotnet-restore(1), dotnet-compile(1)
Reference in a new issue Copy permalink