From 4a5ab9785c33549a1b08b5604af2c716f43576da Mon Sep 17 00:00:00 2001
From: Damian Jarek <damian.jarek93@gmail.com>
Date: Thu, 21 Feb 2019 00:32:37 +0100
Subject: [PATCH] Add OpenSSL installation/setup instructions

Signed-off-by: Damian Jarek <damian.jarek93@gmail.com>
---
 CHANGELOG.md |  1 +
 README.md    | 43 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 44 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index cb72329b..7e19eac6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,7 @@
 Version 218:
 
 * detect_ssl, async_detect_ssl are public interfaces
+* Add OpenSSL installation/setup instructions
 
 --------------------------------------------------------------------------------
 
diff --git a/README.md b/README.md
index 60458878..59667d8d 100644
--- a/README.md
+++ b/README.md
@@ -131,6 +131,47 @@ From a Windows command line, build bjam using this command:
 .\BOOTSTRAP.BAT
 ```
 
+## Building tests and examples
+Building tests and examples requires OpenSSL installed. If OpenSSL is installed
+in a non-system location, you will need to copy the
+[user-config.jam](tools/user-config.jam) file into your home directory and set
+the `OPENSSL_ROOT` environment variable to the path that contains an installation
+of OpenSSL.
+
+### Ubuntu/Debian
+If installed into a system directory, OpenSSL will be automatically found and used.
+```bash
+sudo apt install libssl-dev
+```
+### Windows
+Replace `path` in the following code snippets with the path you installed vcpkg
+to. Examples assume a 32-bit build, if you build a 64-bit version replace
+`x32-windows` with `x64-windows` in the path.
+- Using [vcpkg](https://github.com/Microsoft/vcpkg) and CMD:
+```bat
+vcpkg install openssl --triplet x32-windows
+SET OPENSSL_ROOT=path\installed\x32-windows
+```
+
+- Using [vcpkg](https://github.com/Microsoft/vcpkg) and PowerShell:
+```powershell
+vcpkg install openssl --triplet x32-windows
+$env:OPENSSL_ROOT = "path\x32-windows"
+```
+
+- Using [vcpkg](https://github.com/Microsoft/vcpkg) and bash:
+```bash
+vcpkg.exe install openssl --triplet x32-windows
+export OPENSSL_ROOT=path/x32-windows
+```
+
+### Mac OS
+Using [brew](https://github.com/Homebrew/brew):
+```bash
+brew install openssl
+export OPENSSL_ROOT=$(brew --prefix openssl)
+```
+
 Make sure the bjam tool (also called "b2") is available in the path
 your shell uses to find executables. The Beast project is located in
 "libs/beast" relative to the directory containing the Boot superproject.
@@ -141,6 +182,8 @@ b2 -j2 libs/beast/example cxxstd=11   # "-j2" means use two processors
 b2 libs/beast/doc                     # Doxygen and Saxon are required for this
 ```
 
+
+
 Additional instructions for configuring, using, and building libraries
 in superproject may be found in the
 [Boost Wiki](https://github.com/boostorg/boost/wiki/Getting-Started).