diff --git a/docs/core/tools/dotnet-environment-variables.md b/docs/core/tools/dotnet-environment-variables.md index 141dcafcef2c3..cffc7a1168153 100644 --- a/docs/core/tools/dotnet-environment-variables.md +++ b/docs/core/tools/dotnet-environment-variables.md @@ -217,7 +217,6 @@ This section describes the following environment variables: - [`DOTNET_SKIP_WORKLOAD_INTEGRITY_CHECK`](#dotnet_skip_workload_integrity_check) - [`DOTNET_TOOLS_ALLOW_MANIFEST_IN_ROOT`](#dotnet_tools_allow_manifest_in_root) - [`DOTNET_HOST_TRACE`](#dotnet_host_trace) -- [`COREHOST_TRACE`](#corehost_trace) - [`SuppressNETCoreSdkPreviewMessage`](#suppressnetcoresdkpreviewmessage) - [Configure MSBuild in the .NET CLI](#configure-msbuild-in-the-net-cli) - [`DOTNET_NEW_PREFERRED_LANG`](#dotnet_new_preferred_lang) @@ -447,10 +446,11 @@ Specifies whether .NET SDK local tools search for tool manifest files in the roo ### `DOTNET_HOST_TRACE` -**This variable applies to .NET 10 and later versions.** For older versions, replace the `DOTNET_HOST_` prefix with [`COREHOST_`](#corehost_trace). - Controls diagnostics tracing from the hosting components, such as `dotnet.exe`, `hostfxr`, and `hostpolicy`. +> [!NOTE] +> Prior to .NET 10, the `COREHOST_` prefix was used instead of `DOTNET_HOST_` (for example, `COREHOST_TRACE`). The functionality and values remain identical. + - `DOTNET_HOST_TRACE=[0/1]` - default is `0` - tracing disabled. If set to `1`, diagnostics tracing is enabled. - `DOTNET_HOST_TRACEFILE=` - has an effect only if tracing is enabled by setting `DOTNET_HOST_TRACE=1`. When set, the tracing information is written to the specified file; otherwise, the trace information is written to `stderr`. - `DOTNET_HOST_TRACE_VERBOSITY=[1/2/3/4]` - default is `4`. The setting is used only when tracing is enabled via `DOTNET_HOST_TRACE=1`. @@ -462,17 +462,6 @@ Controls diagnostics tracing from the hosting components, such as `dotnet.exe`, The typical way to get detailed trace information about application startup is to set `DOTNET_HOST_TRACE=1` and `DOTNET_HOST_TRACEFILE=host_trace.txt` and then run the application. A new file `host_trace.txt` will be created in the current directory with the detailed information. -### `COREHOST_TRACE` - -Controls diagnostics tracing from the hosting components, such as `dotnet.exe`, `hostfxr`, and `hostpolicy`. - -> [!NOTE] -> Starting with .NET 10, use the [`DOTNET_HOST_TRACE`](#dotnet_host_trace) environment variables instead. The `COREHOST_TRACE` variables work the same as `DOTNET_HOST_TRACE` variables. - -- `COREHOST_TRACE` - see [`DOTNET_HOST_TRACE`](#dotnet_host_trace). -- `COREHOST_TRACEFILE` - see [`DOTNET_HOST_TRACEFILE`](#dotnet_host_trace). -- `COREHOST_TRACE_VERBOSITY` - see [`DOTNET_HOST_TRACE_VERBOSITY`](#dotnet_host_trace). - ### `SuppressNETCoreSdkPreviewMessage` If set to `true`, invoking `dotnet` won't produce a warning when a preview SDK is being used.