[vcpkg-docs] Add documentation for vcpkg_configure_meson(), vcpkg_install_meson(), vcpkg_fixup_cmake_targts(), and vcpkg_prettify_command() (#7606)

* [vcpkg-docs] Add documentation for `vcpkg_configure_meson()`, `vcpkg_install_meson()`, `vcpkg_fixup_cmake_targts()`, and `vcpkg_prettify_command()`

* [docs] Address code review comments. Reformat docs for vcpkg_fail_port_install.

docs/maintainers/portfile-functions.md

@@ -15,6 +15,7 @@
 - [vcpkg\_common\_definitions](vcpkg_common_definitions.md)
 - [vcpkg\_configure\_cmake](vcpkg_configure_cmake.md)
 - [vcpkg\_configure\_make](vcpkg_configure_make.md)
+- [vcpkg\_configure\_meson](vcpkg_configure_meson.md)
 - [vcpkg\_copy\_pdbs](vcpkg_copy_pdbs.md)
 - [vcpkg\_copy\_tool\_dependencies](vcpkg_copy_tool_dependencies.md)
 - [vcpkg\_download\_distfile](vcpkg_download_distfile.md)
@@ -24,12 +25,14 @@
 - [vcpkg\_extract\_source\_archive\_ex](vcpkg_extract_source_archive_ex.md)
 - [vcpkg\_fail\_port\_install](vcpkg_fail_port_install.md)
 - [vcpkg\_find\_acquire\_program](vcpkg_find_acquire_program.md)
+- [vcpkg\_fixup\_cmake\_targets](vcpkg_fixup_cmake_targets.md)
 - [vcpkg\_from\_bitbucket](vcpkg_from_bitbucket.md)
 - [vcpkg\_from\_git](vcpkg_from_git.md)
 - [vcpkg\_from\_github](vcpkg_from_github.md)
 - [vcpkg\_from\_gitlab](vcpkg_from_gitlab.md)
 - [vcpkg\_install\_cmake](vcpkg_install_cmake.md)
 - [vcpkg\_install\_make](vcpkg_install_make.md)
+- [vcpkg\_install\_meson](vcpkg_install_meson.md)
 - [vcpkg\_install\_msbuild](vcpkg_install_msbuild.md)
 - [vcpkg\_install\_nmake](vcpkg_install_nmake.md)
 - [vcpkg\_install\_qmake](vcpkg_install_qmake.md)

docs/maintainers/vcpkg_apply_patches.md

@@ -1,6 +1,6 @@
 # vcpkg_apply_patches
 
-Apply a set of patches to a source tree.
+Apply a set of patches to a source tree. This function is deprecated in favor of the `PATCHES` argument to `vcpkg_from_github()` et al.
 
 ## Usage
 ```cmake
@@ -27,9 +27,8 @@ This should only be used for edge cases, such as patches that are known to fail
 
 ## Examples
 
-* [boost](https://github.com/Microsoft/vcpkg/blob/master/ports/boost/portfile.cmake)
+* [libbson](https://github.com/Microsoft/vcpkg/blob/master/ports/libbson/portfile.cmake)
-* [freetype](https://github.com/Microsoft/vcpkg/blob/master/ports/freetype/portfile.cmake)
+* [gdal](https://github.com/Microsoft/vcpkg/blob/master/ports/gdal/portfile.cmake)
-* [libpng](https://github.com/Microsoft/vcpkg/blob/master/ports/libpng/portfile.cmake)
 
 ## Source
 [scripts/cmake/vcpkg_apply_patches.cmake](https://github.com/Microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_apply_patches.cmake)

docs/maintainers/vcpkg_configure_cmake.md

@@ -38,7 +38,7 @@ This is needed for libraries that set their own source code's character set.
 Specifies the precise generator to use.
 
 This is useful if some project-specific buildsystem has been wrapped in a cmake script that won't perform an actual build.
-If used for this purpose, it should be set to "NMake Makefiles".
+If used for this purpose, it should be set to `"NMake Makefiles"`.
 
 ### OPTIONS
 Additional options passed to CMake during the configuration.

docs/maintainers/vcpkg_configure_meson.md

@@ -0,0 +1,38 @@
+# vcpkg_configure_meson
+
+Configure Meson for Debug and Release builds of a project.
+
+## Usage
+```cmake
+vcpkg_configure_meson(
+    SOURCE_PATH <${SOURCE_PATH}>
+    [OPTIONS <-DUSE_THIS_IN_ALL_BUILDS=1>...]
+    [OPTIONS_RELEASE <-DOPTIMIZE=1>...]
+    [OPTIONS_DEBUG <-DDEBUGGABLE=1>...]
+)
+```
+
+## Parameters
+### SOURCE_PATH
+Specifies the directory containing the `meson.build`.
+By convention, this is usually set in the portfile as the variable `SOURCE_PATH`.
+
+### OPTIONS
+Additional options passed to Meson during the configuration.
+
+### OPTIONS_RELEASE
+Additional options passed to Meson during the Release configuration. These are in addition to `OPTIONS`.
+
+### OPTIONS_DEBUG
+Additional options passed to Meson during the Debug configuration. These are in addition to `OPTIONS`.
+
+## Notes
+This command supplies many common arguments to Meson. To see the full list, examine the source.
+
+## Examples
+
+* [fribidi](https://github.com/Microsoft/vcpkg/blob/master/ports/fribidi/portfile.cmake)
+* [libepoxy](https://github.com/Microsoft/vcpkg/blob/master/ports/libepoxy/portfile.cmake)
+
+## Source
+[scripts/cmake/vcpkg_configure_meson.cmake](https://github.com/Microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_configure_meson.cmake)

docs/maintainers/vcpkg_fail_port_install.md

@@ -1,30 +1,37 @@
 # vcpkg_fail_port_install
 
-Fails the current portfile with a (default) error message
+Checks common requirements and fails the current portfile with a (default) error message
 
 ## Usage
 ```cmake
-vcpkg_fail_port_install([MESSAGE <message>] 	[ON_TARGET <target1> [<target2> ...]]
+vcpkg_fail_port_install(
+    [ALWAYS]
+    [MESSAGE <"Reason for failure">]
+    [ON_TARGET <Windows> [<OSX> ...]]
+    [ON_ARCH <x64> [<arm> ...]]
+    [ON_CRT_LINKAGE <static> [<dynamic> ...]])
+    [ON_LIBRARY_LINKAGE <static> [<dynamic> ...]]
+)
 ```
 
 ## Parameters
 ### MESSAGE
-Additional failure message. If non is given a default message will be displayed depending on the failure condition
+Additional failure message. If none is given, a default message will be displayed depending on the failure condition.
 
 ### ALWAYS
-will always fail early
+Will always fail early
 
 ### ON_TARGET
-targets for which the build should fail early. Valid targets are <target> from VCPKG_IS_TARGET_<target> (see vcpkg_common_definitions.cmake)
+Targets for which the build should fail early. Valid targets are `<target>` from `VCPKG_IS_TARGET_<target>` (see `vcpkg_common_definitions.cmake`).
 
 ### ON_ARCH
-architecture for which the build should fail early. 
+Architecture for which the build should fail early.
 
 ### ON_CRT_LINKAGE
 CRT linkage for which the build should fail early.
 
 ### ON_LIBRARY_LINKAGE
-library linkage for which the build should fail early.
+Library linkage for which the build should fail early.
 
 ## Examples
 

docs/maintainers/vcpkg_find_acquire_program.md

@@ -14,9 +14,13 @@ This variable specifies both the program to be acquired as well as the out param
 The current list of programs includes:
 
 - 7Z
+- ARIA2 (Downloader)
 - BISON
+- DARK
+- DOXYGEN
 - FLEX
 - GASPREPROCESSOR
+- GPERF
 - PERL
 - PYTHON2
 - PYTHON3
@@ -26,8 +30,8 @@ The current list of programs includes:
 - NASM
 - NINJA
 - NUGET
+- SCONS
 - YASM
-- ARIA2 (Downloader)
 
 Note that msys2 has a dedicated helper function: [`vcpkg_acquire_msys`](vcpkg_acquire_msys.md).
 

docs/maintainers/vcpkg_fixup_cmake_targets.md

@@ -1,30 +1,42 @@
-# vcpkg_fixup_cmake_targets
+# vcpkg_fixup_cmake_targets
-
+
-Transforms all `/debug/share/\<port\>/\*targets-debug.cmake` files and move them to `/share/\<port\>`.
+Merge release and debug CMake targets and configs to support multiconfig generators.
-Removes all `/debug/share/\<port\>/\*targets.cmake and /debug/share/\<port\>/\*config.cmake`.
+
-
+Additionally corrects common issues with targets, such as absolute paths and incorrectly placed binaries.
-Transforms all references matching `/bin/\*.exe tools/\<port\>/\*.exe` on Windows.
+
-Transforms all references matching `/bin/\* to /tools/\<port\>/\*` on other platforms.
+## Usage
-
+```cmake
-Fixups *${_IMPORT_PREFIX}* in auto generated targets to be one folder deeper. 
+vcpkg_fixup_cmake_targets([CONFIG_PATH <share/${PORT}>] [TARGET_PATH <share/${PORT}>])
-Replaces *${CURRENT_INSTALLED_DIR}* with *${_IMPORT_PREFIX}* in config files and targets.
+```
-
+
-
+## Parameters
-## Usage
+
-```cmake
+### CONFIG_PATH
-vcpkg_fixup_cmake_targets(CONFIG_PATH <config_path>)
+Subpath currently containing `*.cmake` files subdirectory (like `lib/cmake/${PORT}`). Should be relative to `${CURRENT_PACKAGES_DIR}`.
-```
+
-
+Defaults to `share/${PORT}`.
-## Parameters:
+
-### CONFIG_PATH
+### TARGET_PATH
-*.cmake files subdirectory (e.g. "lib/cmake/${PORT}" or "cmake/${PORT}).
+Subpath to which the above `*.cmake` files should be moved. Should be relative to `${CURRENT_PACKAGES_DIR}`.
-### TARGET_PATH
+This needs to be specified if the port name differs from the `find_package()` name.
-Optional location to place fixup'd files. Unecessary if target is "share/${PORT}".
+
-
+Defaults to `share/${PORT}`.
-## Examples:
+
-  - [Azure-uamqp-c](https://github.com/microsoft/vcpkg/blob/master/ports/azure-uamqp-c/portfile.cmake)
+## Notes
-  - [Brigand](https://github.com/microsoft/vcpkg/blob/master/ports/brigand/portfile.cmake)
+Transform all `/debug/<CONFIG_PATH>/*targets-debug.cmake` files and move them to `/<TARGET_PATH>`.
-  - [cctz](https://github.com/microsoft/vcpkg/blob/master/ports/cctz/portfile.cmake)
+Removes all `/debug/<CONFIG_PATH>/*targets.cmake` and `/debug/<CONFIG_PATH>/*config.cmake`.
-
+
-## Source
+Transform all references matching `/bin/*.exe` to `/tools/<port>/*.exe` on Windows.
-[scripts/cmake/vcpkg_fixup_cmake_targets.cmake](https://github.com/microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_fixup_cmake_targets.cmake)
+Transform all references matching `/bin/*` to `/tools/<port>/*` on other platforms.
+
+Fix `${_IMPORT_PREFIX}` in auto generated targets to be one folder deeper.
+Replace `${CURRENT_INSTALLED_DIR}` with `${_IMPORT_PREFIX}` in configs and targets.
+
+## Examples
+
+* [concurrentqueue](https://github.com/Microsoft/vcpkg/blob/master/ports/concurrentqueue/portfile.cmake)
+* [curl](https://github.com/Microsoft/vcpkg/blob/master/ports/curl/portfile.cmake)
+* [nlohmann-json](https://github.com/Microsoft/vcpkg/blob/master/ports/nlohmann-json/portfile.cmake)
+
+## Source
+[scripts/cmake/vcpkg_fixup_cmake_targets.cmake](https://github.com/Microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_fixup_cmake_targets.cmake)

docs/maintainers/vcpkg_install_meson.md

@@ -0,0 +1,16 @@
+# vcpkg_install_meson
+
+Builds a meson project previously configured with `vcpkg_configure_meson()`.
+
+## Usage
+```cmake
+vcpkg_install_meson()
+```
+
+## Examples
+
+* [fribidi](https://github.com/Microsoft/vcpkg/blob/master/ports/fribidi/portfile.cmake)
+* [libepoxy](https://github.com/Microsoft/vcpkg/blob/master/ports/libepoxy/portfile.cmake)
+
+## Source
+[scripts/cmake/vcpkg_install_meson.cmake](https://github.com/Microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_install_meson.cmake)

docs/maintainers/vcpkg_prettify_command.md

@@ -4,7 +4,7 @@ Turns list of command arguments into a formatted string.
 
 ## Usage
 ```cmake
-vcpkg_prettify_command()
+vcpkg_prettify_command(<INPUT_VAR> <OUTPUT_VAR>)
 ```
 
 ## Examples

scripts/cmake/vcpkg_apply_patches.cmake

@@ -1,6 +1,6 @@
 ## # vcpkg_apply_patches
 ##
-## Apply a set of patches to a source tree.
+## Apply a set of patches to a source tree. This function is deprecated in favor of the `PATCHES` argument to `vcpkg_from_github()` et al.
 ##
 ## ## Usage
 ## ```cmake
@@ -27,10 +27,8 @@
 ##
 ## ## Examples
 ##
-## * [boost](https://github.com/Microsoft/vcpkg/blob/master/ports/boost/portfile.cmake)
+## * [libbson](https://github.com/Microsoft/vcpkg/blob/master/ports/libbson/portfile.cmake)
-## * [freetype](https://github.com/Microsoft/vcpkg/blob/master/ports/freetype/portfile.cmake)
+## * [gdal](https://github.com/Microsoft/vcpkg/blob/master/ports/gdal/portfile.cmake)
-## * [libpng](https://github.com/Microsoft/vcpkg/blob/master/ports/libpng/portfile.cmake)
-
 function(vcpkg_apply_patches)
     cmake_parse_arguments(_ap "QUIET" "SOURCE_PATH" "PATCHES" ${ARGN})
 

scripts/cmake/vcpkg_configure_cmake.cmake

@@ -38,7 +38,7 @@
 ## Specifies the precise generator to use.
 ##
 ## This is useful if some project-specific buildsystem has been wrapped in a cmake script that won't perform an actual build.
-## If used for this purpose, it should be set to "NMake Makefiles".
+## If used for this purpose, it should be set to `"NMake Makefiles"`.
 ##
 ## ### OPTIONS
 ## Additional options passed to CMake during the configuration.

scripts/cmake/vcpkg_configure_meson.cmake

@@ -1,3 +1,38 @@
+## # vcpkg_configure_meson
+##
+## Configure Meson for Debug and Release builds of a project.
+##
+## ## Usage
+## ```cmake
+## vcpkg_configure_meson(
+##     SOURCE_PATH <${SOURCE_PATH}>
+##     [OPTIONS <-DUSE_THIS_IN_ALL_BUILDS=1>...]
+##     [OPTIONS_RELEASE <-DOPTIMIZE=1>...]
+##     [OPTIONS_DEBUG <-DDEBUGGABLE=1>...]
+## )
+## ```
+##
+## ## Parameters
+## ### SOURCE_PATH
+## Specifies the directory containing the `meson.build`.
+## By convention, this is usually set in the portfile as the variable `SOURCE_PATH`.
+##
+## ### OPTIONS
+## Additional options passed to Meson during the configuration.
+##
+## ### OPTIONS_RELEASE
+## Additional options passed to Meson during the Release configuration. These are in addition to `OPTIONS`.
+##
+## ### OPTIONS_DEBUG
+## Additional options passed to Meson during the Debug configuration. These are in addition to `OPTIONS`.
+##
+## ## Notes
+## This command supplies many common arguments to Meson. To see the full list, examine the source.
+##
+## ## Examples
+##
+## * [fribidi](https://github.com/Microsoft/vcpkg/blob/master/ports/fribidi/portfile.cmake)
+## * [libepoxy](https://github.com/Microsoft/vcpkg/blob/master/ports/libepoxy/portfile.cmake)
 function(vcpkg_configure_meson)
     cmake_parse_arguments(_vcm "" "SOURCE_PATH" "OPTIONS;OPTIONS_DEBUG;OPTIONS_RELEASE" ${ARGN})
     
@@ -5,16 +40,19 @@ function(vcpkg_configure_meson)
     file(REMOVE_RECURSE ${CURRENT_BUILDTREES_DIR}/${TARGET_TRIPLET}-dbg)
     
     # use the same compiler options as in vcpkg_configure_cmake
+    if(NOT VCPKG_TARGET_IS_WINDOWS)
+        message(FATAL_ERROR "vcpkg_configure_meson() currently only supports windows targets.")
+    endif()
     set(MESON_COMMON_CFLAGS "${MESON_COMMON_CFLAGS} /DWIN32 /D_WINDOWS /W3 /utf-8")
     set(MESON_COMMON_CXXFLAGS "${MESON_COMMON_CXXFLAGS} /DWIN32 /D_WINDOWS /W3 /utf-8 /GR /EHsc")
     
-    if(DEFINED VCPKG_CRT_LINKAGE AND VCPKG_CRT_LINKAGE STREQUAL dynamic)
+    if(DEFINED VCPKG_CRT_LINKAGE AND VCPKG_CRT_LINKAGE STREQUAL "dynamic")
         set(MESON_DEBUG_CFLAGS "${MESON_DEBUG_CFLAGS} /D_DEBUG /MDd /Z7 /Ob0 /Od /RTC1")
         set(MESON_DEBUG_CXXFLAGS "${MESON_DEBUG_CXXFLAGS} /D_DEBUG /MDd /Z7 /Ob0 /Od /RTC1")
         
         set(MESON_RELEASE_CFLAGS "${MESON_RELEASE_CFLAGS} /MD /O2 /Gy /DNDEBUG /Z7")
         set(MESON_RELEASE_CXXFLAGS "${MESON_RELEASE_CXXFLAGS} /MD /O2 /Gy /DNDEBUG /Z7")
-    elseif(DEFINED VCPKG_CRT_LINKAGE AND VCPKG_CRT_LINKAGE STREQUAL static)
+    elseif(DEFINED VCPKG_CRT_LINKAGE AND VCPKG_CRT_LINKAGE STREQUAL "static")
         set(MESON_DEBUG_CFLAGS "${MESON_DEBUG_CFLAGS} /D_DEBUG /MTd /Z7 /Ob0 /Od /RTC1")
         set(MESON_DEBUG_CXXFLAGS "${MESON_DEBUG_CXXFLAGS} /D_DEBUG /MTd /Z7 /Ob0 /Od /RTC1")
         
@@ -28,7 +66,7 @@ function(vcpkg_configure_meson)
     # select meson cmd-line options
     list(APPEND _vcm_OPTIONS -Dcmake_prefix_path=${CURRENT_INSTALLED_DIR})
     list(APPEND _vcm_OPTIONS --buildtype plain --backend ninja --wrap-mode nodownload)
-    if(VCPKG_LIBRARY_LINKAGE STREQUAL dynamic)
+    if(VCPKG_LIBRARY_LINKAGE STREQUAL "dynamic")
         list(APPEND _vcm_OPTIONS --default-library shared)
     else()
         list(APPEND _vcm_OPTIONS --default-library static)

scripts/cmake/vcpkg_fail_port_install.cmake

@@ -1,92 +1,95 @@
 ## # vcpkg_fail_port_install
 ##
-## Fails the current portfile with a (default) error message
+## Checks common requirements and fails the current portfile with a (default) error message
 ##
 ## ## Usage
 ## ```cmake
-## vcpkg_fail_port_install([MESSAGE <message>] 	[ON_TARGET <target1> [<target2> ...]]
+## vcpkg_fail_port_install(
-##											  	[ON_ARCH <arch1> [<arch2> ...]] 
+##     [ALWAYS]
-##											  	[ON_CRT_LINKAGE <link1> [<link2> ...]])
+##     [MESSAGE <"Reason for failure">]
-##											  	[ON_LIBRARY_LINKAGE <linklib1> [<linklib2> ...]])
+##     [ON_TARGET <Windows> [<OSX> ...]]
+##     [ON_ARCH <x64> [<arm> ...]]
+##     [ON_CRT_LINKAGE <static> [<dynamic> ...]])
+##     [ON_LIBRARY_LINKAGE <static> [<dynamic> ...]]
+## )
 ## ```
 ##
 ## ## Parameters
 ## ### MESSAGE
-## Additional failure message. If non is given a default message will be displayed depending on the failure condition
+## Additional failure message. If none is given, a default message will be displayed depending on the failure condition.
 ##
 ## ### ALWAYS
-## will always fail early
+## Will always fail early
 ##
 ## ### ON_TARGET
-## targets for which the build should fail early. Valid targets are <target> from VCPKG_IS_TARGET_<target> (see vcpkg_common_definitions.cmake)
+## Targets for which the build should fail early. Valid targets are `<target>` from `VCPKG_IS_TARGET_<target>` (see `vcpkg_common_definitions.cmake`).
 ##
 ## ### ON_ARCH
-## architecture for which the build should fail early. 
+## Architecture for which the build should fail early.
 ##
 ## ### ON_CRT_LINKAGE
 ## CRT linkage for which the build should fail early.
 ##
 ## ### ON_LIBRARY_LINKAGE
-## library linkage for which the build should fail early.
+## Library linkage for which the build should fail early.
 ##
 ## ## Examples
 ##
 ## * [aws-lambda-cpp](https://github.com/Microsoft/vcpkg/blob/master/ports/aws-lambda-cpp/portfile.cmake)
 function(vcpkg_fail_port_install)
-	cmake_parse_arguments(PARSE_ARGV 0 _csc "ALWAYS" "MESSAGE" "ON_TARGET;ON_ARCH;ON_CRT_LINKAGE;ON_LIBRARY_LINKAGE")
+    cmake_parse_arguments(PARSE_ARGV 0 _csc "ALWAYS" "MESSAGE" "ON_TARGET;ON_ARCH;ON_CRT_LINKAGE;ON_LIBRARY_LINKAGE")
-	if(DEFINED _csc_UNPARSED_ARGUMENTS)
+    if(DEFINED _csc_UNPARSED_ARGUMENTS)
-		message(FATAL_ERROR "Unknown arguments passed to vcpkg_fail_port_install. Please correct the portfile!")
+        message(FATAL_ERROR "Unknown arguments passed to vcpkg_fail_port_install. Please correct the portfile!")
-	endif()
+    endif()
-	if(DEFINED _csc_MESSAGE)
+    if(DEFINED _csc_MESSAGE)
-		set(_csc_MESSAGE "${_csc_MESSAGE}\n")		
+        set(_csc_MESSAGE "${_csc_MESSAGE}\n")
-	else()
+    else()
-		set(_csc_MESSAGE "")
+        set(_csc_MESSAGE "")
-	endif()
+    endif()
-	
-	unset(_fail_port)
-	#Target fail check
-	if(DEFINED _csc_ON_TARGET)
-		foreach(_target ${_csc_ON_TARGET})
-			string(TOUPPER ${_target} _target_upper)
-			if(VCPKG_TARGET_IS_${_target_upper})
-				set(_fail_port TRUE)
-				set(_csc_MESSAGE "${_csc_MESSAGE}Target '${_target}' not supported by ${PORT}!\n")
-			endif()
-		endforeach()
-	endif()
-	
-	#Architecture fail check
-	if(DEFINED _csc_ON_ARCH)
-		foreach(_arch ${_csc_ON_ARCH})
-			if(${VCPKG_TARGET_ARCHITECTURE} MATCHES ${_arch})
-				set(_fail_port TRUE)
-				set(_csc_MESSAGE "${_csc_MESSAGE}Architecture '${_arch}' not supported by ${PORT}!\n")
-			endif()
-		endforeach()
-	endif()
-	
-	#CRT linkage fail check
-	if(DEFINED _csc_ON_CRT_LINKAGE)
-		foreach(_crt_link ${_csc_ON_CRT_LINKAGE})
-			if("${VCPKG_CRT_LINKAGE}" MATCHES "${_crt_link}")
-				set(_fail_port TRUE)
-				set(_csc_MESSAGE "${_csc_MESSAGE}CRT linkage '${VCPKG_CRT_LINKAGE}' not supported by ${PORT}!\n")
-			endif()
-		endforeach()
-	endif()
-	
-	#Library linkage fail check
-		if(DEFINED _csc_ON_LIBRARY_LINKAGE)
-		foreach(_lib_link ${_csc_ON_LIBRARY_LINKAGE})
-			if("${VCPKG_LIBRARY_LINKAGE}" MATCHES "${_lib_link}")
-				set(_fail_port TRUE)
-				set(_csc_MESSAGE "${_csc_MESSAGE}Library linkage '${VCPKG_LIBRARY_LINKAGE}' not supported by ${PORT}!\n")
-			endif()
-		endforeach()
-	endif()
-	
-	if(_fail_port OR _csc_ALWAYS)
-		message(FATAL_ERROR ${_csc_MESSAGE})
-	endif()
 
-endfunction()
+    unset(_fail_port)
+    #Target fail check
+    if(DEFINED _csc_ON_TARGET)
+        foreach(_target ${_csc_ON_TARGET})
+            string(TOUPPER ${_target} _target_upper)
+            if(VCPKG_TARGET_IS_${_target_upper})
+                set(_fail_port TRUE)
+                set(_csc_MESSAGE "${_csc_MESSAGE}Target '${_target}' not supported by ${PORT}!\n")
+            endif()
+        endforeach()
+    endif()
+
+    #Architecture fail check
+    if(DEFINED _csc_ON_ARCH)
+        foreach(_arch ${_csc_ON_ARCH})
+            if(${VCPKG_TARGET_ARCHITECTURE} MATCHES ${_arch})
+                set(_fail_port TRUE)
+                set(_csc_MESSAGE "${_csc_MESSAGE}Architecture '${_arch}' not supported by ${PORT}!\n")
+            endif()
+        endforeach()
+    endif()
+
+    #CRT linkage fail check
+    if(DEFINED _csc_ON_CRT_LINKAGE)
+        foreach(_crt_link ${_csc_ON_CRT_LINKAGE})
+            if("${VCPKG_CRT_LINKAGE}" MATCHES "${_crt_link}")
+                set(_fail_port TRUE)
+                set(_csc_MESSAGE "${_csc_MESSAGE}CRT linkage '${VCPKG_CRT_LINKAGE}' not supported by ${PORT}!\n")
+            endif()
+        endforeach()
+    endif()
+
+    #Library linkage fail check
+        if(DEFINED _csc_ON_LIBRARY_LINKAGE)
+        foreach(_lib_link ${_csc_ON_LIBRARY_LINKAGE})
+            if("${VCPKG_LIBRARY_LINKAGE}" MATCHES "${_lib_link}")
+                set(_fail_port TRUE)
+                set(_csc_MESSAGE "${_csc_MESSAGE}Library linkage '${VCPKG_LIBRARY_LINKAGE}' not supported by ${PORT}!\n")
+            endif()
+        endforeach()
+    endif()
+
+    if(_fail_port OR _csc_ALWAYS)
+        message(FATAL_ERROR ${_csc_MESSAGE})
+    endif()
+endfunction()

scripts/cmake/vcpkg_find_acquire_program.cmake

@@ -14,9 +14,13 @@
 ## The current list of programs includes:
 ##
 ## - 7Z
+## - ARIA2 (Downloader)
 ## - BISON
+## - DARK
+## - DOXYGEN
 ## - FLEX
 ## - GASPREPROCESSOR
+## - GPERF
 ## - PERL
 ## - PYTHON2
 ## - PYTHON3
@@ -26,8 +30,8 @@
 ## - NASM
 ## - NINJA
 ## - NUGET
+## - SCONS
 ## - YASM
-## - ARIA2 (Downloader)
 ##
 ## Note that msys2 has a dedicated helper function: [`vcpkg_acquire_msys`](vcpkg_acquire_msys.md).
 ##

scripts/cmake/vcpkg_fixup_cmake_targets.cmake

@@ -1,24 +1,42 @@
-#.rst:
+## # vcpkg_fixup_cmake_targets
-# .. command:: vcpkg_fixup_cmake_targets
+##
-#
+## Merge release and debug CMake targets and configs to support multiconfig generators.
-#  Transforms all /debug/share/<port>/*targets-debug.cmake files and move them to /share/<port>.
+##
-#  Removes all /debug/share/<port>/*targets.cmake and /debug/share/<port>/*config.cmake
+## Additionally corrects common issues with targets, such as absolute paths and incorrectly placed binaries.
-#
+##
-#  Transforms all references matching /bin/*.exe to /tools/<port>/*.exe on Windows
+## ## Usage
-#  Transforms all references matching /bin/* to /tools/<port>/* on other platforms
+## ```cmake
-#
+## vcpkg_fixup_cmake_targets([CONFIG_PATH <share/${PORT}>] [TARGET_PATH <share/${PORT}>])
-#  Fixes ${_IMPORT_PREFIX} in auto generated targets to be one folder deeper. 
+## ```
-#  Replaces ${CURRENT_INSTALLED_DIR} with ${_IMPORT_PREFIX} in configs/targets.
+##
-#
+## ## Parameters
-#  ::
+##
-#  vcpkg_fixup_cmake_targets([CONFIG_PATH <config_path>])
+## ### CONFIG_PATH
-#
+## Subpath currently containing `*.cmake` files subdirectory (like `lib/cmake/${PORT}`). Should be relative to `${CURRENT_PACKAGES_DIR}`.
-#  ``CONFIG_PATH``
+##
-#    *.cmake files subdirectory (like "lib/cmake/${PORT}").
+## Defaults to `share/${PORT}`.
-# 
+##
-#	Example usage:
+## ### TARGET_PATH
-# 		vcpkg_fixup_cmake_targets(CONFIG_PATH "lib/cmake/myPort")
+## Subpath to which the above `*.cmake` files should be moved. Should be relative to `${CURRENT_PACKAGES_DIR}`.
-
+## This needs to be specified if the port name differs from the `find_package()` name.
+##
+## Defaults to `share/${PORT}`.
+##
+## ## Notes
+## Transform all `/debug/<CONFIG_PATH>/*targets-debug.cmake` files and move them to `/<TARGET_PATH>`.
+## Removes all `/debug/<CONFIG_PATH>/*targets.cmake` and `/debug/<CONFIG_PATH>/*config.cmake`.
+##
+## Transform all references matching `/bin/*.exe` to `/tools/<port>/*.exe` on Windows.
+## Transform all references matching `/bin/*` to `/tools/<port>/*` on other platforms.
+##
+## Fix `${_IMPORT_PREFIX}` in auto generated targets to be one folder deeper.
+## Replace `${CURRENT_INSTALLED_DIR}` with `${_IMPORT_PREFIX}` in configs and targets.
+##
+## ## Examples
+##
+## * [concurrentqueue](https://github.com/Microsoft/vcpkg/blob/master/ports/concurrentqueue/portfile.cmake)
+## * [curl](https://github.com/Microsoft/vcpkg/blob/master/ports/curl/portfile.cmake)
+## * [nlohmann-json](https://github.com/Microsoft/vcpkg/blob/master/ports/nlohmann-json/portfile.cmake)
 function(vcpkg_fixup_cmake_targets)
     cmake_parse_arguments(_vfct "" "CONFIG_PATH;TARGET_PATH" "" ${ARGN})
 

scripts/cmake/vcpkg_install_meson.cmake

@@ -1,7 +1,18 @@
+## # vcpkg_install_meson
+##
+## Builds a meson project previously configured with `vcpkg_configure_meson()`.
+##
+## ## Usage
+## ```cmake
+## vcpkg_install_meson()
+## ```
+##
+## ## Examples
+##
+## * [fribidi](https://github.com/Microsoft/vcpkg/blob/master/ports/fribidi/portfile.cmake)
+## * [libepoxy](https://github.com/Microsoft/vcpkg/blob/master/ports/libepoxy/portfile.cmake)
 function(vcpkg_install_meson)
-
     vcpkg_find_acquire_program(NINJA)
-
     unset(ENV{DESTDIR}) # installation directory was already specified with '--prefix' option
 
     message(STATUS "Package ${TARGET_TRIPLET}-rel")
@@ -17,5 +28,4 @@ function(vcpkg_install_meson)
         WORKING_DIRECTORY ${CURRENT_BUILDTREES_DIR}/${TARGET_TRIPLET}-dbg
         LOGNAME package-${TARGET_TRIPLET}-dbg
     )
-
 endfunction()

scripts/cmake/vcpkg_prettify_command.cmake

@@ -4,7 +4,7 @@
 ##
 ## ## Usage
 ## ```cmake
-## vcpkg_prettify_command()
+## vcpkg_prettify_command(<INPUT_VAR> <OUTPUT_VAR>)
 ## ```
 ##
 ## ## Examples