espressif / ESP8266_RTOS_SDK

Latest ESP8266 SDK based on FreeRTOS, esp-idf style.
http://bbs.espressif.com
Apache License 2.0
3.35k stars 1.57k forks source link

can't build docs (GIT8266O-826) #1249

Open zoldseges opened 1 year ago

zoldseges commented 1 year ago

Environment

Problem Description

Can't build docs.

Actual Behavior

Steps to repropduce

$ ESP8266_RTOS_SDK/docs/en: make html

Debug Logs

Getting Doxyfile's INPUT
Generating 'api_name.inc' files with Doxygen directives
Traceback (most recent call last):
  File "/mnt/storage/tools/ESP8266_RTOS_SDK/docs/en/../gen-dxd.py", line 318, in <module>
    generate_api_inc_files()
  File "/mnt/storage/tools/ESP8266_RTOS_SDK/docs/en/../gen-dxd.py", line 276, in generate_api_inc_files
    rst_output = generate_directives(header_file_path)
                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/mnt/storage/tools/ESP8266_RTOS_SDK/docs/en/../gen-dxd.py", line 248, in generate_directives
    tree = ET.ElementTree(file=xml_file_path)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.11/xml/etree/ElementTree.py", line 540, in __init__
    self.parse(file)
  File "/usr/lib/python3.11/xml/etree/ElementTree.py", line 569, in parse
    source = open(source, "rb")
             ^^^^^^^^^^^^^^^^^^
FileNotFoundError: [Errno 2] No such file or directory: 'xml/esp__wifi_8h.xml'

Configuration error:
There is a programmable error in your configuration file:

Traceback (most recent call last):
  File "/home/adam/.espressif/python_env/rtos3.4_py3.11_env/lib/python3.11/site-packages/sphinx/config.py", line 354, in eval_config_file
    exec(code, namespace)  # NoQA: S102
    ^^^^^^^^^^^^^^^^^^^^^
  File "/mnt/storage/tools/ESP8266_RTOS_SDK/docs/en/conf.py", line 11, in <module>
    from conf_common import *
  File "/mnt/storage/tools/ESP8266_RTOS_SDK/docs/conf_common.py", line 59, in <module>
    call_with_python('../gen-dxd.py')
  File "/mnt/storage/tools/ESP8266_RTOS_SDK/docs/conf_common.py", line 47, in call_with_python
    raise RuntimeError('{} failed'.format(cmd))
RuntimeError: ../gen-dxd.py failed

make: *** [../docs_common.mk:68: html] Error 2
wojtess commented 11 months ago

same here, did you resolved it?

zoldseges commented 11 months ago

@wojtess no :(