diff --git a/doc/overview.rst b/doc/overview.rst index 60d98e65b..d41a34e9a 100644 --- a/doc/overview.rst +++ b/doc/overview.rst @@ -4,12 +4,36 @@ Overview Installing rosdep ----------------- -rosdep2 is available using pip or easy_install:: +.. admonition:: Note - sudo pip install -U rosdep + 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. -or:: +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 + +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