From f369593a638ead211d4dae41a483269d7d74c02c Mon Sep 17 00:00:00 2001 From: SubaruArai Date: Mon, 15 Apr 2024 16:44:43 +0900 Subject: [PATCH 1/2] Doc: recommend system install of rosdep The install instructions for rosdep were recommending a pip install, which is not the recommended way to install rosdep. This change updates the install instructions to recommend a system install of rosdep. --- doc/overview.rst | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/doc/overview.rst b/doc/overview.rst index 60d98e65b..a4962dc3d 100644 --- a/doc/overview.rst +++ b/doc/overview.rst @@ -4,12 +4,23 @@ Overview Installing rosdep ----------------- -rosdep2 is available using pip or easy_install:: +It is recommended to use the system package manager to install rosdep. - sudo pip install -U rosdep +rosdep2 is a system package under Ubuntu and Debian:: + + # Ubuntu >= 20.04 (Focal) + sudo apt-get install python3-rosdep + # Debian >=11 (Bullseye) + sudo apt-get install python3-rosdep2 -or:: +If rosdep doesn't exist in your package manager, you can install it +using pip or easy_install:: + # Python 2 + sudo pip install -U rosdep + # Python 3 + sudo pip3 install -U rosdep + # easy_install sudo easy_install -U rosdep rospkg From d54f8ce34101e688ef415883f5b810299412af27 Mon Sep 17 00:00:00 2001 From: SubaruArai Date: Mon, 15 Apr 2024 17:07:33 +0900 Subject: [PATCH 2/2] Tell user to prioritize the ROS guide if using ROS --- doc/overview.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/overview.rst b/doc/overview.rst index a4962dc3d..d41a34e9a 100644 --- a/doc/overview.rst +++ b/doc/overview.rst @@ -4,6 +4,19 @@ Overview Installing rosdep ----------------- +.. admonition:: Note + + If you want to use rosdep with ROS1/2, you should install rosdep + following their installation instructions: + + * `ROS1 installation instructions + `_ + * `ROS2 installation instructions + `_ + [#rosdep_in_dev_tools]_ + + .. [#rosdep_in_dev_tools] In ROS2 Foxy and beyond, rosdep is included in the ros-dev-tools package. + It is recommended to use the system package manager to install rosdep. rosdep2 is a system package under Ubuntu and Debian::