Skip to content

Commit 3937765

Browse files
authored
Specify the version file-based programs are available in.
1 parent d5fe494 commit 3937765

File tree

5 files changed

+33
-23
lines changed

5 files changed

+33
-23
lines changed

docs/core/tools/dotnet-build.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -79,11 +79,11 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev
7979

8080
The project or solution or C# (file-based program) file to publish. If a file isn't specified, MSBuild searches the current directory for a project or solution.
8181

82-
* `PROJECT` is the path and filename of a C#, F#, or Visual Basic project file, or the path to a directory that contains a C#, F#, or Visual Basic project file.
82+
- `PROJECT` is the path and filename of a C#, F#, or Visual Basic project file, or the path to a directory that contains a C#, F#, or Visual Basic project file.
8383

84-
* `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file.
84+
- `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file.
8585

86-
* `FILE` is the path and filename of a file-based program. Files-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
86+
- `FILE` is an argument added in .NET 10. The path and filename of a file-based program. File-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
8787

8888
## Options
8989

@@ -184,7 +184,9 @@ The project or solution or C# (file-based program) file to publish. If a file is
184184

185185
```dotnetcli
186186
dotnet build MyProject.cs
187-
```
187+
```
188+
189+
File-based program support was added in .NET SDK 10.0.100.
188190

189191
- Build a project and its dependencies using Release configuration:
190192

docs/core/tools/dotnet-clean.md

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -34,39 +34,39 @@ The `dotnet clean` command cleans the output of the previous build. It's impleme
3434

3535
The project or solution or C# (file-based program) file to publish. If a file isn't specified, MSBuild searches the current directory for a project or solution.
3636

37-
* `PROJECT` is the path and filename of a C#, F#, or Visual Basic project file, or the path to a directory that contains a C#, F#, or Visual Basic project file.
37+
- `PROJECT` is the path and filename of a C#, F#, or Visual Basic project file, or the path to a directory that contains a C#, F#, or Visual Basic project file.
3838

39-
* `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file.
39+
- `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file.
4040

41-
* `FILE` is the path and filename of a file-based program. Files-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
41+
- `FILE` is an argument added in .NET 10. The path and filename of a file-based program. File-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
4242

4343
## Options
4444

4545
[!INCLUDE [artifacts-path](../../../includes/cli-artifacts-path.md)]
4646

4747
[!INCLUDE [configuration](../../../includes/cli-configuration-clean.md)]
4848

49-
* **`-f|--framework <FRAMEWORK>`**
49+
- **`-f|--framework <FRAMEWORK>`**
5050

5151
The [framework](../../standard/frameworks.md) that was specified at build time. The framework must be defined in the [project file](../project-sdk/overview.md). If you specified the framework at build time, you must specify the framework when cleaning.
5252

5353
[!INCLUDE [help](../../../includes/cli-help.md)]
5454

5555
[!INCLUDE [interactive](../../../includes/cli-interactive-3-0.md)]
5656

57-
* **`--nologo`**
57+
- **`--nologo`**
5858

5959
Doesn't display the startup banner or the copyright message.
6060

61-
* **`-o|--output <OUTPUT_DIRECTORY>`**
61+
- **`-o|--output <OUTPUT_DIRECTORY>`**
6262

6363
The directory that contains the build artifacts to clean. Specify the `-f|--framework <FRAMEWORK>` switch with the output directory switch if you specified the framework when the project was built.
6464

6565
- .NET 7.0.200 SDK and later
6666

6767
If you specify the `--output` option when running this command on a solution, the CLI will emit a warning (an error in 7.0.200) due to the unclear semantics of the output path. The `--output` option is disallowed because all outputs of all built projects would be copied into the specified directory, which isn't compatible with multi-targeted projects, as well as projects that have different versions of direct and transitive dependencies. For more information, see [Solution-level `--output` option no longer valid for build-related commands](../compatibility/sdk/7.0/solution-level-output-no-longer-valid.md).
6868

69-
* **`-r|--runtime <RUNTIME_IDENTIFIER>`**
69+
- **`-r|--runtime <RUNTIME_IDENTIFIER>`**
7070

7171
Cleans the output folder of the specified runtime. This is used when a [self-contained deployment](../deploying/index.md#self-contained-deployment) was created.
7272

@@ -76,19 +76,21 @@ The project or solution or C# (file-based program) file to publish. If a file is
7676

7777
## Examples
7878

79-
* Clean a default build of the project:
79+
- Clean a default build of the project:
8080

8181
```dotnetcli
8282
dotnet clean
8383
```
8484

85-
* Clean a file-based program:
85+
- Clean a file-based program:
8686

8787
```dotnetcli
8888
dotnet clean Program.cs.
8989
```
9090

91-
* Clean a project built using the Release configuration:
91+
File-based program support was added in .NET SDK 10.0.100.
92+
93+
- Clean a project built using the Release configuration:
9294

9395
```dotnetcli
9496
dotnet clean --configuration Release

