Merge pull request #1399 from jasonrandrews/review

Test OpenCV on Windows Learning Path

Author: jasonrandrews

content/learning-paths/laptops-and-desktops/win-opencv/1-opencv-compilers.md

@@ -75,6 +75,6 @@ The instructions were tested with the version 18.1.8.
 The instructions were tested with version 1.11.1
 {{% /notice %}}
 
-You use the LLVM Clang and the Ninja generator to build. Set PATH to the paths to your LLVM and Ninja install.
+Make sure LLVM Clang and Ninja are in your search path. If they are not, you can use Windows Control Panel to set the PATH environment variable.
 
 You now have the required development tools installed. Please proceed to the page for the compiler you want to build with.

content/learning-paths/laptops-and-desktops/win-opencv/2-1-build-msvc.md

@@ -8,6 +8,8 @@ layout: learningpathall
 
 ## How do I build OpenCV with MSVC?
 
+Follow the steps below to build OpenCV and a test application using the library with the MSVC compiler.
+
 ### Clone the OpenCV repository
 
 Open up a Windows PowerShell and checkout the source tree:
@@ -113,7 +115,7 @@ The build takes approximately 25 mins on a Lenovo X13s
 
 When the build and the install steps are complete, confirm the shared library has been created by inspecting the results in the `install/bin` directory:
 
-```bash { output_lines = "2-11" }
+```bash { output_lines = "2-12" }
 ls ./install/x64/vc17/bin
     Directory: C:\Users\username\work\opencv\build_msvc\install\x64\vc17\bin
 Mode                 LastWriteTime         Length Name

content/learning-paths/laptops-and-desktops/win-opencv/2-2-build-clang.md

@@ -8,6 +8,8 @@ layout: learningpathall
 
 ## How do I build OpenCV with Clang?
 
+Follow the steps below to build OpenCV and a test application using the library with the Clang compiler.
+
 ### Clone the OpenCV repository
 
 Open up a Windows Powershell and checkout the source tree:
@@ -198,11 +200,7 @@ The given options specify the following:
 
 ### Run the program
 
-To run the executable, you need to ensure that the directory containing the dynamic libraries (DLLs) is added to the `PATH` environment variable, or place the DLLs in the same location as the executable.
-
-```bash
-.\test_opencv.exe
-```
+To run the executable, you need to ensure that the directory containing the dynamic libraries (DLLs) is added to the `PATH` environment variable, or place the DLLs in the same location as the executable. 
 
 {{% notice Note %}}
 The command below adds the DLL directory to the beginning of the `PATH` environment variable. Since this is a temporary setting, the `PATH` will revert to its original state when the PowerShell session is closed. To set it permanently, you need to use the Windows system settings or the `[Environment]::SetEnvironmentVariable()` method.
@@ -212,7 +210,13 @@ $env:PATH = "./install/bin;" + $env:PATH
 ```
 {{% /notice %}}
 
-When you execute the command, it will finish quickly, and `test_image.png` is generated. 
+Run the test program:
+
+```bash
+.\test_opencv.exe
+```
+
+When you execute the command, it will finish quickly, and `test_image.png` is generated. If you don't have the DLL directory in your search path, the program appears to run, but no `test_image.png` is generated. 
 
 Open the image file, it should look like the example shown below.