module documentation

Undocumented

Function init_workspace Create a toplevel CMakeLists.txt in the root of a workspace.
Function _symlink_or_copy Create a symlink at dst to src, or if not possible, attempts to copy.
def init_workspace(workspace_dir):

Create a toplevel CMakeLists.txt in the root of a workspace.

The toplevel.cmake file is looked up either in the catkin workspaces contained in the CMAKE_PREFIX_PATH or relative to this file. Then it tries to create a symlink first and if that fails copies the file.

It installs manifest.xml to share/${PROJECT_NAME}.

Note

The symlink is absolute when catkin is found outside the workspace_dir (since that indicates a different workspace and it may change relative location to the workspace referenced as a parameter). The symlink is relative when catkin is part of the to-be-initialized workspace.

Parameters
workspace_dir:stringthe path to the workspace where the CMakeLists.txt should be created
def _symlink_or_copy(src, dst):

Create a symlink at dst to src, or if not possible, attempts to copy.