diff options
| author | Robert Schumacher <roschuma@microsoft.com> | 2018-01-05 16:48:59 -0800 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2018-01-05 16:48:59 -0800 |
| commit | 2dab9a2576a4f2c03d65abc9ad2668d2f34c6ba5 (patch) | |
| tree | 0c28bc3b280796ebc7cb7609794f6f9171788ab4 /docs | |
| parent | cf802347a47279e43bb37592437f3632bcdc5374 (diff) | |
| parent | 2b30280c222a6970fa74d05b6f7e106b4776318a (diff) | |
| download | vcpkg-2dab9a2576a4f2c03d65abc9ad2668d2f34c6ba5.tar.gz vcpkg-2dab9a2576a4f2c03d65abc9ad2668d2f34c6ba5.zip | |
Merge pull request #2469 from Mixaill/fix_github_head
[vcpkg] fix --head flag for github-based ports
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/maintainers/vcpkg_download_distfile.md | 11 |
1 files changed, 9 insertions, 2 deletions
diff --git a/docs/maintainers/vcpkg_download_distfile.md b/docs/maintainers/vcpkg_download_distfile.md index 7897610e3..80ea7559a 100644 --- a/docs/maintainers/vcpkg_download_distfile.md +++ b/docs/maintainers/vcpkg_download_distfile.md @@ -2,6 +2,8 @@ Download and cache a file needed for this port. +This helper should always be used instead of CMake's built-in `file(DOWNLOAD)` command. + ## Usage ```cmake vcpkg_download_distfile( @@ -26,12 +28,17 @@ The expected hash for the file. If this doesn't match the downloaded version, the build will be terminated with a message describing the mismatch. +### SKIP_SHA512 +Skip SHA512 hash check for file. + +This switch is only valid when building with the `--head` command line flag. + ## Notes -The command [`vcpkg_from_github`](vcpkg_from_github.md) should be used instead of this for downloading the main archive for GitHub projects. +The helper [`vcpkg_from_github`](vcpkg_from_github.md) should be used for downloading from GitHub projects. ## Examples -* [boost](https://github.com/Microsoft/vcpkg/blob/master/ports/boost/portfile.cmake) +* [apr](https://github.com/Microsoft/vcpkg/blob/master/ports/apr/portfile.cmake) * [fontconfig](https://github.com/Microsoft/vcpkg/blob/master/ports/fontconfig/portfile.cmake) * [openssl](https://github.com/Microsoft/vcpkg/blob/master/ports/openssl/portfile.cmake) |