docs/core/tools/dotnet-publish.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -118,11 +118,11 @@ For more information, see the following resources:
118118

119119
The project or solution or C# (file-based program) file to publish. If a file isn't specified, MSBuild searches the current directory for a project or solution.
120120

121-
* `PROJECT` is the path and filename of a C#, F#, or Visual Basic project file, or the path to a directory that contains a C#, F#, or Visual Basic project file.
121+
- `PROJECT` is the path and filename of a C#, F#, or Visual Basic project file, or the path to a directory that contains a C#, F#, or Visual Basic project file.
122122

123-
* `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file.
123+
- `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file.
124124

125-
* `FILE` is the path and filename of a file-based program. Files-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
125+
- `FILE` is an argument added in .NET 10. The path and filename of a file-based program. File-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
126126

127127
## Options
128128

@@ -270,6 +270,8 @@ The project or solution or C# (file-based program) file to publish. If a file is
270270
dotnet publish app.cs
271271
```
272272

273+
File-based program support was added in .NET SDK 10.0.100.
274+
273275
## See also
274276

275277
- [.NET application publishing overview](../deploying/index.md)

docs/core/tools/dotnet-restore.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -90,11 +90,11 @@ There are three specific settings that `dotnet restore` ignores:
9090

9191
The project or solution or C# (file-based program) file to restore. If a file isn't specified, MSBuild searches the current directory for a project or solution.
9292

93-
* `PROJECT` is the path and filename of a C#, F#, or Visual Basic project file, or the path to a directory that contains a C#, F#, or Visual Basic project file. If the directory is not specified, it defaults to the current directory.
93+
- `PROJECT` is the path and filename of a C#, F#, or Visual Basic project file, or the path to a directory that contains a C#, F#, or Visual Basic project file. If the directory is not specified, it defaults to the current directory.
9494

95-
* `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file. If the directory is not specified, it defaults to the current directory.
95+
- `SOLUTION` is the path and filename of a solution file (*.sln* or *.slnx* extension), or the path to a directory that contains a solution file. If the directory is not specified, it defaults to the current directory.
9696

97-
* `FILE` is the path and filename of a file-based program. File-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
97+
- `FILE` is an argument added in .NET 10. The path and filename of a file-based program. File-based programs are contained within a single `*.cs` file that are built and run without a corresponding project (`*.csproj`) file. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
9898

9999
## Options
100100

@@ -190,19 +190,19 @@ The project or solution or C# (file-based program) file to restore. If a file is
190190
dotnet restore ./projects/app1/app1.csproj
191191
```
192192

193-
- Restore the dependencies and tools for the project in the current directory using the file path provided as the source:
193+
- Restore the dependencies and tools for the project in the current directory using the file path provided as the source:
194194

195195
```dotnetcli
196196
dotnet restore -s c:\packages\mypackages
197197
```
198198

199-
- Restore the dependencies and tools for the project in the current directory using the two file paths provided as sources:
199+
- Restore the dependencies and tools for the project in the current directory using the two file paths provided as sources:
200200

201201
```dotnetcli
202202
dotnet restore -s c:\packages\mypackages -s c:\packages\myotherpackages
203203
```
204204

205-
- Restore dependencies and tools for the project in the current directory showing detailed output:
205+
- Restore dependencies and tools for the project in the current directory showing detailed output:
206206

207207
```dotnetcli
208208
dotnet restore --verbosity detailed

docs/core/tools/dotnet-run.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,8 @@ To run the application, the `dotnet run` command resolves the dependencies of th
8585

8686
The path to the file-based program to run. This option can be passed as the first argument if there is no project in the current directory. For more information, see [Build file-based C# programs](/dotnet/csharp/fundamentals/tutorials/file-based-programs).
8787

88+
Introduced in .NET SDK 10.0.100.
89+
8890
- **`--force`**
8991

9092
Forces all dependencies to be resolved even if the last restore was successful. Specifying this flag is the same as deleting the *project.assets.json* file.
@@ -171,6 +173,8 @@ The environment is constructed in the same order as this list, so the `-e|--envi
171173
dotnet run ConsoleApp.cs -- arg1 arg2
172174
```
173175

176+
File-based program support was added in .NET SDK 10.0.100.
177+
174178
- Run the specified project:
175179

176180
```dotnetcli

0 commit comments

Comments
 (0)