From 3042889b54fca5d372bc51a699987b478f791a59 Mon Sep 17 00:00:00 2001 From: ichensky Date: Sat, 28 Sep 2024 21:28:14 +0300 Subject: [PATCH 1/6] Update dotnet-tool-install.md about PATH environment variable Add note about configuration PATH environment variable in Linux OS to make installed tools globally be executable from any location. --- docs/core/tools/dotnet-tool-install.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/core/tools/dotnet-tool-install.md b/docs/core/tools/dotnet-tool-install.md index d2d1e20407b17..ad0e03c86b76c 100644 --- a/docs/core/tools/dotnet-tool-install.md +++ b/docs/core/tools/dotnet-tool-install.md @@ -63,6 +63,15 @@ Global tools are installed in the following directories by default when you spec Executables are generated in these folders for each globally installed tool, although the actual tool binaries are nested deep into the sibling `.store` directory. +> On Linux OS after installing a command-line tool with `dotnet tool`, the tool may be executed only from the `$HOME/.dotnet/tools` path. +> To make the tool executable from any directory, you can update the environment variable called `PATH`. +> To make the updated `PATH` environment variable permanent in your shell, you need to update your shell settings. +> For `Bash`, this is `$HOME/.bashrc` file. +>>```sh +>> export PATH=$PATH:~/.dotnet/tools +>> ``` + + ### `--tool-path` tools Tools with explicit tool paths are stored wherever you specified the `--tool-path` parameter to point to. They're stored in the same way as global tools: an executable binary with the actual binaries in a sibling `.store` directory. From 135f13395963f2766366d1ce85caa7f1b0310805 Mon Sep 17 00:00:00 2001 From: ichensky Date: Mon, 30 Sep 2024 22:43:57 +0300 Subject: [PATCH 2/6] Update docs/core/tools/dotnet-tool-install.md Co-authored-by: Tom Dykstra --- docs/core/tools/dotnet-tool-install.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/core/tools/dotnet-tool-install.md b/docs/core/tools/dotnet-tool-install.md index ad0e03c86b76c..6badaf1ae9866 100644 --- a/docs/core/tools/dotnet-tool-install.md +++ b/docs/core/tools/dotnet-tool-install.md @@ -63,7 +63,8 @@ Global tools are installed in the following directories by default when you spec Executables are generated in these folders for each globally installed tool, although the actual tool binaries are nested deep into the sibling `.store` directory. -> On Linux OS after installing a command-line tool with `dotnet tool`, the tool may be executed only from the `$HOME/.dotnet/tools` path. +> [!NOTE] +> On Linux after installing a command-line tool with `dotnet tool`, the tool can be executed only from the `$HOME/.dotnet/tools` path. > To make the tool executable from any directory, you can update the environment variable called `PATH`. > To make the updated `PATH` environment variable permanent in your shell, you need to update your shell settings. > For `Bash`, this is `$HOME/.bashrc` file. From dea439f9c9fa02176d4f1f0519ba720fc0b95739 Mon Sep 17 00:00:00 2001 From: ichensky Date: Mon, 30 Sep 2024 22:44:06 +0300 Subject: [PATCH 3/6] Update docs/core/tools/dotnet-tool-install.md Co-authored-by: Tom Dykstra --- docs/core/tools/dotnet-tool-install.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/core/tools/dotnet-tool-install.md b/docs/core/tools/dotnet-tool-install.md index 6badaf1ae9866..cfe0ede0543a4 100644 --- a/docs/core/tools/dotnet-tool-install.md +++ b/docs/core/tools/dotnet-tool-install.md @@ -65,9 +65,9 @@ Executables are generated in these folders for each globally installed tool, alt > [!NOTE] > On Linux after installing a command-line tool with `dotnet tool`, the tool can be executed only from the `$HOME/.dotnet/tools` path. -> To make the tool executable from any directory, you can update the environment variable called `PATH`. -> To make the updated `PATH` environment variable permanent in your shell, you need to update your shell settings. -> For `Bash`, this is `$HOME/.bashrc` file. +> To make the tool executable from any directory, update the `PATH` environment variable. +> To make the updated `PATH` environment variable permanent in your shell, update your shell settings. +> For `Bash`, this is the `$HOME/.bashrc` file. >>```sh >> export PATH=$PATH:~/.dotnet/tools >> ``` From 6b1f2bfa553c04a8ec4b342547eed02ec95a0ce1 Mon Sep 17 00:00:00 2001 From: ichensky Date: Mon, 30 Sep 2024 22:44:13 +0300 Subject: [PATCH 4/6] Update docs/core/tools/dotnet-tool-install.md Co-authored-by: Tom Dykstra --- docs/core/tools/dotnet-tool-install.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/docs/core/tools/dotnet-tool-install.md b/docs/core/tools/dotnet-tool-install.md index cfe0ede0543a4..a8cbbfbc1bcc4 100644 --- a/docs/core/tools/dotnet-tool-install.md +++ b/docs/core/tools/dotnet-tool-install.md @@ -68,11 +68,6 @@ Executables are generated in these folders for each globally installed tool, alt > To make the tool executable from any directory, update the `PATH` environment variable. > To make the updated `PATH` environment variable permanent in your shell, update your shell settings. > For `Bash`, this is the `$HOME/.bashrc` file. ->>```sh ->> export PATH=$PATH:~/.dotnet/tools ->> ``` - - ### `--tool-path` tools Tools with explicit tool paths are stored wherever you specified the `--tool-path` parameter to point to. They're stored in the same way as global tools: an executable binary with the actual binaries in a sibling `.store` directory. From 148ab78bfcaa0150d35b25646dc8524bbb615449 Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Mon, 30 Sep 2024 16:18:03 -0700 Subject: [PATCH 5/6] Update docs/core/tools/dotnet-tool-install.md --- docs/core/tools/dotnet-tool-install.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/core/tools/dotnet-tool-install.md b/docs/core/tools/dotnet-tool-install.md index a8cbbfbc1bcc4..058194d5356bb 100644 --- a/docs/core/tools/dotnet-tool-install.md +++ b/docs/core/tools/dotnet-tool-install.md @@ -68,6 +68,7 @@ Executables are generated in these folders for each globally installed tool, alt > To make the tool executable from any directory, update the `PATH` environment variable. > To make the updated `PATH` environment variable permanent in your shell, update your shell settings. > For `Bash`, this is the `$HOME/.bashrc` file. + ### `--tool-path` tools Tools with explicit tool paths are stored wherever you specified the `--tool-path` parameter to point to. They're stored in the same way as global tools: an executable binary with the actual binaries in a sibling `.store` directory. From f4a25e3675bdb3245173b61a443d9f0bb28ec70d Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Mon, 30 Sep 2024 16:39:21 -0700 Subject: [PATCH 6/6] Update docs/core/tools/dotnet-tool-install.md --- docs/core/tools/dotnet-tool-install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/tools/dotnet-tool-install.md b/docs/core/tools/dotnet-tool-install.md index 058194d5356bb..c9a4075ed7c7d 100644 --- a/docs/core/tools/dotnet-tool-install.md +++ b/docs/core/tools/dotnet-tool-install.md @@ -67,7 +67,7 @@ Executables are generated in these folders for each globally installed tool, alt > On Linux after installing a command-line tool with `dotnet tool`, the tool can be executed only from the `$HOME/.dotnet/tools` path. > To make the tool executable from any directory, update the `PATH` environment variable. > To make the updated `PATH` environment variable permanent in your shell, update your shell settings. -> For `Bash`, this is the `$HOME/.bashrc` file. +> For `Bash`, this is the `$HOME/.bashrc` file. ### `--tool-path` tools