From ff9738ffc710781c4b930789f9b462f9fdde081d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dawid=20Wr=C3=B3bel?= <me@dawidwrobel.com>
Date: Thu, 29 Jul 2021 13:16:04 +0200
Subject: [PATCH] [docs] Instruct how to deploy several license files

Many projects will have more than a single license. Such projects typically have a LICENSES folder with SPDX copies of them. This explains how to copy them all instead just a single one.

Such projects with multiple licenses should be officially recognized, so that maintainers are aware of it. See e.g.: https://github.com/microsoft/vcpkg/pull/19199#pullrequestreview-717624939
https://github.com/microsoft/vcpkg/pull/19200#discussion_r678871016
---
 docs/examples/packaging-github-repos.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/examples/packaging-github-repos.md b/docs/examples/packaging-github-repos.md
index 3a0e81c2f93a46..2dd5d3561ae3f0 100644
--- a/docs/examples/packaging-github-repos.md
+++ b/docs/examples/packaging-github-repos.md
@@ -37,7 +37,13 @@ vcpkg_configure_cmake(
     PREFER_NINJA
 )
 vcpkg_install_cmake()
-file(INSTALL ${SOURCE_PATH}/COPYING DESTINATION ${CURRENT_PACKAGES_DIR}/share/libogg RENAME copyright)
+file(INSTALL "${SOURCE_PATH}/COPYING" DESTINATION "${CURRENT_PACKAGES_DIR}/share/${PORT}" RENAME copyright)
+```
+
+Should your project contain more than a single license file, e.g. SPDX licenses located in a `LICENSES` folder, you can instead copy them all with:
+
+```
+file(INSTALL "${SOURCE_PATH}/LICENSES/" DESTINATION "${CURRENT_PACKAGES_DIR}/share/${PORT}/copyright")
 ```
 
 Check the documentation for [`vcpkg_configure_cmake`](../maintainers/vcpkg_configure_cmake.md) and [`vcpkg_install_cmake`](../maintainers/vcpkg_install_cmake.md) if your package needs additional options.