Read the Docs build information Build id: 217976 Project: espressif-esp-idf Version: release-v3.2 Commit: 5d7d46a76daea0c97fdad0127df785f00a777af0 Date: 2019-06-21T01:05:52.072080Z State: finished Success: False [rtd-command-info] start-time: 2019-06-21T01:05:52.466528Z, end-time: 2019-06-21T01:05:58.834504Z, duration: 6, exit-code: 0 git clone --no-single-branch --depth 50 https://github.com/espressif/esp-idf.git . Cloning into '.'... [rtd-command-info] start-time: 2019-06-21T01:05:59.060240Z, end-time: 2019-06-21T01:05:59.846005Z, duration: 0, exit-code: 0 git checkout --force origin/release/v3.2 Note: checking out 'origin/release/v3.2'. You are in 'detached HEAD' state. You can look around, make experimental changes and commit them, and you can discard any commits you make in this state without impacting any branches by performing another checkout. If you want to create a new branch to retain commits you create, you may do so (now or later) by using -b with the checkout command again. Example: git checkout -b HEAD is now at 5d7d46a76 Merge branch 'bugfix/docs_rtd_failure_on_missing_submodule_v3_2' into 'release/v3.2' [rtd-command-info] start-time: 2019-06-21T01:05:59.909161Z, end-time: 2019-06-21T01:05:59.931912Z, duration: 0, exit-code: 0 git clean -d -f -f [rtd-command-info] start-time: 2019-06-21T01:06:00.828692Z, end-time: 2019-06-21T01:06:03.764261Z, duration: 2, exit-code: 0 python2.7 -mvirtualenv --no-site-packages --no-download New python executable in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/bin/python2.7 Also creating executable in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/bin/python Installing setuptools, pip, wheel... done. [rtd-command-info] start-time: 2019-06-21T01:06:03.829307Z, end-time: 2019-06-21T01:06:04.739606Z, duration: 0, exit-code: 0 python -m pip install --upgrade --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/.cache/pip pip DEPRECATION: Python 2.7 will reach the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 won't be maintained after that date. A future version of pip will drop support for Python 2.7. Requirement already up-to-date: pip in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (19.1.1) [rtd-command-info] start-time: 2019-06-21T01:06:04.809856Z, end-time: 2019-06-21T01:06:13.995792Z, duration: 9, exit-code: 0 python -m pip install --upgrade --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/.cache/pip Pygments==2.3.1 setuptools==41.0.1 docutils==0.14 mock==1.0.1 pillow==5.4.1 alabaster>=0.7,<0.8,!=0.7.5 commonmark==0.8.1 recommonmark==0.5.0 sphinx<2 sphinx-rtd-theme<0.5 readthedocs-sphinx-ext<0.6 DEPRECATION: Python 2.7 will reach the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 won't be maintained after that date. A future version of pip will drop support for Python 2.7. Collecting Pygments==2.3.1 Using cached https://files.pythonhosted.org/packages/13/e5/6d710c9cf96c31ac82657bcfb441df328b22df8564d58d0c4cd62612674c/Pygments-2.3.1-py2.py3-none-any.whl Requirement already up-to-date: setuptools==41.0.1 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (41.0.1) Collecting docutils==0.14 Using cached https://files.pythonhosted.org/packages/50/09/c53398e0005b11f7ffb27b7aa720c617aba53be4fb4f4f3f06b9b5c60f28/docutils-0.14-py2-none-any.whl Collecting mock==1.0.1 Collecting pillow==5.4.1 Using cached https://files.pythonhosted.org/packages/0d/f3/421598450cb9503f4565d936860763b5af413a61009d87a5ab1e34139672/Pillow-5.4.1-cp27-cp27mu-manylinux1_x86_64.whl Collecting alabaster!=0.7.5,<0.8,>=0.7 Using cached https://files.pythonhosted.org/packages/10/ad/00b090d23a222943eb0eda509720a404f531a439e803f6538f35136cae9e/alabaster-0.7.12-py2.py3-none-any.whl Collecting commonmark==0.8.1 Using cached https://files.pythonhosted.org/packages/ab/ca/439c88039583a29564a0043186875258e9a4f041fb5c422cd387b8e10175/commonmark-0.8.1-py2.py3-none-any.whl Collecting recommonmark==0.5.0 Using cached https://files.pythonhosted.org/packages/9b/3d/92ea48401622510e57b4bdaa74dc9db2fb9e9e892324b48f9c02d716a93a/recommonmark-0.5.0-py2.py3-none-any.whl Collecting sphinx<2 Using cached https://files.pythonhosted.org/packages/7d/66/a4af242b4348b729b9d46ce5db23943ce9bca7da9bbe2ece60dc27f26420/Sphinx-1.8.5-py2.py3-none-any.whl Collecting sphinx-rtd-theme<0.5 Using cached https://files.pythonhosted.org/packages/60/b4/4df37087a1d36755e3a3bfd2a30263f358d2dea21938240fa02313d45f51/sphinx_rtd_theme-0.4.3-py2.py3-none-any.whl Collecting readthedocs-sphinx-ext<0.6 Using cached https://files.pythonhosted.org/packages/d1/f3/68de6af559ae681921a7b676a86c360454de67f3c8bd5327ae9352897ef4/readthedocs_sphinx_ext-0.5.17-py2.py3-none-any.whl Collecting future (from commonmark==0.8.1) Collecting snowballstemmer>=1.1 (from sphinx<2) Using cached https://files.pythonhosted.org/packages/d4/6c/8a935e2c7b54a37714656d753e4187ee0631988184ed50c0cf6476858566/snowballstemmer-1.2.1-py2.py3-none-any.whl Collecting sphinxcontrib-websupport (from sphinx<2) Using cached https://files.pythonhosted.org/packages/2a/59/d64bda9b7480a84a3569be4dde267c0f6675b255ba63b4c8e84469940457/sphinxcontrib_websupport-1.1.2-py2.py3-none-any.whl Collecting babel!=2.0,>=1.3 (from sphinx<2) Using cached https://files.pythonhosted.org/packages/2c/60/f2af68eb046c5de5b1fe6dd4743bf42c074f7141fe7b2737d3061533b093/Babel-2.7.0-py2.py3-none-any.whl Collecting requests>=2.0.0 (from sphinx<2) Using cached https://files.pythonhosted.org/packages/51/bd/23c926cd341ea6b7dd0b2a00aba99ae0f828be89d72b2190f27c11d4b7fb/requests-2.22.0-py2.py3-none-any.whl Collecting packaging (from sphinx<2) Using cached https://files.pythonhosted.org/packages/91/32/58bc30e646e55eab8b21abf89e353f59c0cc02c417e42929f4a9546e1b1d/packaging-19.0-py2.py3-none-any.whl Collecting Jinja2>=2.3 (from sphinx<2) Using cached https://files.pythonhosted.org/packages/1d/e7/fd8b501e7a6dfe492a433deb7b9d833d39ca74916fa8bc63dd1a4947a671/Jinja2-2.10.1-py2.py3-none-any.whl Collecting typing; python_version < "3.5" (from sphinx<2) Downloading https://files.pythonhosted.org/packages/79/be/e43ccd1317f483e14de507787322c74092a688707d02fa5f16562270eb63/typing-3.7.4-py2-none-any.whl Collecting imagesize (from sphinx<2) Using cached https://files.pythonhosted.org/packages/fc/b6/aef66b4c52a6ad6ac18cf6ebc5731ed06d8c9ae4d3b2d9951f261150be67/imagesize-1.1.0-py2.py3-none-any.whl Collecting six>=1.5 (from sphinx<2) Using cached https://files.pythonhosted.org/packages/73/fb/00a976f728d0d1fecfe898238ce23f502a721c0ac0ecfedb80e0d88c64e9/six-1.12.0-py2.py3-none-any.whl Collecting pytz>=2015.7 (from babel!=2.0,>=1.3->sphinx<2) Using cached https://files.pythonhosted.org/packages/3d/73/fe30c2daaaa0713420d0382b16fbb761409f532c56bdcc514bf7b6262bb6/pytz-2019.1-py2.py3-none-any.whl Collecting urllib3!=1.25.0,!=1.25.1,<1.26,>=1.21.1 (from requests>=2.0.0->sphinx<2) Using cached https://files.pythonhosted.org/packages/e6/60/247f23a7121ae632d62811ba7f273d0e58972d75e58a94d329d51550a47d/urllib3-1.25.3-py2.py3-none-any.whl Collecting certifi>=2017.4.17 (from requests>=2.0.0->sphinx<2) Using cached https://files.pythonhosted.org/packages/69/1b/b853c7a9d4f6a6d00749e94eb6f3a041e342a885b87340b79c1ef73e3a78/certifi-2019.6.16-py2.py3-none-any.whl Collecting chardet<3.1.0,>=3.0.2 (from requests>=2.0.0->sphinx<2) Using cached https://files.pythonhosted.org/packages/bc/a9/01ffebfb562e4274b6487b4bb1ddec7ca55ec7510b22e4c51f14098443b8/chardet-3.0.4-py2.py3-none-any.whl Collecting idna<2.9,>=2.5 (from requests>=2.0.0->sphinx<2) Using cached https://files.pythonhosted.org/packages/14/2c/cd551d81dbe15200be1cf41cd03869a46fe7226e7450af7a6545bfc474c9/idna-2.8-py2.py3-none-any.whl Collecting pyparsing>=2.0.2 (from packaging->sphinx<2) Using cached https://files.pythonhosted.org/packages/dd/d9/3ec19e966301a6e25769976999bd7bbe552016f0d32b577dc9d63d2e0c49/pyparsing-2.4.0-py2.py3-none-any.whl Collecting MarkupSafe>=0.23 (from Jinja2>=2.3->sphinx<2) Using cached https://files.pythonhosted.org/packages/fb/40/f3adb7cf24a8012813c5edb20329eb22d5d8e2a0ecf73d21d6b85865da11/MarkupSafe-1.1.1-cp27-cp27mu-manylinux1_x86_64.whl Installing collected packages: Pygments, docutils, mock, pillow, alabaster, future, commonmark, snowballstemmer, sphinxcontrib-websupport, pytz, babel, urllib3, certifi, chardet, idna, requests, pyparsing, six, packaging, MarkupSafe, Jinja2, typing, imagesize, sphinx, recommonmark, sphinx-rtd-theme, readthedocs-sphinx-ext Successfully installed Jinja2-2.10.1 MarkupSafe-1.1.1 Pygments-2.3.1 alabaster-0.7.12 babel-2.7.0 certifi-2019.6.16 chardet-3.0.4 commonmark-0.8.1 docutils-0.14 future-0.17.1 idna-2.8 imagesize-1.1.0 mock-1.0.1 packaging-19.0 pillow-5.4.1 pyparsing-2.4.0 pytz-2019.1 readthedocs-sphinx-ext-0.5.17 recommonmark-0.5.0 requests-2.22.0 six-1.12.0 snowballstemmer-1.2.1 sphinx-1.8.5 sphinx-rtd-theme-0.4.3 sphinxcontrib-websupport-1.1.2 typing-3.7.4 urllib3-1.25.3 [rtd-command-info] start-time: 2019-06-21T01:06:14.064255Z, end-time: 2019-06-21T01:06:17.512282Z, duration: 3, exit-code: 0 python -m pip install --exists-action=w --cache-dir /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/.cache/pip -r docs/requirements.txt DEPRECATION: Python 2.7 will reach the end of its life on January 1st, 2020. Please upgrade your Python as Python 2.7 won't be maintained after that date. A future version of pip will drop support for Python 2.7. Requirement already satisfied: sphinx>=1.8.4 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from -r docs/requirements.txt (line 4)) (1.8.5) Collecting breathe==4.11.1 (from -r docs/requirements.txt (line 5)) Using cached https://files.pythonhosted.org/packages/c3/60/b45d6797ddb2d013187dedb074dac9bc9bc4ffe1abc6d9bce8eabfcd5ba3/breathe-4.11.1-py2.py3-none-any.whl Requirement already satisfied: sphinx-rtd-theme in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from -r docs/requirements.txt (line 6)) (0.4.3) Collecting sphinxcontrib-blockdiag>=1.5.5 (from -r docs/requirements.txt (line 7)) Using cached https://files.pythonhosted.org/packages/25/12/df65e2b619a5f0de59c39da48a5472c1b1fa1e4f913c14a2370797bd2e1a/sphinxcontrib_blockdiag-1.5.5-py2.py3-none-any.whl Collecting sphinxcontrib-seqdiag>=0.8.5 (from -r docs/requirements.txt (line 8)) Using cached https://files.pythonhosted.org/packages/62/0d/f23e07d7b400dff9b0602de8c8b9723a6bca2646a9cb40731a8c1106614a/sphinxcontrib_seqdiag-0.8.5-py2.py3-none-any.whl Collecting sphinxcontrib-actdiag>=0.8.5 (from -r docs/requirements.txt (line 9)) Using cached https://files.pythonhosted.org/packages/84/0c/5d928f87a1c72ddfa549ba38b522330a7f1f38d735a12fd84a3dee358518/sphinxcontrib_actdiag-0.8.5-py2.py3-none-any.whl Collecting sphinxcontrib-nwdiag>=0.9.5 (from -r docs/requirements.txt (line 10)) Using cached https://files.pythonhosted.org/packages/06/14/c767a933070380ed6689eb6bd5779554d247b91e2123b3f5fc6df8a4f39e/sphinxcontrib_nwdiag-0.9.5-py2.py3-none-any.whl Requirement already satisfied: recommonmark in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from -r docs/requirements.txt (line 11)) (0.5.0) Requirement already satisfied: future>=0.16.0 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from -r docs/requirements.txt (line 12)) (0.17.1) Requirement already satisfied: alabaster<0.8,>=0.7 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (0.7.12) Requirement already satisfied: snowballstemmer>=1.1 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (1.2.1) Requirement already satisfied: Pygments>=2.0 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (2.3.1) Requirement already satisfied: sphinxcontrib-websupport in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (1.1.2) Requirement already satisfied: babel!=2.0,>=1.3 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (2.7.0) Requirement already satisfied: requests>=2.0.0 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (2.22.0) Requirement already satisfied: setuptools in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (41.0.1) Requirement already satisfied: docutils>=0.11 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (0.14) Requirement already satisfied: Jinja2>=2.3 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (2.10.1) Requirement already satisfied: typing; python_version < "3.5" in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (3.7.4) Requirement already satisfied: packaging in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (19.0) Requirement already satisfied: imagesize in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (1.1.0) Requirement already satisfied: six>=1.5 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (1.12.0) Collecting blockdiag>=1.5.0 (from sphinxcontrib-blockdiag>=1.5.5->-r docs/requirements.txt (line 7)) Using cached https://files.pythonhosted.org/packages/e6/37/a3a4d09c8cbe16b303ed75fd07381e5460b37a25fe247645f2251477887a/blockdiag-1.5.4-py2.py3-none-any.whl Collecting seqdiag>=0.9.3 (from sphinxcontrib-seqdiag>=0.8.5->-r docs/requirements.txt (line 8)) Using cached https://files.pythonhosted.org/packages/0d/45/c4afb6fb9bb7c16e28d4bedaab15195792fd49448edde0f202e850f15764/seqdiag-0.9.6-py2.py3-none-any.whl Collecting actdiag>=0.5.3 (from sphinxcontrib-actdiag>=0.8.5->-r docs/requirements.txt (line 9)) Using cached https://files.pythonhosted.org/packages/39/13/4b7b1d738cea26fbe80d1a5546628115d10b0f02880be2b724cc8004f5db/actdiag-0.5.4-py2.py3-none-any.whl Collecting nwdiag>=1.0.3 (from sphinxcontrib-nwdiag>=0.9.5->-r docs/requirements.txt (line 10)) Using cached https://files.pythonhosted.org/packages/8e/06/42e672cc4b0efddd40f0c0de412dda7c29f8a971afb54b3d77579c28aa29/nwdiag-1.0.4-py2.py3-none-any.whl Requirement already satisfied: commonmark>=0.7.3 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from recommonmark->-r docs/requirements.txt (line 11)) (0.8.1) Requirement already satisfied: pytz>=2015.7 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from babel!=2.0,>=1.3->sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (2019.1) Requirement already satisfied: urllib3!=1.25.0,!=1.25.1,<1.26,>=1.21.1 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from requests>=2.0.0->sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (1.25.3) Requirement already satisfied: certifi>=2017.4.17 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from requests>=2.0.0->sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (2019.6.16) Requirement already satisfied: chardet<3.1.0,>=3.0.2 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from requests>=2.0.0->sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (3.0.4) Requirement already satisfied: idna<2.9,>=2.5 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from requests>=2.0.0->sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (2.8) Requirement already satisfied: MarkupSafe>=0.23 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from Jinja2>=2.3->sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (1.1.1) Requirement already satisfied: pyparsing>=2.0.2 in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from packaging->sphinx>=1.8.4->-r docs/requirements.txt (line 4)) (2.4.0) Collecting webcolors (from blockdiag>=1.5.0->sphinxcontrib-blockdiag>=1.5.5->-r docs/requirements.txt (line 7)) Using cached https://files.pythonhosted.org/packages/b0/d8/cfb0da8bcbe9fd0cbeaf24d320f0353724de4f14b720338d9fd38df6c92d/webcolors-1.9.1-py2.py3-none-any.whl Requirement already satisfied: Pillow in /home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages (from blockdiag>=1.5.0->sphinxcontrib-blockdiag>=1.5.5->-r docs/requirements.txt (line 7)) (5.4.1) Collecting funcparserlib (from blockdiag>=1.5.0->sphinxcontrib-blockdiag>=1.5.5->-r docs/requirements.txt (line 7)) Installing collected packages: breathe, webcolors, funcparserlib, blockdiag, sphinxcontrib-blockdiag, seqdiag, sphinxcontrib-seqdiag, actdiag, sphinxcontrib-actdiag, nwdiag, sphinxcontrib-nwdiag Successfully installed actdiag-0.5.4 blockdiag-1.5.4 breathe-4.11.1 funcparserlib-0.3.6 nwdiag-1.0.4 seqdiag-0.9.6 sphinxcontrib-actdiag-0.8.5 sphinxcontrib-blockdiag-1.5.5 sphinxcontrib-nwdiag-0.9.5 sphinxcontrib-seqdiag-0.8.5 webcolors-1.9.1 [rtd-command-info] start-time: 2019-06-21T01:06:18.958567Z, end-time: 2019-06-21T01:06:19.266989Z, duration: 0, exit-code: 0 cat docs/en/conf.py # -*- coding: utf-8 -*- # # English Language RTD & Sphinx config file # # Uses ../conf_common.py for most non-language-specific settings. # Importing conf_common adds all the non-language-specific # parts to this conf module import sys, os sys.path.insert(0, os.path.abspath('..')) from conf_common import * # General information about the project. project = u'ESP-IDF Programming Guide' copyright = u'2016 - 2018, Espressif Systems (Shanghai) PTE LTD' # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. language = 'en' ########################################################################### # auto-created readthedocs.org specific configuration # ########################################################################### # # The following code was added during an automated build on readthedocs.org # It is auto created and injected for every build. The result is based on the # conf.py.tmpl file found in the readthedocs.org codebase: # https://github.com/rtfd/readthedocs.org/blob/master/readthedocs/doc_builder/templates/doc_builder/conf.py.tmpl # import importlib import sys import os.path from six import string_types from sphinx import version_info # Get suffix for proper linking to GitHub # This is deprecated in Sphinx 1.3+, # as each page can have its own suffix if globals().get('source_suffix', False): if isinstance(source_suffix, string_types): SUFFIX = source_suffix elif isinstance(source_suffix, (list, tuple)): # Sphinx >= 1.3 supports list/tuple to define multiple suffixes SUFFIX = source_suffix[0] elif isinstance(source_suffix, dict): # Sphinx >= 1.8 supports a mapping dictionary for mulitple suffixes SUFFIX = list(source_suffix.keys())[0] # make a ``list()`` for py2/py3 compatibility else: # default to .rst SUFFIX = '.rst' else: SUFFIX = '.rst' # Add RTD Static Path. Add to the end because it overwrites previous files. if not 'html_static_path' in globals(): html_static_path = [] if os.path.exists('_static'): html_static_path.append('_static') # Add RTD Theme only if they aren't overriding it already using_rtd_theme = ( ( 'html_theme' in globals() and html_theme in ['default'] and # Allow people to bail with a hack of having an html_style 'html_style' not in globals() ) or 'html_theme' not in globals() ) if using_rtd_theme: theme = importlib.import_module('sphinx_rtd_theme') html_theme = 'sphinx_rtd_theme' html_style = None html_theme_options = {} if 'html_theme_path' in globals(): html_theme_path.append(theme.get_html_theme_path()) else: html_theme_path = [theme.get_html_theme_path()] if globals().get('websupport2_base_url', False): websupport2_base_url = 'https://readthedocs.com/websupport' websupport2_static_url = 'https://media.readthedocs.com/' #Add project information to the template context. context = { 'using_theme': using_rtd_theme, 'html_theme': html_theme, 'current_version': "release/v3.2", 'version_slug': "release-v3.2", 'MEDIA_URL': "https://media.readthedocs.com/media/", 'STATIC_URL': "https://media.readthedocs.com/", 'PRODUCTION_DOMAIN': "readthedocs.com", 'versions': [ ("latest", "/en/latest/"), ("stable", "/en/stable/"), ("v3.3-beta3", "/en/v3.3-beta3/"), ("v3.2.1", "/en/v3.2.1/"), ("v3.2", "/en/v3.2/"), ("v3.2-rc", "/en/v3.2-rc/"), ("v3.1.4", "/en/v3.1.4/"), ("v3.1.3", "/en/v3.1.3/"), ("v3.1.2", "/en/v3.1.2/"), ("v3.1.1", "/en/v3.1.1/"), ("v3.1", "/en/v3.1/"), ("v3.1-rc2", "/en/v3.1-rc2/"), ("v3.1-rc1", "/en/v3.1-rc1/"), ("v3.0.8", "/en/v3.0.8/"), ("v3.0.7", "/en/v3.0.7/"), ("v3.0.6", "/en/v3.0.6/"), ("v3.0.5", "/en/v3.0.5/"), ("v3.0.4", "/en/v3.0.4/"), ("v3.0.3", "/en/v3.0.3/"), ("v3.0.2", "/en/v3.0.2/"), ("v3.0.1", "/en/v3.0.1/"), ("v3.0", "/en/v3.0/"), ("v2.1.1", "/en/v2.1.1/"), ("v2.1", "/en/v2.1/"), ("v2.0", "/en/v2.0/"), ("release-v3.3", "/en/release-v3.3/"), ("release-v3.2", "/en/release-v3.2/"), ("release-v3.1", "/en/release-v3.1/"), ("release-v3.0", "/en/release-v3.0/"), ], 'downloads': [ ], 'subprojects': [ ], 'slug': 'espressif-esp-idf', 'name': u'esp-idf', 'rtd_language': u'en', 'programming_language': u'c', 'canonical_url': 'https://docs.espressif.com/projects/esp-idf/en/latest/', 'analytics_code': 'UA-132861133-1', 'single_version': False, 'conf_py_path': '/docs/en/', 'api_host': 'https://readthedocs.com', 'github_user': 'espressif', 'github_repo': 'esp-idf', 'github_version': 'release/v3.2', 'display_github': True, 'bitbucket_user': 'None', 'bitbucket_repo': 'None', 'bitbucket_version': 'release/v3.2', 'display_bitbucket': False, 'gitlab_user': 'None', 'gitlab_repo': 'None', 'gitlab_version': 'release/v3.2', 'display_gitlab': False, 'READTHEDOCS': True, 'using_theme': (html_theme == "default"), 'new_theme': (html_theme == "sphinx_rtd_theme"), 'source_suffix': SUFFIX, 'ad_free': False, 'user_analytics_code': 'UA-132861133-1', 'global_analytics_code': 'UA-17997319-2', 'commit': '5d7d46a7', } if 'html_context' in globals(): html_context.update(context) else: html_context = context # Add custom RTD extension if 'extensions' in globals(): # Insert at the beginning because it can interfere # with other extensions. # See https://github.com/rtfd/readthedocs.org/pull/4054 extensions.insert(0, "readthedocs_ext.readthedocs") else: extensions = ["readthedocs_ext.readthedocs"] project_language = 'en' # User's Sphinx configurations language_user = globals().get('language', None) latex_engine_user = globals().get('latex_engine', None) latex_elements_user = globals().get('latex_elements', None) # Remove this once xindy gets installed in Docker image and XINDYOPS # env variable is supported # https://github.com/rtfd/readthedocs-docker-images/pull/98 latex_use_xindy = False chinese = any([ language_user in ('zh_CN', 'zh_TW'), project_language in ('zh_CN', 'zh_TW'), ]) japanese = any([ language_user == 'ja', project_language == 'ja', ]) if chinese: latex_engine = latex_engine_user or 'xelatex' latex_elements_rtd = { 'preamble': '\\usepackage[UTF8]{ctex}\n', } latex_elements = latex_elements_user or latex_elements_rtd elif japanese: latex_engine = latex_engine_user or 'platex' [rtd-command-info] start-time: 2019-06-21T01:06:19.328461Z, end-time: 2019-06-21T01:06:22.136732Z, duration: 2, exit-code: 2 python sphinx-build -T -b readthedocs -d _build/doctrees-readthedocs -D language=en . _build/html Running Sphinx v1.8.5 warning: tag INPUT: input source `../../components/mqtt/esp-mqtt/include/mqtt_client.h' does not exist Getting Doxyfile's INPUT Generating 'api_name.inc' files with Doxygen directives Traceback (most recent call last): File "../gen-dxd.py", line 318, in generate_api_inc_files() File "../gen-dxd.py", line 276, in generate_api_inc_files rst_output = generate_directives(header_file_path) File "../gen-dxd.py", line 248, in generate_directives tree = ET.ElementTree(file=xml_file_path) File "/home/docs/.pyenv/versions/2.7.16/lib/python2.7/xml/etree/ElementTree.py", line 611, in __init__ self.parse(file) File "", line 26, in parse IOError: [Errno 2] No such file or directory: u'xml/mqtt__client_8h.xml' Traceback (most recent call last): File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages/sphinx/cmd/build.py", line 303, in build_main args.tags, args.verbosity, args.jobs, args.keep_going) File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages/sphinx/application.py", line 201, in __init__ self.config = Config.read(self.confdir, confoverrides or {}, self.tags) File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages/sphinx/config.py", line 203, in read namespace = eval_config_file(filename, tags) File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages/sphinx/config.py", line 380, in eval_config_file raise ConfigError(msg % traceback.format_exc()) ConfigError: There is a programmable error in your configuration file: Traceback (most recent call last): File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages/sphinx/config.py", line 368, in eval_config_file execfile_(filename, namespace) File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages/sphinx/util/pycompat.py", line 150, in execfile_ exec_(code, _globals) File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages/six.py", line 709, in exec_ exec("""exec _code_ in _globs_, _locs_""") File "", line 1, in File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/checkouts/release-v3.2/docs/en/conf.py", line 11, in from conf_common import * File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/checkouts/release-v3.2/docs/conf_common.py", line 59, in call_with_python('../gen-dxd.py') File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/checkouts/release-v3.2/docs/conf_common.py", line 47, in call_with_python raise RuntimeError('{} failed'.format(cmd)) RuntimeError: ../gen-dxd.py failed Configuration error: There is a programmable error in your configuration file: Traceback (most recent call last): File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages/sphinx/config.py", line 368, in eval_config_file execfile_(filename, namespace) File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages/sphinx/util/pycompat.py", line 150, in execfile_ exec_(code, _globals) File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/envs/release-v3.2/lib/python2.7/site-packages/six.py", line 709, in exec_ exec("""exec _code_ in _globs_, _locs_""") File "", line 1, in File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/checkouts/release-v3.2/docs/en/conf.py", line 11, in from conf_common import * File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/checkouts/release-v3.2/docs/conf_common.py", line 59, in call_with_python('../gen-dxd.py') File "/home/docs/checkouts/readthedocs.org/user_builds/espressif-esp-idf/checkouts/release-v3.2/docs/conf_common.py", line 47, in call_with_python raise RuntimeError('{} failed'.format(cmd)) RuntimeError: ../gen-dxd.py failed Calling Doxygen to generate latest XML files