mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2025-12-30 18:29:37 -06:00
Code Issues Packages Projects Releases Wiki Activity

CMakeVerifyManifest: Improve documentation

Browse Source 
Explain what it does.
Improve formatting.
Fix wrong lower-case m in example command.
This commit is contained in:
Christoph Grüninger
2025-01-14 22:17:01 +01:00
parent c36ba41bee
commit 470c4bcba1
1 changed files with 22 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
Modules/CMakeVerifyManifest.cmake
View File

@@ -5,26 +5,33 @@
CMakeVerifyManifest
-------------------
Use this script to verify that embedded manifests and side-by-side
manifests for a project match.
This script first recursively globs ``*.manifest`` files from
the current directory and creates a list of allowed version.
Additional versions can be passed by setting ``allow_versions``
from the invocation command.
Next, the script globs ``*.exe`` and ``*.dll`` files. Each
``.exe`` and ``.dll`` file is scanned for embedded manifests and
the versions of CRT are checked to be in the list of allowed
version.
CMakeVerifyManifest.cmake
Example
^^^^^^^
This script is used to verify that embedded manifests and side by side
manifests for a project match. To run this script, cd to a directory
and run the script with cmake -P. On the command line you can pass in
versions that are OK even if not found in the .manifest files. For
example, cmake -Dallow_versions=8.0.50608.0
-PCmakeVerifyManifest.cmake could be used to allow an embedded manifest
of 8.0.50608.0 to be used in a project even if that version was not
found in the .manifest file.
To run this script, navigate to a directory and run the script
with ``cmake -P``.
::
cmake -Dallow_versions=8.0.50608.0 -PCMakeVerifyManifest.cmake
This call allows an embedded manifest of 8.0.50608.0 to be used
in a project, even if that version was not found in a
``.manifest`` file.
#]=======================================================================]
# This script first recursively globs *.manifest files from
# the current directory. Then globs *.exe and *.dll. Each
# .exe and .dll is scanned for embedded manifests and the versions
# of CRT are compared to those found in the .manifest files
# from the first glob.
# crt_version:
# function to extract the CRT version from a file
# this can be passed a .exe, .dll, or a .manifest file