From 34e19396e1a4a5a1bb37757c9665a55b8389ffe7 Mon Sep 17 00:00:00 2001 From: Jean Pierre Cimalando Date: Fri, 21 May 2021 22:37:48 +0200 Subject: [PATCH] cmake: add usage documentation --- cmake/DPF-plugin.cmake | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/cmake/DPF-plugin.cmake b/cmake/DPF-plugin.cmake index 70575c68..8bac5f68 100644 --- a/cmake/DPF-plugin.cmake +++ b/cmake/DPF-plugin.cmake @@ -3,6 +3,33 @@ # # SPDX-License-Identifier: ISC +# ------------------------------------------------------------------------------ +# CMake support module for the DISTRHO Plugin Framework +# +# The purpose of this module is to help building music plugins easily, when the +# project uses CMake as its build system. +# +# In order to use the helpers provided by this module, a plugin author should +# add DPF as a subproject, making the function `dpf_add_plugin` available. +# The usage of this function is documented below in greater detail. +# +# Example project `CMakeLists.txt`: +# +# ``` +# cmake_minimum_required(VERSION 3.7) +# project(MyPlugin) +# +# add_subdirectory(DPF) +# +# dpf_add_plugin(MyPlugin +# TARGETS lv2 vst +# UI_TYPE opengl +# FILES_DSP +# src/MyPlugin.cpp +# FILES_UI +# src/MyUI.cpp) +# ``` + include(CMakeParseArguments) # ------------------------------------------------------------------------------