Use verbose cmake mode for genderate-docs

This is so that we can see sphinx errors and warnings in the logs.
Also modify scripts/gen_docs.py to accept --verbose and --cmake_opts
CLI options.

Author: oleksandr-pavlyk

.github/workflows/generate-docs.yml

@@ -76,7 +76,8 @@ jobs:
               -DCMAKE_CXX_COMPILER:PATH=$(which icpx)         \
               -DDPCTL_GENERATE_DOCS=ON                        \
               -DDPCTL_ENABLE_DOXYREST=ON                      \
-              -DDoxyrest_DIR=`pwd`/doxyrest-2.1.2-linux-amd64
+              -DDoxyrest_DIR=`pwd`/doxyrest-2.1.2-linux-amd64 \
+              -DCMAKE_VERBOSE_MAKEFILE=ON
           python -c "import dpctl; print(dpctl.__version__)" || exit 1
           pushd "$(find _skbuild -name cmake-build)" || exit 1
           cmake --build . --target Sphinx || exit 1

scripts/gen_docs.py

@@ -27,6 +27,8 @@ def run(
     compiler_root=None,
     bin_llvm=None,
     doxyrest_dir=None,
+    verbose=False,
+    cmake_opts="",
 ):
     IS_LIN = False
 
@@ -55,10 +57,16 @@ def run(
         "-DDPCTL_GENERATE_DOCS=ON",
     ]
 
+    if verbose:
+        cmake_args.append("-DCMAKE_VERBOSE_MAKEFILE=ON")
+
     if doxyrest_dir:
         cmake_args.append("-DDPCTL_ENABLE_DOXYREST=ON")
         cmake_args.append("-DDoxyrest_DIR=" + doxyrest_dir)
 
+    if cmake_opts:
+        cmake_args += cmake_opts.split()
+
     env = dict()
     if bin_llvm:
         env = {
@@ -126,6 +134,19 @@ def run(
             + "for libsyclinterface"
         ),
     )
+    driver.add_argument(
+        "--verbose",
+        help="Build using vebose makefile mode",
+        dest="verbose",
+        action="store_true",
+    )
+    driver.add_argument(
+        "--cmake-opts",
+        help="Options to pass through to cmake",
+        dest="cmake_opts",
+        default="",
+        type=str,
+    )
 
     args = parser.parse_args()
 
@@ -162,4 +183,6 @@ def run(
         compiler_root=args.compiler_root,
         bin_llvm=args.bin_llvm,
         doxyrest_dir=args.doxyrest_root,
+        verbose=args.verbose,
+        cmake_opts=args.cmake_opts,
     )