cmake: add documentation for px4_posix_generate_alias and px4_posix_generate_symlinks

This commit is contained in:
Beat Küng 2018-08-06 15:51:25 +02:00 committed by Lorenz Meier
parent f748c8d883
commit a5de82aaa8

View File

@ -104,7 +104,30 @@ function(px4_posix_generate_builtin_commands)
endfunction()
# TODO: document API
#=============================================================================
#
# px4_posix_generate_alias
#
# This function generates the px4-alias.sh script containing the command
# aliases for all modules and commands.
#
# Usage:
# px4_posix_generate_alias(
# MODULE_LIST <in-list>
# OUT <file>
# PREFIX <prefix>)
#
# Input:
# MODULE_LIST : list of modules
# PREFIX : command prefix (e.g. "px4-")
#
# Output:
# OUT : px4-alias.sh file path
#
# Example:
# px4_posix_generate_alias(
# OUT <generated-src> MODULE_LIST px4_simple_app PREFIX px4-)
#
function(px4_posix_generate_alias)
px4_parse_function_args(
NAME px4_posix_generate_alias
@ -133,7 +156,27 @@ function(px4_posix_generate_alias)
endfunction()
# TODO: document API
#=============================================================================
#
# px4_posix_generate_symlinks
#
# This function generates symlinks for all modules/commands.
#
# Usage:
# px4_posix_generate_symlinks(
# TARGET <target>
# MODULE_LIST <in-list>
# PREFIX <prefix>)
#
# Input:
# MODULE_LIST : list of modules
# PREFIX : command prefix (e.g. "px4-")
# TARGET : cmake target for which the symlinks should be created
#
# Example:
# px4_posix_generate_symlinks(
# TARGET px4 MODULE_LIST px4_simple_app PREFIX px4-)
#
function(px4_posix_generate_symlinks)
px4_parse_function_args(
NAME px4_posix_generate_symlinks