Getting error when creating documenation with INSTALL.rst instructions

[patflynngithub]

The macro/ecbuild_*files mentioned in the errors below are created in the doc/html/macros directory, but they only contain HTML boilerplate with no actual documentation information. Also, the index.html and macros.html files while showing links to many ecBuild macros, doesn't have ones to those in the errors below.

---

$ make documentation
Scanning dependencies of target documentation
[100%] sphinx-build html: see doc/build-html.log
/home/patrick/ecbuild/cmake/FindFFTW.cmake:30: WARNING: Unexpected indentation.
/home/patrick/ecbuild/cmake/FindFFTW.cmake:32: WARNING: Block quote ends without a blank line; unexpected unindent.
/home/patrick/ecbuild/cmake/ecbuild_add_lang_flags.cmake:13: WARNING: Title underline too short.

ecbuild_add_lang_flags

/home/patrick/ecbuild/cmake/ecbuild_find_package.cmake:114: WARNING: Definition list ends without a blank line; unexpected unindent.
/home/patrick/ecbuild/cmake/ecbuild_find_package_search_hints.cmake:45: WARNING: Unexpected indentation.
/home/patrick/ecbuild/doc/contrib.rst:4: WARNING: toctree contains reference to document 'contrib/FindEigen3' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/contrib.rst:4: WARNING: toctree contains reference to document 'contrib/FindNetCDF4' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/contrib.rst:4: WARNING: toctree contains reference to document 'contrib/GetGitRevisionDescription' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindCMath' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindDl' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindLEX' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindMKL' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindNetCDF' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindYACC' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/Findecbuild' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild-config' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild-config-version' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_add_large_file_support' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_check_compiler' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_check_os' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_configure_file' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_define_build_types' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_define_options' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_define_paths' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_define_properties' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_features' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_get_resources' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_list_macros' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_policies' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_project' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_project_files' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_setup_test_framework' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_source_flags' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_system' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_test_endiness' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindCMath' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindDl' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindLEX' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindMKL' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindNetCDF' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/FindYACC' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/find.rst:4: WARNING: toctree contains reference to document 'find/Findecbuild' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/contrib.rst:4: WARNING: toctree contains reference to document 'contrib/FindEigen3' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/contrib.rst:4: WARNING: toctree contains reference to document 'contrib/FindNetCDF4' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/contrib.rst:4: WARNING: toctree contains reference to document 'contrib/GetGitRevisionDescription' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild-config' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild-config-version' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_add_large_file_support' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_check_compiler' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_check_os' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_configure_file' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_define_build_types' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_define_options' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_define_paths' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_define_properties' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_features' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_get_resources' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_list_macros' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_policies' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_project' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_project_files' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_setup_test_framework' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_source_flags' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_system' that doesn't have a title: no link will be generated
/home/patrick/ecbuild/doc/macros.rst:4: WARNING: toctree contains reference to document 'macros/ecbuild_test_endiness' that doesn't have a title: no link will be generated
[100%] Built target documentation