From a3ad7a77270616eb7f4eeccd1cc6b6e1a2481a8f Mon Sep 17 00:00:00 2001 From: Felix F Xu <84662027+felixf4xu@users.noreply.github.com> Date: Wed, 15 Oct 2025 15:03:38 +0800 Subject: [PATCH 1/3] Update Windows colcon build instructions --symlink-install Clarify Windows build command and permissions for symbolic links. Signed-off-by: Felix F Xu <84662027+felixf4xu@users.noreply.github.com> --- source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst b/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst index b16fe65b6b3..76209f861c9 100644 --- a/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst +++ b/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst @@ -184,9 +184,10 @@ This allows the installed files to be changed by changing the files in the ``sou .. code-block:: console - $ colcon build --symlink-install --merge-install + $ colcon build --merge-install Windows doesn't allow long paths, so ``merge-install`` will combine all the paths into the ``install`` directory. + On Windows, you need special permissions to create symbolic links, so `--symlink-install` is not used by default. To use it, you need to run the command as administrator or enable developer mode in system settings. .. tip:: From 34bab2e61d9e46ea1b705e3f382b6772678c0d91 Mon Sep 17 00:00:00 2001 From: Felix F Xu <84662027+felixf4xu@users.noreply.github.com> Date: Wed, 15 Oct 2025 15:09:41 +0800 Subject: [PATCH 2/3] Update source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> Signed-off-by: Felix F Xu <84662027+felixf4xu@users.noreply.github.com> --- source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst b/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst index 76209f861c9..679636d5861 100644 --- a/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst +++ b/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst @@ -187,7 +187,7 @@ This allows the installed files to be changed by changing the files in the ``sou $ colcon build --merge-install Windows doesn't allow long paths, so ``merge-install`` will combine all the paths into the ``install`` directory. - On Windows, you need special permissions to create symbolic links, so `--symlink-install` is not used by default. To use it, you need to run the command as administrator or enable developer mode in system settings. + On Windows, you need special permissions to create symbolic links, so ``--symlink-install`` is not used by default. To use it, you need to run the command as administrator or enable developer mode in system settings. .. tip:: From 8b0d1026d7448c4a898916746087399ca3c411b5 Mon Sep 17 00:00:00 2001 From: Felix F Xu <84662027+felixf4xu@users.noreply.github.com> Date: Thu, 16 Oct 2025 09:46:05 +0800 Subject: [PATCH 3/3] Update source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst Co-authored-by: Tomoya Fujita Signed-off-by: Felix F Xu <84662027+felixf4xu@users.noreply.github.com> --- source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst b/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst index 679636d5861..d0d3430f9c1 100644 --- a/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst +++ b/source/Tutorials/Beginner-Client-Libraries/Colcon-Tutorial.rst @@ -187,7 +187,8 @@ This allows the installed files to be changed by changing the files in the ``sou $ colcon build --merge-install Windows doesn't allow long paths, so ``merge-install`` will combine all the paths into the ``install`` directory. - On Windows, you need special permissions to create symbolic links, so ``--symlink-install`` is not used by default. To use it, you need to run the command as administrator or enable developer mode in system settings. + On Windows, you need special permissions to create symbolic links, so ``--symlink-install`` is not used by default. + To use it, you need to run the command as administrator or enable developer mode in system settings. .. tip::