From 00a08815d316b7dcb672486e9fac0c738da59500 Mon Sep 17 00:00:00 2001 From: Dmitry Rozhkov Date: Fri, 28 Oct 2016 12:17:36 +0300 Subject: [PATCH] README.md: add a note about ROS_OS_OVERRIDE meta-ros is supposed to be used for building a custom distribution which isn't derived from any of the OSs known to the rospkg.os_detect module. Signed-off-by: Dmitry Rozhkov --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 57a55d7..e7da834 100644 --- a/README.md +++ b/README.md @@ -190,6 +190,20 @@ resolved in the past. roscore + If you want to use the roswtf utility for diagnostics and experience an + exception like + + rospkg.os_detect.OsNotDetected: Could not detect OS, tried ['windows', 'ubuntu', 'slackware', 'rhel', 'qnx', 'osx', 'opensuse', 'opensuse', 'mint', 'linaro', 'gentoo', 'funtoo', 'freebsd', 'fedora', 'elementary', 'debian', 'cygwin', 'centos', 'arch'] + + then you need to set `ROS_OS_OVERRIDE` to one of the listed OS names, e.g. + + export ROS_OS_OVERRIDE=ubuntu + + And since Yocto-based distributions are not supported by the `rospkg` + library you have to interpret roswtf's output by translating Ubuntu + package names manually to their corresponding package/recipe names that + were chosen in the meta-ros layer. + ## CROSS-COMPILING ALL ROS PACKAGES IN meta-ros