Skip to content

[automated] Update man pages #50306

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 27 additions & 4 deletions documentation/manpages/sdk/dotnet-nuget-locals.1
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
. ftr VB CB
. ftr VBI CBI
.\}
.TH "dotnet-nuget-locals" "1" "2025-06-13" "" ".NET Documentation"
.TH "dotnet-nuget-locals" "1" "2025-08-15" "" ".NET Documentation"
.hy
.SH dotnet nuget locals
.PP
Expand Down Expand Up @@ -42,7 +42,7 @@ The \f[V]dotnet nuget locals\f[R] command clears or lists local NuGet resources
The cache location to list or clear.
It accepts one of the following values:
.IP \[bu] 2
\f[V]all\f[R] - Indicates that the specified operation is applied to all cache types: http-request cache, global packages cache, and the temporary cache.
\f[V]all\f[R] - Indicates that the specified operation is applied to all cache types: http-request cache, global packages cache, temporary cache, and plugins cache.
.IP \[bu] 2
\f[V]http-cache\f[R] - Indicates that the specified operation is applied only to the http-request cache.
The other cache locations aren\[cq]t affected.
Expand All @@ -52,6 +52,9 @@ The other cache locations aren\[cq]t affected.
.IP \[bu] 2
\f[V]temp\f[R] - Indicates that the specified operation is applied only to the temporary cache.
The other cache locations aren\[cq]t affected.
.IP \[bu] 2
\f[V]plugins-cache\f[R] - Indicates that the specified operation is applied only to the plugins cache.
The other cache locations aren\[cq]t affected.
.RE
.SH OPTIONS
.IP \[bu] 2
Expand Down Expand Up @@ -83,7 +86,7 @@ The list option is used to display the location of the specified cache type.
.RE
.SH EXAMPLES
.IP \[bu] 2
Displays the paths of all the local cache directories (http-cache directory, global-packages cache directory, and temporary cache directory):
Displays the paths of all the local cache directories (http-cache directory, global-packages cache directory, temporary cache directory, and plugins cache directory):
.RS 2
.IP
.nf
Expand All @@ -103,7 +106,17 @@ dotnet nuget locals http-cache --list
.fi
.RE
.IP \[bu] 2
Clears all files from all local cache directories (http-cache directory, global-packages cache directory, and temporary cache directory):
Displays the path for the local plugins cache directory:
.RS 2
.IP
.nf
\f[C]
dotnet nuget locals plugins-cache --list
\f[R]
.fi
.RE
.IP \[bu] 2
Clears all files from all local cache directories (http-cache directory, global-packages cache directory, temporary cache directory, and plugins cache directory):
.RS 2
.IP
.nf
Expand Down Expand Up @@ -132,6 +145,16 @@ dotnet nuget locals temp -c
\f[R]
.fi
.RE
.IP \[bu] 2
Clears all files in local plugins cache directory:
.RS 2
.IP
.nf
\f[C]
dotnet nuget locals plugins-cache -c
\f[R]
.fi
.RE
.SS Troubleshooting
.PP
For information on common problems and errors while using the \f[V]dotnet nuget locals\f[R] command, see Managing the NuGet cache.
10 changes: 8 additions & 2 deletions documentation/manpages/sdk/dotnet-nuget-push.1
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
. ftr VB CB
. ftr VBI CBI
.\}
.TH "dotnet-nuget-push" "1" "2025-06-13" "" ".NET Documentation"
.TH "dotnet-nuget-push" "1" "2025-08-15" "" ".NET Documentation"
.hy
.SH dotnet nuget push
.PP
Expand All @@ -26,7 +26,7 @@ dotnet-nuget-push - Pushes a package to the server and publishes it.
.IP
.nf
\f[C]
dotnet nuget push [<ROOT>] [-d|--disable-buffering] [--force-english-output]
dotnet nuget push [<ROOT>] [--allow-insecure-connections] [-d|--disable-buffering] [--force-english-output]
[--interactive] [-k|--api-key <API_KEY>] [-n|--no-symbols]
[--no-service-endpoint] [-s|--source <SOURCE>] [--skip-duplicate]
[-sk|--symbol-api-key <API_KEY>] [-ss|--symbol-source <SOURCE>]
Expand Down Expand Up @@ -73,6 +73,12 @@ Specifies the file path to the package to be pushed.
.RE
.SH OPTIONS
.IP \[bu] 2
\f[B]\f[VB]--allow-insecure-connections\f[B]\f[R]
.RS 2
.PP
Allows pushing to HTTP sources (insecure).
.RE
.IP \[bu] 2
\f[B]\f[VB]-d|--disable-buffering\f[B]\f[R]
.RS 2
.PP
Expand Down
20 changes: 11 additions & 9 deletions documentation/manpages/sdk/dotnet-nuget-sign.1
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
. ftr VB CB
. ftr VBI CBI
.\}
.TH "dotnet-nuget-sign" "1" "2025-06-13" "" ".NET Documentation"
.TH "dotnet-nuget-sign" "1" "2025-08-15" "" ".NET Documentation"
.hy
.SH dotnet nuget sign
.PP
Expand Down Expand Up @@ -49,8 +49,8 @@ The \f[V]dotnet nuget sign\f[R] command signs all the packages matching the firs
The certificate with the private key can be obtained from a file or from a certificate installed in a certificate store by providing a subject name or a SHA-1 fingerprint.
.RS
.PP
This command requires a certificate root store that is valid for both code signing and timestamping.
Also, this command may not be supported on some combinations of operating system and .NET SDK.
This command requires a certificate root store that\[cq]s valid for both code signing and timestamping.
Also, this command might not be supported on some combinations of operating system and .NET SDK.
For more information, see NuGet signed package verification.
.RE
.SH ARGUMENTS
Expand Down Expand Up @@ -108,9 +108,11 @@ If there are multiple matching certificates in the result, or no matching certif
Specifies the fingerprint of the certificate used to search a local certificate store for the certificate.
.PP
Starting with .NET 9, this option can be used to specify the SHA-1, SHA-256, SHA-384, or SHA-512 fingerprint of the certificate.
However, a \f[V]NU3043\f[R] warning is raised when a SHA-1 certificate fingerprint is used because it is no longer considered secure.
However, a \f[V]NU3043\f[R] warning is raised when a SHA-1 certificate fingerprint is used because it\[cq]s no longer considered secure.
In .NET 10 and later versions, the warning is elevated to an error.
Only SHA-2 family fingerprints (SHA-256, SHA-384, and SHA-512) are supported.
.PP
All the previous versions of the .NET SDK continue to accept only SHA-1 certificate fingerprint.
All pre-.NET 9 versions of the .NET SDK continue to accept only SHA-1 certificate fingerprint.
.RE
.IP \[bu] 2
\f[B]\f[VB]--certificate-password <PASSWORD>\f[B]\f[R]
Expand Down Expand Up @@ -196,12 +198,12 @@ dotnet nuget sign foo.nupkg --certificate-path cert.pfx --certificate-password p
.fi
.RE
.IP \[bu] 2
Sign \f[I]foo.nupkg\f[R] with certificate (password protected) matches with the specified SHA-1 fingerprint in the default certificate store (CurrentUser):
Sign \f[I]foo.nupkg\f[R] with certificate (password protected) matches with the specified SHA-256 fingerprint in the default certificate store (CurrentUser):
.RS 2
.IP
.nf
\f[C]
dotnet nuget sign foo.nupkg --certificate-fingerprint 89967D1DD995010B6C66AE24FF8E66885E6E03A8 --certificate-password password
dotnet nuget sign foo.nupkg --certificate-fingerprint B2C40F2F8775D7B7EBEB76BD5A9D3A4BC3F4B8A4D8D7C5F8A4C6B3E7A9E2D5F1 --certificate-password password
\f[R]
.fi
.RE
Expand All @@ -216,12 +218,12 @@ dotnet nuget sign foo.nupkg --certificate-subject-name \[dq]Test certificate for
.fi
.RE
.IP \[bu] 2
Sign \f[I]foo.nupkg\f[R] with certificate (password protected) matches with the specified SHA-1 fingerprint in the certificate store CurrentUser:
Sign \f[I]foo.nupkg\f[R] with certificate (password protected) matches with the specified SHA-256 fingerprint in the certificate store CurrentUser:
.RS 2
.IP
.nf
\f[C]
dotnet nuget sign foo.nupkg --certificate-fingerprint 89967D1DD995010B6C66AE24FF8E66885E6E03A8 --certificate-password password --certificate-store-location CurrentUser --certificate-store-name Root
dotnet nuget sign foo.nupkg --certificate-fingerprint B2C40F2F8775D7B7EBEB76BD5A9D3A4BC3F4B8A4D8D7C5F8A4C6B3E7A9E2D5F1 --certificate-password password --certificate-store-location CurrentUser --certificate-store-name Root
\f[R]
.fi
.RE
Expand Down
4 changes: 2 additions & 2 deletions documentation/manpages/sdk/dotnet-reference-remove.1
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
. ftr VB CB
. ftr VBI CBI
.\}
.TH "dotnet-reference-remove" "1" "2025-06-13" "" ".NET Documentation"
.TH "dotnet-reference-remove" "1" "2025-08-15" "" ".NET Documentation"
.hy
.SH dotnet reference remove
.PP
Expand All @@ -24,7 +24,7 @@
dotnet-reference-remove - Removes project-to-project (P2P) references.
.RS
.PP
If you\[cq]re using .NET 9 SDK or earlier, use the \[lq]verb first\[rq] form (dotnet-reference-remove) instead.
If you\[cq]re using .NET 9 SDK or earlier, use the \[lq]verb first\[rq] form (dotnet-remove-reference) instead.
The \[lq]noun first\[rq] form was introduced in .NET 10.
For more information, see More consistent command order.
.RE
Expand Down
15 changes: 14 additions & 1 deletion documentation/manpages/sdk/dotnet-tool-install.1
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
. ftr VB CB
. ftr VBI CBI
.\}
.TH "dotnet-tool-install" "1" "2025-07-30" "" ".NET Documentation"
.TH "dotnet-tool-install" "1" "2025-08-15" "" ".NET Documentation"
.hy
.SH dotnet tool install
.PP
Expand Down Expand Up @@ -65,6 +65,11 @@ To install a global tool in the default location, use the \f[V]--global\f[R] opt
To install a global tool in a custom location, use the \f[V]--tool-path\f[R] option.
.IP \[bu] 2
To install a local tool, omit the \f[V]--global\f[R] and \f[V]--tool-path\f[R] options.
.RS
.PP
[!WARNING] Make sure the directory you specify with the \f[V]--tool-path\f[R] option is secure.
Tools installed in this location can be executed directly, so using an untrusted or shared path might introduce security risks.
.RE
.SS Installation locations
.SS Global tools
.PP
Expand Down Expand Up @@ -187,6 +192,14 @@ If one is found, create the manifest in that directory.
If neither of the previous two steps finds a directory, create the manifest in the current working directory.
.PP
For more information on how manifests are located, see Install a local tool.
.PP
Starting in .NET 10, this flag is applied automatically if no tools manifest is found.
.RS
.PP
[!WARNING] Don\[cq]t run tool commands from the \f[B]Downloads\f[R] folder or any shared location.
The CLI walks up the directory tree to find a tool manifest, which might cause it to use a manifest you don\[cq]t expect.
Always run tool commands from a trusted, project-specific directory.
.RE
.RE
.IP \[bu] 2
\f[B]\f[VB]--disable-parallel\f[B]\f[R]
Expand Down