From 1a6303aa8c17703d24b6e375cd143a9e8db661e1 Mon Sep 17 00:00:00 2001 From: Brad King Date: Mon, 18 Dec 2023 16:34:33 -0500 Subject: CMakePackageConfigHelpers: Fix generate_apple_platform_selection_file docs Previously the documentation was not rendered correctly. --- Modules/CMakePackageConfigHelpers.cmake | 88 +++++++++++++++++---------------- 1 file changed, 45 insertions(+), 43 deletions(-) diff --git a/Modules/CMakePackageConfigHelpers.cmake b/Modules/CMakePackageConfigHelpers.cmake index ab38820..386c39d 100644 --- a/Modules/CMakePackageConfigHelpers.cmake +++ b/Modules/CMakePackageConfigHelpers.cmake @@ -193,64 +193,66 @@ point to create more sophisticated custom ``ConfigVersion.cmake`` files. Generating an Apple Platform Selection File ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -.. versionadded:: 3.29 - .. command:: generate_apple_platform_selection_file - Create an Apple platform selection file: + .. versionadded:: 3.29 - generate_apple_platform_selection_file( - INSTALL_DESTINATION - [MACOS_CONFIG_FILE ] - [IOS_CONFIG_FILE ] - [IOS_SIMULATOR_CONFIG_FILE ] - [TVOS_CONFIG_FILE ] - [TVOS_SIMULATOR_CONFIG_FILE ] - [WATCHOS_CONFIG_FILE ] - [WATCHOS_SIMULATOR_CONFIG_FILE ] - [VISIONOS_CONFIG_FILE ] - [VISIONOS_SIMULATOR_CONFIG_FILE ] - ) + Create an Apple platform selection file: + + .. code-block:: cmake + + generate_apple_platform_selection_file( + INSTALL_DESTINATION + [MACOS_CONFIG_FILE ] + [IOS_CONFIG_FILE ] + [IOS_SIMULATOR_CONFIG_FILE ] + [TVOS_CONFIG_FILE ] + [TVOS_SIMULATOR_CONFIG_FILE ] + [WATCHOS_CONFIG_FILE ] + [WATCHOS_SIMULATOR_CONFIG_FILE ] + [VISIONOS_CONFIG_FILE ] + [VISIONOS_SIMULATOR_CONFIG_FILE ] + ) -Writes a file for use as ``Config.cmake`` which can include an -Apple-platform-specific ``Config.cmake`` from a different -directory. This can be used in conjunction with the ``XCFRAMEWORK_LOCATION`` -argument of :command:`export(SETUP)` to export packages in a way that a project -built for any Apple platform can use them. + Writes a file for use as ``Config.cmake`` which can include an + Apple-platform-specific ``Config.cmake`` from a different + directory. This can be used in conjunction with the ``XCFRAMEWORK_LOCATION`` + argument of :command:`export(SETUP)` to export packages in a way that a project + built for any Apple platform can use them. -``INSTALL_DESTINATION `` - Path that the file will be installed to. + ``INSTALL_DESTINATION `` + Path that the file will be installed to. -``MACOS_CONFIG_FILE `` - File to include if the platform is macOS. + ``MACOS_CONFIG_FILE `` + File to include if the platform is macOS. -``IOS_CONFIG_FILE `` - File to include if the platform is iOS. + ``IOS_CONFIG_FILE `` + File to include if the platform is iOS. -``IOS_SIMULATOR_CONFIG_FILE `` - File to include if the platform is iOS Simulator. + ``IOS_SIMULATOR_CONFIG_FILE `` + File to include if the platform is iOS Simulator. -``TVOS_CONFIG_FILE `` - File to include if the platform is tvOS. + ``TVOS_CONFIG_FILE `` + File to include if the platform is tvOS. -``TVOS_SIMULATOR_CONFIG_FILE `` - File to include if the platform is tvOS Simulator. + ``TVOS_SIMULATOR_CONFIG_FILE `` + File to include if the platform is tvOS Simulator. -``WATCHOS_CONFIG_FILE `` - File to include if the platform is watchOS. + ``WATCHOS_CONFIG_FILE `` + File to include if the platform is watchOS. -``WATCHOS_SIMULATOR_CONFIG_FILE `` - File to include if the platform is watchOS Simulator. + ``WATCHOS_SIMULATOR_CONFIG_FILE `` + File to include if the platform is watchOS Simulator. -``VISIONOS_CONFIG_FILE `` - File to include if the platform is visionOS. + ``VISIONOS_CONFIG_FILE `` + File to include if the platform is visionOS. -``VISIONOS_SIMULATOR_CONFIG_FILE `` - File to include if the platform is visionOS Simulator. + ``VISIONOS_SIMULATOR_CONFIG_FILE `` + File to include if the platform is visionOS Simulator. -If any of the optional config files are not specified, and the consuming -project is built for their corresponding platform, an error will be thrown -when including the generated file. + If any of the optional config files are not specified, and the consuming + project is built for their corresponding platform, an error will be thrown + when including the generated file. Example Generating Package Files ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -- cgit v0.12