aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorRobert Schumacher <roschuma@microsoft.com>2018-01-05 16:16:08 -0800
committerRobert Schumacher <roschuma@microsoft.com>2018-01-05 16:16:08 -0800
commit2b30280c222a6970fa74d05b6f7e106b4776318a (patch)
tree0c28bc3b280796ebc7cb7609794f6f9171788ab4 /docs
parent42c0cfc8705c71c3c9dcc4df4804ab342dc89988 (diff)
downloadvcpkg-2b30280c222a6970fa74d05b6f7e106b4776318a.tar.gz
vcpkg-2b30280c222a6970fa74d05b6f7e106b4776318a.zip
[vcpkg-download-distfile] Regenerate docs and enable SKIP_SHA512 only in unstable (head) mode
Diffstat (limited to 'docs')
-rw-r--r--docs/maintainers/vcpkg_download_distfile.md11
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)