Reworked documentation building to work with extra modules.

The main problem with extra modules is that they're located outside
of the OpenCV root, while Sphinx requires that all documents are
within the documentation root. To circumvent this, we create a
"fake root" and copy all documentation (as well as all files that
it depends on) there. It's a bit messy, but what can you do.

As a bonus, this eliminates the need to generate modules/refman.rst
inside the source tree.

Merge pull request #1775 from ilya-lavrenov:ocl_cvtColor

Merge pull request #1782 from ilya-lavrenov:ocl_adapBilat

Merge pull request #1766 from ilya-lavrenov:ocl_remap_linear

Merge pull request #1773 from ilya-lavrenov:ocl_buildWarpPerspectiveMaps

Merge pull request #1783 from SpecLad:cap-no-pattern

added RGB5x5 <-> Gray

removed 2000x2000, 4000x4000 from test sizes of ocl::adaptiveBilateralFilter

Fixed the "image sequence" capture not failing when a pattern isn't found.

at can't be a null pointer, so the condition was always false, and
a nonsensical pattern like "image.png%00d" was being inferred.

added a performance test for ocl::buildWarpPerspectiveMaps; moved warps to a separate file

Merge pull request #1780 from ilya-lavrenov:ocl_m_pi

added RGB5x5 <-> RGB conversion

replaced custom PI by OpenCL M_PI constant

added RGB[A] <-> BGR[A] conversion to ocl::cvtColor

added XYZ to RGB conversion to ocl::cvtColor

added RGB -> XYZ conversion to ocl::cvtColor

color.cpp refactoring: created generic interface for toRGB and fromRGB callers

added YCrCb to RGB, BGR, RGBA, BGRA modes to ocl::cvtColor

fixed ocl::cvtColor for CV_YUV2BGRA and CV_YUV2RGBA

added an accuracy test for ocl::buildWarpPerspectiveMaps

added ROI support to ocl::buildWarp*Maps functions

Merge pull request #1771 from kiranpradeep:2.4

CMake's get_filename_component with NAME_WE parameters, interprets first period as start of extension. For. e.g file name with out extension of 'this.is.a.text.file.txt' will be taken as 'this'. Hence using NAME with regex replacement to get 'this.is.a.text.file'

Merge pull request #1759 from ilya-lavrenov:ocl_distanceToCenters

Merge pull request #1755 from KonstantinMatskevich:dump_info

Merge pull request #1763 from SpecLad:cv-func

added CV_16SC2 && CV_16UC1 map types support to ocl::remap (INTER_LINEAR mode)

Merge pull request #1760 from ilya-lavrenov:ocl_remap_nn

Enabled CV_Assert and such to print the function name with Visual C++.

Also, I made a separate macro for the current function name, which
helps simplify a lot of code that uses it.

update

Merge pull request #1737 from vrabaud:2.4

added CV_16SC2 && CV_16UC1 maps support to ocl::remap (nearest neighbour only)

speeded up ocl::distanceToCenters

Merge pull request #1756 from alalek:ocl_workaround_memory_leaks_with_subbuffer

Merge pull request #1758 from apavlenko:adaptive_bilateral_filter

Merge pull request #1757 from asmorkalov:android_manager_version_inc2

Cleaned up adaptive bilateral filtering, added support for gaussian interpolation, updated sample and docs

extending openCL info dump

Merge pull request #1711 from SpecLad:cap-broken-mat

Android Manager Version++.

ocl: workaround for subbuffer memory leaks

Merge pull request #1750 from alalek:ocl_update_documentation

Merge pull request #1740 from ilya-lavrenov:ocl_corners

Merge pull request #1739 from pengx17:2.4_ocl_overload_haar

Merge pull request #1743 from ilya-lavrenov:ocl_repeat

Revert back test image.

ocl: update comments in ocl.hpp

ocl: update documentation

Merge pull request #1752 from alalek:ocl_memory_cleanup_workaround

Merge pull request #1751 from ilya-lavrenov:ocl_copyMakeBorder_test_fix

Merge pull request #1745 from alalek:ocl_fix_svm_with_blas

ocl: memory cleanup workaround: clFinish() before clReleaseMemObject() + 64kb memory guard

Merge pull request #1749 from SpecLad:update-ignore

fixed ocl::copyMakeBorder accuracy test

ocl: svm: restore non BLAS version

Revert "disable SVM when AMD BLAS is not available"

This reverts commit d63a38e9bfad4081ec8107e8d38e03c03f6548d2.

Conflicts:
modules/ocl/test/test_ml.cpp

add VERBATIM as advised by @SpecLad

fix the crash as suggested by @SpecLad

came back to relative error

Sorted .gitignore.

Update .gitignore.

* OpenCV4Tegra/ is no longer relevant.
* We should only ignore the particular refman.rst that we generate.

added ocl::repeat

Let perf/accuracy test of ocl haar uses detectMultiScale api.
Fix image to be used by perf test.

fixed warnings in OpenCL kernels

fixed ocl::cornerHarris, ocl::cornerMinEigenVal and their accuracy tests

Overload detectMultiScale API for ocl::haar.

fix crash when path has spaces
The paths are defined properly with an escape "\ " but you cannot have an escape and
quotes when piping (otherwise, escapes are understood as 2 characters).
So just remove the quotes.

Merge pull request #1736 from alalek:ocl_fix_corner_memory_access

Merge pull request #1731 from perping:2.4_haar

Merge pull request #1734 from asmorkalov:android_manager_version_inc

ocl: corner*: fix memory access in kernels; change error check to relative

Merge pull request #1733 from ilya-lavrenov:cv_remap

Merge pull request #1732 from alalek:ocl_blendLinear

OpenCV Version++. OpenCV Manager Version++.

consistency SSE2 and plain versions of convertMaps and remap

ocl: fix testdata for blendLinear

remove whitespace.

Merge pull request #1729 from ilya-lavrenov:ocl_moments

Merge pull request #1730 from ilya-lavrenov:ocl_kern_warn

Merge pull request #1728 from apavlenko:refactor_vcap_jni

fixed a bug of haar.

fixed ocl::Moments test

fixed warnings in ocl kernels

Merge pull request #1727 from ilya-lavrenov:ocl_warpPerspective

Merge pull request #1726 from melody-rain:2.4_tvl1_ocl

Merge pull request #1724 from ilya-lavrenov:ocl_thresh

Merge pull request #1710 from melody-rain:2.4_moments_ocl

fixed ocl::warpPerspective

minor refactoring of Android VideoCapture jni code to make it similar to generated one

fixed a typo.

removed test for double since not all platforms support double, thus the sanity check cannot pass on all the platforms.

Resolved a bug and used ocl::multiply.

vectorized ocl::threshold for single channel images

modified the copyright info.

Merge pull request #1709 from ilya-lavrenov:ocl_cornerharris

Merge pull request #1723 from ilya-lavrenov:ocl_norm

Merge pull request #1721 from alalek:ocl_fix_filter2D_64F_kernel

Merge pull request #1719 from ilya-lavrenov:ocl_gaussianBlur

Merge pull request #1717 from alalek:ocl_adjust_worksize

Merge pull request #1715 from asmorkalov:android_java_bincompat_fix