reST markup error: :16: (SEVERE/4) Unexpected section title

[anurag garg]

Hi Sphinx users, I am trying to update my orgs sphinx version from 1.8.3 to 4.0.1. When I run the `make docs` on the updated version I get a reST markup error: :16: (SEVERE/4) Unexpected section title. Is there a way I can find which file has the issue?

[Komiya Takeshi]

Hi,

Please check what command is invoked on "make docs". Basically, Sphinx
outputs a warning with its filename. So I guess this might be a
warning from other tool.

Thanks,
Takeshi KOMYA

2021年5月27日(木) 3:42 anurag garg <anura...@gmail.com>:

>
> Hi Sphinx users, I am trying to update my orgs sphinx version from 1.8.3 to 4.0.1. When I run the `make docs` on the updated version I get a reST markup error: :16: (SEVERE/4) Unexpected section title. Is there a way I can find which file has the issue?
>

> --
> You received this message because you are subscribed to the Google Groups "sphinx-users" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to sphinx-users...@googlegroups.com.
> To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/9cea210d-8649-495d-b094-be0bf61b1a87n%40googlegroups.com.

[anurag garg]

Hi Takeshi,

The make docs just calls : cd docs and make html.

The `make html` is calling: `sphinx-build -b html -d _build/doctrees  -w warnings.txt . _build/html`

Thanks,

Anurag

[anurag garg]

The warnings.txt also has this error:-

^[[91mreST markup error:^[[39;49;00m

:16: (SEVERE/4) Unexpected section title.

So I believe its emitted by Sphinx itself.

[Komiya Takeshi]

Hmm... I don't have any idea to investigate what file is wrong.
Perhaps, -v option might help you.
Sorry for not helping you.

Thanks,
Takeshi KOMIYA

2021年6月3日(木) 0:24 anurag garg <anura...@gmail.com>:

> To view this discussion on the web visit https://groups.google.com/d/msgid/sphinx-users/f9d3b9da-6dc2-408b-9209-10eec65a1cfbn%40googlegroups.com.

[anurag garg]

Hi Takeshi Komiya,

I was wondering if you are willing to help me look more into this. I work on the OCI Python SDK project. The project can be found in github at https://github.com/oracle/oci-python-sdk. To reproduce the error we would need to update the sphinx and autodocsummnary in the requirements.txt file. After this we need to comment out https://github.com/oracle/oci-python-sdk/blob/master/docs/conf.py#L271 as this feature is no longer supported in the newer Sphinx release. Then we can run `make docs` from the main directory.

Thanks for your help.

Thanks,

Anurag

[anurag garg]

Hi Takeshi Komiya,

The -v option just prints the version. I could not find any verbose option from the help menu.

Thanks,

Anurag