History

Piotr Puszkiewicz 459e5bdeda Merge pull request #761 from cdmihai/buildCommandSelfhostIncremental Building CLI is incremental		2016-01-12 15:33:46 -08:00
..
Microsoft.DotNet.Tools.Run.xproj	command line interface clean-up	2015-11-01 21:08:01 -08:00
Program.cs	Handling help and error manually to prevent a call to Environment.FailFast call in System.CommandLine	2015-12-18 10:30:04 -08:00
project.json	Merge pull request #761 from cdmihai/buildCommandSelfhostIncremental	2016-01-12 15:33:46 -08:00
README.md	Responding to PR feedback	2016-01-06 19:21:36 -08:00
RunCommand.cs	Extract build from compile	2015-12-23 17:31:47 -08:00

README.md

% DOTNET-RUN(1) % Zlatko Knezevic zlakne@microsoft.com % January 2016

NAME

dotnet-run -- Runs source code 'in-place' without any explicit compile or launch commands.

SYNOPSIS

dotnet run [--verbose]

DESCRIPTION

The run command provides a convenient option to run source code with one command. It compiles source code, generates an output program and then runs that program. This command is useful for fast iterative development and can also be used to run a source-distributed program (e.g. website).

This command relies on dotnet-compile(1) to compile source inputs to a .NET assembly, before launching the program. The requirements for and handling of source inputs for this command are all inherited from the compile command. The documentation for the compile command provides more information on those requirements.

Output files, are written to the child bin folder, which will be created if it doesn't exist. Files will be overwritten as needed. Temporary files are written to the child obj folder.

OPTIONS

-v, --verbose

Prints verbose logging information, to follow the flow of execution of the command.

ENVIRONMENT

DOTNET_HOME

Points to the base directory that contains the runtime and the binaries directories. The runtime will be used to run the executable file that is dropped after compiling. Not needed for native compilation.