Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Getting error when creating documenation with INSTALL.rst instructions #36

Open
patflynngithub opened this issue Apr 13, 2021 · 0 comments

Comments

@patflynngithub
Copy link

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant