Skip to content

Documentation build is broken #324

New issue
New issue
Closed
Closed
Documentation build is broken#324
Labels
cat:bugbug/error/mistake which limits the programcat:documentationdocumentationprio:highThis has high priority.
@IceflowRE

Description

@IceflowRE
IceflowRE
opened on Mar 27, 2021

log: https://readthedocs.org/api/v2/build/13357270.txt

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 6033, in _parse_declarator
    res = self._parse_declarator_name_suffix(named, paramMode, typed)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 5915, in _parse_declarator_name_suffix
    paramQual = self._parse_parameters_and_qualifiers(paramMode)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 5670, in _parse_parameters_and_qualifiers
    self.fail('Expecting "(" in parameters-and-qualifiers.')
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/util/cfamily.py", line 291, in fail
    raise self._make_multi_error(errors, '')
sphinx.util.cfamily.DefinitionError: Invalid C++ declaration: Expecting "(" in parameters-and-qualifiers. [error at 11]
  VKAPI_ATTR VkBool32 VKAPI_CALL vulkan_debug_message_callback (VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT object_type, std::uint64_t object, std::size_t location, std::int32_t message_code, const char *layer_prefix, const char *message, void *user_data)
  -----------^

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 6116, in _parse_type
    decl = self._parse_declarator(named=True, paramMode=outer,
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 6043, in _parse_declarator
    raise self._make_multi_error(prevErrors, header) from e
sphinx.util.cfamily.DefinitionError: Error in declarator or parameters-and-qualifiers
Invalid C++ declaration: Expecting "(" in parameters-and-qualifiers. [error at 11]
  VKAPI_ATTR VkBool32 VKAPI_CALL vulkan_debug_message_callback (VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT object_type, std::uint64_t object, std::size_t location, std::int32_t message_code, const char *layer_prefix, const char *message, void *user_data)
  -----------^

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 6033, in _parse_declarator
    res = self._parse_declarator_name_suffix(named, paramMode, typed)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 5915, in _parse_declarator_name_suffix
    paramQual = self._parse_parameters_and_qualifiers(paramMode)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 5670, in _parse_parameters_and_qualifiers
    self.fail('Expecting "(" in parameters-and-qualifiers.')
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/util/cfamily.py", line 291, in fail
    raise self._make_multi_error(errors, '')
sphinx.util.cfamily.DefinitionError: Invalid C++ declaration: Expecting "(" in parameters-and-qualifiers. [error at 20]
  VKAPI_ATTR VkBool32 VKAPI_CALL vulkan_debug_message_callback (VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT object_type, std::uint64_t object, std::size_t location, std::int32_t message_code, const char *layer_prefix, const char *message, void *user_data)
  --------------------^

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 6130, in _parse_type
    decl = self._parse_declarator(named=True, paramMode=outer)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 6043, in _parse_declarator
    raise self._make_multi_error(prevErrors, header) from e
sphinx.util.cfamily.DefinitionError: Error in declarator or parameters-and-qualifiers
If pointer to member declarator:
  Invalid C++ declaration: Expected '::' in pointer to member (function). [error at 20]
    VKAPI_ATTR VkBool32 VKAPI_CALL vulkan_debug_message_callback (VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT object_type, std::uint64_t object, std::size_t location, std::int32_t message_code, const char *layer_prefix, const char *message, void *user_data)
    --------------------^
If declarator-id:
  Invalid C++ declaration: Expecting "(" in parameters-and-qualifiers. [error at 20]
    VKAPI_ATTR VkBool32 VKAPI_CALL vulkan_debug_message_callback (VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT object_type, std::uint64_t object, std::size_t location, std::int32_t message_code, const char *layer_prefix, const char *message, void *user_data)
    --------------------^


The above exception was the direct cause of the following exception:

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/cmd/build.py", line 280, in build_main
    app.build(args.force_all, filenames)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/application.py", line 352, in build
    self.builder.build_update()
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 296, in build_update
    self.build(to_build,
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 310, in build
    updated_docnames = set(self.read())
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 417, in read
    self._read_serial(docnames)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 438, in _read_serial
    self.read_doc(docname)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/builders/__init__.py", line 478, in read_doc
    doctree = read_doc(self.app, self.env, self.env.doc2path(docname))
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/io.py", line 221, in read_doc
    pub.publish()
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/core.py", line 217, in publish
    self.document = self.reader.read(self.source, self.parser,
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/io.py", line 126, in read
    self.parse()
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/readers/__init__.py", line 77, in parse
    self.parser.parse(self.input, document)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/parsers.py", line 104, in parse
    self.statemachine.run(inputlines, document, inliner=self.inliner)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 170, in run
    results = StateMachineWS.run(self, input_lines, input_offset,
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/statemachine.py", line 241, in run
    context, next_state, result = self.check_line(
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/statemachine.py", line 459, in check_line
    return method(match, context, next_state)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 2769, in underline
    self.section(title, source, style, lineno - 1, messages)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 327, in section
    self.new_subsection(title, lineno, messages)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 393, in new_subsection
    newabsoffset = self.nested_parse(
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 281, in nested_parse
    state_machine.run(block, input_offset, memo=self.memo,
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 196, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/statemachine.py", line 241, in run
    context, next_state, result = self.check_line(
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/statemachine.py", line 459, in check_line
    return method(match, context, next_state)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 2769, in underline
    self.section(title, source, style, lineno - 1, messages)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 327, in section
    self.new_subsection(title, lineno, messages)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 393, in new_subsection
    newabsoffset = self.nested_parse(
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 281, in nested_parse
    state_machine.run(block, input_offset, memo=self.memo,
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 196, in run
    results = StateMachineWS.run(self, input_lines, input_offset)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/statemachine.py", line 241, in run
    context, next_state, result = self.check_line(
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/statemachine.py", line 459, in check_line
    return method(match, context, next_state)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 2342, in explicit_markup
    nodelist, blank_finish = self.explicit_construct(match)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 2354, in explicit_construct
    return method(self, expmatch)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 2096, in directive
    return self.run_directive(
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/docutils/parsers/rst/states.py", line 2146, in run_directive
    result = directive_instance.run()
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/breathe/directives.py", line 108, in run
    node_stack = self._resolve_function(matches, args, project_info)
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/breathe/directives.py", line 216, in _resolve_function
    signature = self._create_function_signature(entry, project_info, filter_,
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/breathe/directives.py", line 194, in _create_function_signature
    ast = parser.parse_declaration('function', 'function')
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 6594, in parse_declaration
    declaration = self._parse_type(named=True, outer='function')
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 6151, in _parse_type
    raise self._make_multi_error(prevErrors, header) from exTyped
sphinx.util.cfamily.DefinitionError: Error when parsing function declaration.
If the function has no return type:
  Error in declarator or parameters-and-qualifiers
  Invalid C++ declaration: Expecting "(" in parameters-and-qualifiers. [error at 11]
    VKAPI_ATTR VkBool32 VKAPI_CALL vulkan_debug_message_callback (VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT object_type, std::uint64_t object, std::size_t location, std::int32_t message_code, const char *layer_prefix, const char *message, void *user_data)
    -----------^
If the function has a return type:
  Error in declarator or parameters-and-qualifiers
  If pointer to member declarator:
    Invalid C++ declaration: Expected '::' in pointer to member (function). [error at 20]
      VKAPI_ATTR VkBool32 VKAPI_CALL vulkan_debug_message_callback (VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT object_type, std::uint64_t object, std::size_t location, std::int32_t message_code, const char *layer_prefix, const char *message, void *user_data)
      --------------------^
  If declarator-id:
    Invalid C++ declaration: Expecting "(" in parameters-and-qualifiers. [error at 20]
      VKAPI_ATTR VkBool32 VKAPI_CALL vulkan_debug_message_callback (VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT object_type, std::uint64_t object, std::size_t location, std::int32_t message_code, const char *layer_prefix, const char *message, void *user_data)
      --------------------^


Exception occurred:
  File "/home/docs/checkouts/readthedocs.org/user_builds/inexor-vulkan-renderer/envs/latest/lib/python3.8/site-packages/sphinx/domains/cpp.py", line 6151, in _parse_type
    raise self._make_multi_error(prevErrors, header) from exTyped
sphinx.util.cfamily.DefinitionError: Error when parsing function declaration.
If the function has no return type:
  Error in declarator or parameters-and-qualifiers
  Invalid C++ declaration: Expecting "(" in parameters-and-qualifiers. [error at 11]
    VKAPI_ATTR VkBool32 VKAPI_CALL vulkan_debug_message_callback (VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT object_type, std::uint64_t object, std::size_t location, std::int32_t message_code, const char *layer_prefix, const char *message, void *user_data)
    -----------^
If the function has a return type:
  Error in declarator or parameters-and-qualifiers
  If pointer to member declarator:
    Invalid C++ declaration: Expected '::' in pointer to member (function). [error at 20]
      VKAPI_ATTR VkBool32 VKAPI_CALL vulkan_debug_message_callback (VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT object_type, std::uint64_t object, std::size_t location, std::int32_t message_code, const char *layer_prefix, const char *message, void *user_data)
      --------------------^
  If declarator-id:
    Invalid C++ declaration: Expecting "(" in parameters-and-qualifiers. [error at 20]
      VKAPI_ATTR VkBool32 VKAPI_CALL vulkan_debug_message_callback (VkDebugReportFlagsEXT flags, VkDebugReportObjectTypeEXT object_type, std::uint64_t object, std::size_t location, std::int32_t message_code, const char *layer_prefix, const char *message, void *user_data)
      --------------------^
The full traceback has been saved in /tmp/sphinx-err-77xnt39c.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!

Metadata

Metadata

Assignees

No one assigned

    Labels

    cat:bugbug/error/mistake which limits the programcat:documentationdocumentationprio:highThis has high priority.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions