[
https://issues.apache.org/jira/browse/ARROW-13353?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17382093#comment-17382093
]
David Li commented on ARROW-13353:
----------------------------------
Breathe/Sphinx fail on parsing arrow::Status. The reason is that Breathe in
{{visit_templateparamlist}} tries to parse each template parameter by using
Sphinx's DefinitionParser, only if we have Sphinx >= 4.1.0. But Sphinx can't
handle {{template...}}. If we don't have a new enough Sphinx, it'll just append
the template parameter as text. Presumably at some point CI updated Sphinx and
hence we started failing.
> [Documentation] Build failing with sphinx.util.cfamily.DefinitionError
> ----------------------------------------------------------------------
>
> Key: ARROW-13353
> URL: https://issues.apache.org/jira/browse/ARROW-13353
> Project: Apache Arrow
> Issue Type: Bug
> Components: Documentation
> Reporter: David Li
> Priority: Major
>
> Might need someone to dig into the sphinx internals to try to get more info
> about the failure.
> {noformat}
> Sphinx parallel build error:
> sphinx.util.cfamily.DefinitionError: Invalid C++ declaration: Expected
> identifier in nested name. [error at 8]
> typename...
> --------^
> 2
> Error: `docker-compose --file /home/vsts/work/1/s/arrow/docker-compose.yml
> run --rm -e SETUPTOOLS_SCM_PRETEND_VERSION=5.0.0.dev445 ubuntu-docs` exited
> with a non-zero exit code 2, see the process log above.The docker-compose
> command was invoked with the following parameters: {noformat}
> [https://dev.azure.com/ursacomputing/crossbow/_build/results?buildId=8115&view=logs&j=0da5d1d9-276d-5173-c4c4-9d4d4ed14fdb&t=d9b15392-e4ce-5e4c-0c8c-b69645229181]
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
