aboutsummaryrefslogtreecommitdiff
path: root/scripts
diff options
context:
space:
mode:
authorRobert Schumacher <roschuma@microsoft.com>2018-11-06 15:47:02 -0800
committerRobert Schumacher <roschuma@microsoft.com>2018-11-06 15:47:02 -0800
commitd2ffdca39b4cbc250d4ae753b6017f9fa631b5bb (patch)
tree3e8a2bae21a1eafba6b21c041ba542330f30518a /scripts
parent2c72e57bf453c7d22744cb210e28a6c967f4ed25 (diff)
downloadvcpkg-d2ffdca39b4cbc250d4ae753b6017f9fa631b5bb.tar.gz
vcpkg-d2ffdca39b4cbc250d4ae753b6017f9fa631b5bb.zip
[docs] Regenerate docs for vcpkg_from_git
Diffstat (limited to 'scripts')
-rw-r--r--scripts/cmake/vcpkg_from_git.cmake14
1 files changed, 11 insertions, 3 deletions
diff --git a/scripts/cmake/vcpkg_from_git.cmake b/scripts/cmake/vcpkg_from_git.cmake
index c2965292d..5f6930412 100644
--- a/scripts/cmake/vcpkg_from_git.cmake
+++ b/scripts/cmake/vcpkg_from_git.cmake
@@ -7,7 +7,8 @@
## vcpkg_from_git(
## OUT_SOURCE_PATH <SOURCE_PATH>
## URL <https://android.googlesource.com/platform/external/fdlibm>
-## [REF <59f7335e4d...>]
+## REF <59f7335e4d...>
+## SHA512 <abcdef123...>
## [PATCHES <patch1.patch> <patch2.patch>...]
## )
## ```
@@ -21,8 +22,15 @@
## ### URL
## The url of the git repository.
##
+## ### SHA512
+## The SHA512 hash that should match the archive form of the commit.
+##
+## This is most easily determined by first setting it to `0`, then trying to build the port. The error message will contain the full hash, which can be copied back into the portfile.
+##
## ### REF
-## The full commit id of the current latest master.
+## A stable git commit-ish (ideally a tag or commit) that will not change contents. **This should not be a branch.**
+##
+## For repositories without official releases, this can be set to the full commit id of the current latest master.
##
## ### PATCHES
## A list of patches to be applied to the extracted sources.
@@ -30,7 +38,7 @@
## Relative paths are based on the port directory.
##
## ## Notes:
-## `REF` and `URL` must be specified.
+## `OUT_SOURCE_PATH`, `REF`, `SHA512`, and `URL` must be specified.
##
## ## Examples:
##