Read the Docs build information
Build id: 1725369
Project: advanced-micro-devices-hiprand
Version: latest
Commit: fe62fdc2e8e717bb4ab3218acd3e509ce167ce87
Date: 2023-09-16T00:52:07.590782Z
State: finished
Success: False


[rtd-command-info] start-time: 2023-09-16T00:52:14.922401Z, end-time: 2023-09-16T00:52:15.498654Z, duration: 0, exit-code: 0
git clone --depth 1 https://github.com/ROCmSoftwarePlatform/hipRAND.git .
Cloning into '.'...

[rtd-command-info] start-time: 2023-09-16T00:52:15.942681Z, end-time: 2023-09-16T00:52:17.213435Z, duration: 1, exit-code: 0
git fetch origin --force --prune --prune-tags --depth 50 refs/heads/docs/5.7.0:refs/remotes/origin/docs/5.7.0
From https://github.com/ROCmSoftwarePlatform/hipRAND
 * [new branch]      docs/5.7.0 -> origin/docs/5.7.0
 * [new tag]         rocm-5.2.0 -> rocm-5.2.0
 * [new tag]         rocm-5.2.1 -> rocm-5.2.1
 * [new tag]         rocm-5.2.3 -> rocm-5.2.3
 * [new tag]         rocm-5.3.0 -> rocm-5.3.0
 * [new tag]         rocm-5.3.1 -> rocm-5.3.1
 * [new tag]         rocm-5.3.2 -> rocm-5.3.2
 * [new tag]         rocm-5.3.3 -> rocm-5.3.3
 * [new tag]         rocm-5.4.0 -> rocm-5.4.0
 * [new tag]         rocm-5.4.1 -> rocm-5.4.1
 * [new tag]         rocm-5.4.2 -> rocm-5.4.2
 * [new tag]         rocm-5.4.3 -> rocm-5.4.3
 * [new tag]         rocm-5.4.4 -> rocm-5.4.4
 * [new tag]         rocm-5.5.0 -> rocm-5.5.0
 * [new tag]         rocm-5.5.1 -> rocm-5.5.1
 * [new tag]         rocm-5.6.0 -> rocm-5.6.0
 * [new tag]         rocm-5.6.1 -> rocm-5.6.1

[rtd-command-info] start-time: 2023-09-16T00:52:17.787334Z, end-time: 2023-09-16T00:52:17.855361Z, duration: 0, exit-code: 0
git checkout --force origin/docs/5.7.0
Note: switching to 'origin/docs/5.7.0'.

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 switching back to a branch.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -c with the switch command. Example:

  git switch -c <new-branch-name>

Or undo this operation with:

  git switch -

Turn off this advice by setting config variable advice.detachedHead to false

HEAD is now at fe62fdc update docs

[rtd-command-info] start-time: 2023-09-16T00:52:18.332256Z, end-time: 2023-09-16T00:52:18.391588Z, duration: 0, exit-code: 0
git clean -d -f -f


[rtd-command-info] start-time: 2023-09-16T00:52:18.875853Z, end-time: 2023-09-16T00:52:18.929746Z, duration: 0, exit-code: 0
cat .readthedocs.yaml
# Read the Docs configuration file
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details

version: 2

sphinx:
   configuration: docs/conf.py

formats: [htmlzip]

python:
   install:
   - requirements: docs/.sphinx/requirements.txt

build:
   os: ubuntu-20.04
   tools:
      python: "3.8"

[rtd-command-info] start-time: 2023-09-16T00:52:26.073215Z, end-time: 2023-09-16T00:52:26.141363Z, duration: 0, exit-code: 0
asdf global python 3.8.17


[rtd-command-info] start-time: 2023-09-16T00:52:26.861615Z, end-time: 2023-09-16T00:52:28.245677Z, duration: 1, exit-code: 0
python -mvirtualenv $READTHEDOCS_VIRTUALENV_PATH
created virtual environment CPython3.8.17.final.0-64 in 714ms
  creator CPython3Posix(dest=/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest, clear=False, no_vcs_ignore=False, global=False)
  seeder FromAppData(download=False, pip=bundle, setuptools=bundle, wheel=bundle, via=copy, app_data_dir=/home/docs/.local/share/virtualenv)
    added seed packages: pip==21.2.3, setuptools==57.4.0, wheel==0.37.0
  activators BashActivator,CShellActivator,FishActivator,PowerShellActivator,PythonActivator

[rtd-command-info] start-time: 2023-09-16T00:52:28.684916Z, end-time: 2023-09-16T00:52:38.868457Z, duration: 10, exit-code: 0
python -m pip install --upgrade --no-cache-dir pip setuptools
Requirement already satisfied: pip in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (21.2.3)
Collecting pip
  Downloading pip-23.2.1-py3-none-any.whl (2.1 MB)
Requirement already satisfied: setuptools in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (57.4.0)
Collecting setuptools
  Downloading setuptools-68.2.2-py3-none-any.whl (807 kB)
Installing collected packages: setuptools, pip
  Attempting uninstall: setuptools
    Found existing installation: setuptools 57.4.0
    Uninstalling setuptools-57.4.0:
      Successfully uninstalled setuptools-57.4.0
  Attempting uninstall: pip
    Found existing installation: pip 21.2.3
    Uninstalling pip-21.2.3:
      Successfully uninstalled pip-21.2.3
Successfully installed pip-23.2.1 setuptools-68.2.2

[rtd-command-info] start-time: 2023-09-16T00:52:39.318472Z, end-time: 2023-09-16T00:52:49.171159Z, duration: 9, exit-code: 0
python -m pip install --upgrade --no-cache-dir pillow mock==1.0.1 alabaster>=0.7,<0.8,!=0.7.5 commonmark==0.9.1 recommonmark==0.5.0 sphinx sphinx-rtd-theme readthedocs-sphinx-ext<2.3
Collecting pillow
  Obtaining dependency information for pillow from https://files.pythonhosted.org/packages/cd/6d/07566c00ddb116a0eca1a623abda12da81099a6ff3200e5e6b7e2d3c8c2b/Pillow-10.0.1-cp38-cp38-manylinux_2_28_x86_64.whl.metadata
  Downloading Pillow-10.0.1-cp38-cp38-manylinux_2_28_x86_64.whl.metadata (9.5 kB)
Collecting mock==1.0.1
  Downloading mock-1.0.1.zip (861 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 861.9/861.9 kB 20.4 MB/s eta 0:00:00
  Preparing metadata (setup.py): started
  Preparing metadata (setup.py): finished with status 'done'
Collecting alabaster!=0.7.5,<0.8,>=0.7
  Downloading alabaster-0.7.13-py3-none-any.whl (13 kB)
Collecting commonmark==0.9.1
  Downloading commonmark-0.9.1-py2.py3-none-any.whl (51 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 51.1/51.1 kB 104.8 MB/s eta 0:00:00
Collecting recommonmark==0.5.0
  Downloading recommonmark-0.5.0-py2.py3-none-any.whl (9.8 kB)
Collecting sphinx
  Obtaining dependency information for sphinx from https://files.pythonhosted.org/packages/48/17/325cf6a257d84751a48ae90752b3d8fe0be8f9535b6253add61c49d0d9bc/sphinx-7.1.2-py3-none-any.whl.metadata
  Downloading sphinx-7.1.2-py3-none-any.whl.metadata (5.8 kB)
Collecting sphinx-rtd-theme
  Obtaining dependency information for sphinx-rtd-theme from https://files.pythonhosted.org/packages/18/01/76f40a18e9209bb098c1c1313c823dbbd001b23a2db71e7fd4eb5a48559c/sphinx_rtd_theme-1.3.0-py2.py3-none-any.whl.metadata
  Downloading sphinx_rtd_theme-1.3.0-py2.py3-none-any.whl.metadata (4.5 kB)
Collecting readthedocs-sphinx-ext<2.3
  Obtaining dependency information for readthedocs-sphinx-ext<2.3 from https://files.pythonhosted.org/packages/8c/f1/3d783ebfc084a9d556123d54669116101760e5e0dbb894b006745bcb59ea/readthedocs_sphinx_ext-2.2.2-py2.py3-none-any.whl.metadata
  Downloading readthedocs_sphinx_ext-2.2.2-py2.py3-none-any.whl.metadata (1.5 kB)
Collecting docutils>=0.11 (from recommonmark==0.5.0)
  Obtaining dependency information for docutils>=0.11 from https://files.pythonhosted.org/packages/26/87/f238c0670b94533ac0353a4e2a1a771a0cc73277b88bff23d3ae35a256c1/docutils-0.20.1-py3-none-any.whl.metadata
  Downloading docutils-0.20.1-py3-none-any.whl.metadata (2.8 kB)
Collecting sphinxcontrib-applehelp (from sphinx)
  Downloading sphinxcontrib_applehelp-1.0.4-py3-none-any.whl (120 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 120.6/120.6 kB 134.9 MB/s eta 0:00:00
Collecting sphinxcontrib-devhelp (from sphinx)
  Downloading sphinxcontrib_devhelp-1.0.2-py2.py3-none-any.whl (84 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 84.7/84.7 kB 133.3 MB/s eta 0:00:00
Collecting sphinxcontrib-jsmath (from sphinx)
  Downloading sphinxcontrib_jsmath-1.0.1-py2.py3-none-any.whl (5.1 kB)
Collecting sphinxcontrib-htmlhelp>=2.0.0 (from sphinx)
  Downloading sphinxcontrib_htmlhelp-2.0.1-py3-none-any.whl (99 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 99.8/99.8 kB 129.1 MB/s eta 0:00:00
Collecting sphinxcontrib-serializinghtml>=1.1.5 (from sphinx)
  Downloading sphinxcontrib_serializinghtml-1.1.5-py2.py3-none-any.whl (94 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 94.0/94.0 kB 141.1 MB/s eta 0:00:00
Collecting sphinxcontrib-qthelp (from sphinx)
  Downloading sphinxcontrib_qthelp-1.0.3-py2.py3-none-any.whl (90 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 90.6/90.6 kB 145.3 MB/s eta 0:00:00
Collecting Jinja2>=3.0 (from sphinx)
  Downloading Jinja2-3.1.2-py3-none-any.whl (133 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 133.1/133.1 kB 159.7 MB/s eta 0:00:00
Collecting Pygments>=2.13 (from sphinx)
  Obtaining dependency information for Pygments>=2.13 from https://files.pythonhosted.org/packages/43/88/29adf0b44ba6ac85045e63734ae0997d3c58d8b1a91c914d240828d0d73d/Pygments-2.16.1-py3-none-any.whl.metadata
  Downloading Pygments-2.16.1-py3-none-any.whl.metadata (2.5 kB)
Collecting snowballstemmer>=2.0 (from sphinx)
  Downloading snowballstemmer-2.2.0-py2.py3-none-any.whl (93 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 93.0/93.0 kB 144.5 MB/s eta 0:00:00
Collecting babel>=2.9 (from sphinx)
  Downloading Babel-2.12.1-py3-none-any.whl (10.1 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 10.1/10.1 MB 115.6 MB/s eta 0:00:00
Collecting imagesize>=1.3 (from sphinx)
  Downloading imagesize-1.4.1-py2.py3-none-any.whl (8.8 kB)
Collecting requests>=2.25.0 (from sphinx)
  Obtaining dependency information for requests>=2.25.0 from https://files.pythonhosted.org/packages/70/8e/0e2d847013cb52cd35b38c009bb167a1a26b2ce6cd6965bf26b47bc0bf44/requests-2.31.0-py3-none-any.whl.metadata
  Downloading requests-2.31.0-py3-none-any.whl.metadata (4.6 kB)
Collecting packaging>=21.0 (from sphinx)
  Downloading packaging-23.1-py3-none-any.whl (48 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 48.9/48.9 kB 121.6 MB/s eta 0:00:00
Collecting importlib-metadata>=4.8 (from sphinx)
  Obtaining dependency information for importlib-metadata>=4.8 from https://files.pythonhosted.org/packages/cc/37/db7ba97e676af155f5fcb1a35466f446eadc9104e25b83366e8088c9c926/importlib_metadata-6.8.0-py3-none-any.whl.metadata
  Downloading importlib_metadata-6.8.0-py3-none-any.whl.metadata (5.1 kB)
Collecting docutils>=0.11 (from recommonmark==0.5.0)
  Downloading docutils-0.18.1-py2.py3-none-any.whl (570 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 570.0/570.0 kB 142.8 MB/s eta 0:00:00
Collecting sphinxcontrib-jquery<5,>=4 (from sphinx-rtd-theme)
  Downloading sphinxcontrib_jquery-4.1-py2.py3-none-any.whl (121 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 121.1/121.1 kB 143.1 MB/s eta 0:00:00
Collecting pytz>=2015.7 (from babel>=2.9->sphinx)
  Obtaining dependency information for pytz>=2015.7 from https://files.pythonhosted.org/packages/32/4d/aaf7eff5deb402fd9a24a1449a8119f00d74ae9c2efa79f8ef9994261fc2/pytz-2023.3.post1-py2.py3-none-any.whl.metadata
  Downloading pytz-2023.3.post1-py2.py3-none-any.whl.metadata (22 kB)
Collecting zipp>=0.5 (from importlib-metadata>=4.8->sphinx)
  Obtaining dependency information for zipp>=0.5 from https://files.pythonhosted.org/packages/8c/08/d3006317aefe25ea79d3b76c9650afabaf6d63d1c8443b236e7405447503/zipp-3.16.2-py3-none-any.whl.metadata
  Downloading zipp-3.16.2-py3-none-any.whl.metadata (3.7 kB)
Collecting MarkupSafe>=2.0 (from Jinja2>=3.0->sphinx)
  Obtaining dependency information for MarkupSafe>=2.0 from https://files.pythonhosted.org/packages/de/e2/32c14301bb023986dff527a49325b6259cab4ebb4633f69de54af312fc45/MarkupSafe-2.1.3-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata
  Downloading MarkupSafe-2.1.3-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (3.0 kB)
Collecting charset-normalizer<4,>=2 (from requests>=2.25.0->sphinx)
  Obtaining dependency information for charset-normalizer<4,>=2 from https://files.pythonhosted.org/packages/cb/e7/5e43745003bf1f90668c7be23fc5952b3a2b9c2558f16749411c18039b36/charset_normalizer-3.2.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata
  Downloading charset_normalizer-3.2.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (31 kB)
Collecting idna<4,>=2.5 (from requests>=2.25.0->sphinx)
  Downloading idna-3.4-py3-none-any.whl (61 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 61.5/61.5 kB 199.9 MB/s eta 0:00:00
Collecting urllib3<3,>=1.21.1 (from requests>=2.25.0->sphinx)
  Obtaining dependency information for urllib3<3,>=1.21.1 from https://files.pythonhosted.org/packages/9b/81/62fd61001fa4b9d0df6e31d47ff49cfa9de4af03adecf339c7bc30656b37/urllib3-2.0.4-py3-none-any.whl.metadata
  Downloading urllib3-2.0.4-py3-none-any.whl.metadata (6.6 kB)
Collecting certifi>=2017.4.17 (from requests>=2.25.0->sphinx)
  Obtaining dependency information for certifi>=2017.4.17 from https://files.pythonhosted.org/packages/4c/dd/2234eab22353ffc7d94e8d13177aaa050113286e93e7b40eae01fbf7c3d9/certifi-2023.7.22-py3-none-any.whl.metadata
  Downloading certifi-2023.7.22-py3-none-any.whl.metadata (2.2 kB)
Downloading Pillow-10.0.1-cp38-cp38-manylinux_2_28_x86_64.whl (3.6 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.6/3.6 MB 183.7 MB/s eta 0:00:00
Downloading sphinx-7.1.2-py3-none-any.whl (3.2 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.2/3.2 MB 178.7 MB/s eta 0:00:00
Downloading sphinx_rtd_theme-1.3.0-py2.py3-none-any.whl (2.8 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.8/2.8 MB 204.7 MB/s eta 0:00:00
Downloading readthedocs_sphinx_ext-2.2.2-py2.py3-none-any.whl (11 kB)
Downloading importlib_metadata-6.8.0-py3-none-any.whl (22 kB)
Downloading Pygments-2.16.1-py3-none-any.whl (1.2 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.2/1.2 MB 250.4 MB/s eta 0:00:00
Downloading requests-2.31.0-py3-none-any.whl (62 kB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 62.6/62.6 kB 205.9 MB/s eta 0:00:00
Downloading certifi-2023.7.22-py3-none-any.whl (158 kB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 158.3/158.3 kB 200.4 MB/s eta 0:00:00
Downloading charset_normalizer-3.2.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (199 kB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 199.1/199.1 kB 241.7 MB/s eta 0:00:00
Downloading MarkupSafe-2.1.3-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (25 kB)
Downloading pytz-2023.3.post1-py2.py3-none-any.whl (502 kB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 502.5/502.5 kB 252.1 MB/s eta 0:00:00
Downloading urllib3-2.0.4-py3-none-any.whl (123 kB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 123.9/123.9 kB 234.9 MB/s eta 0:00:00
Downloading zipp-3.16.2-py3-none-any.whl (7.2 kB)
Building wheels for collected packages: mock
  Building wheel for mock (setup.py): started
  Building wheel for mock (setup.py): finished with status 'done'
  Created wheel for mock: filename=mock-1.0.1-py3-none-any.whl size=23753 sha256=7e80bf2deef3eefc8e84590f2f559ced55a6cfa5f6ddeeb0738154ba74e17faf
  Stored in directory: /tmp/pip-ephem-wheel-cache-lh5wrolu/wheels/41/7c/21/90057f91c6ead7c77a90c52d6e85ca48bf82d8b0d3f8dfbb65
Successfully built mock
Installing collected packages: snowballstemmer, pytz, mock, commonmark, zipp, urllib3, sphinxcontrib-serializinghtml, sphinxcontrib-qthelp, sphinxcontrib-jsmath, sphinxcontrib-htmlhelp, sphinxcontrib-devhelp, sphinxcontrib-applehelp, Pygments, pillow, packaging, MarkupSafe, imagesize, idna, docutils, charset-normalizer, certifi, babel, alabaster, requests, Jinja2, importlib-metadata, sphinx, readthedocs-sphinx-ext, sphinxcontrib-jquery, recommonmark, sphinx-rtd-theme
Successfully installed Jinja2-3.1.2 MarkupSafe-2.1.3 Pygments-2.16.1 alabaster-0.7.13 babel-2.12.1 certifi-2023.7.22 charset-normalizer-3.2.0 commonmark-0.9.1 docutils-0.18.1 idna-3.4 imagesize-1.4.1 importlib-metadata-6.8.0 mock-1.0.1 packaging-23.1 pillow-10.0.1 pytz-2023.3.post1 readthedocs-sphinx-ext-2.2.2 recommonmark-0.5.0 requests-2.31.0 snowballstemmer-2.2.0 sphinx-7.1.2 sphinx-rtd-theme-1.3.0 sphinxcontrib-applehelp-1.0.4 sphinxcontrib-devhelp-1.0.2 sphinxcontrib-htmlhelp-2.0.1 sphinxcontrib-jquery-4.1 sphinxcontrib-jsmath-1.0.1 sphinxcontrib-qthelp-1.0.3 sphinxcontrib-serializinghtml-1.1.5 urllib3-2.0.4 zipp-3.16.2

[rtd-command-info] start-time: 2023-09-16T00:52:50.012624Z, end-time: 2023-09-16T00:53:02.352580Z, duration: 12, exit-code: 0
python -m pip install --exists-action=w --no-cache-dir -r docs/.sphinx/requirements.txt
Collecting accessible-pygments==0.0.4 (from -r docs/.sphinx/requirements.txt (line 7))
  Downloading accessible_pygments-0.0.4-py2.py3-none-any.whl (29 kB)
Requirement already satisfied: alabaster==0.7.13 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 9)) (0.7.13)
Requirement already satisfied: babel==2.12.1 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 11)) (2.12.1)
Collecting beautifulsoup4==4.12.2 (from -r docs/.sphinx/requirements.txt (line 15))
  Downloading beautifulsoup4-4.12.2-py3-none-any.whl (142 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 143.0/143.0 kB 12.6 MB/s eta 0:00:00
Collecting breathe==4.34.0 (from -r docs/.sphinx/requirements.txt (line 17))
  Downloading breathe-4.34.0-py3-none-any.whl (92 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 92.8/92.8 kB 217.9 MB/s eta 0:00:00
Collecting certifi==2022.12.7 (from -r docs/.sphinx/requirements.txt (line 19))
  Downloading certifi-2022.12.7-py3-none-any.whl (155 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 155.3/155.3 kB 99.8 MB/s eta 0:00:00
Collecting cffi==1.15.1 (from -r docs/.sphinx/requirements.txt (line 21))
  Downloading cffi-1.15.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (442 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 442.7/442.7 kB 68.2 MB/s eta 0:00:00
Collecting charset-normalizer==3.1.0 (from -r docs/.sphinx/requirements.txt (line 25))
  Downloading charset_normalizer-3.1.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (195 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 195.9/195.9 kB 230.2 MB/s eta 0:00:00
Collecting click==8.1.3 (from -r docs/.sphinx/requirements.txt (line 27))
  Downloading click-8.1.3-py3-none-any.whl (96 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 96.6/96.6 kB 206.8 MB/s eta 0:00:00
Collecting cryptography==40.0.2 (from -r docs/.sphinx/requirements.txt (line 29))
  Downloading cryptography-40.0.2-cp36-abi3-manylinux_2_28_x86_64.whl (3.7 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.7/3.7 MB 169.6 MB/s eta 0:00:00
Collecting deprecated==1.2.13 (from -r docs/.sphinx/requirements.txt (line 31))
  Downloading Deprecated-1.2.13-py2.py3-none-any.whl (9.6 kB)
Collecting docutils==0.19 (from -r docs/.sphinx/requirements.txt (line 33))
  Downloading docutils-0.19-py3-none-any.whl (570 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 570.5/570.5 kB 249.2 MB/s eta 0:00:00
Collecting fastjsonschema==2.16.3 (from -r docs/.sphinx/requirements.txt (line 39))
  Downloading fastjsonschema-2.16.3-py3-none-any.whl (23 kB)
Collecting gitdb==4.0.10 (from -r docs/.sphinx/requirements.txt (line 41))
  Downloading gitdb-4.0.10-py3-none-any.whl (62 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 62.7/62.7 kB 200.6 MB/s eta 0:00:00
Collecting gitpython==3.1.31 (from -r docs/.sphinx/requirements.txt (line 43))
  Downloading GitPython-3.1.31-py3-none-any.whl (184 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 184.3/184.3 kB 227.9 MB/s eta 0:00:00
Requirement already satisfied: idna==3.4 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 45)) (3.4)
Requirement already satisfied: imagesize==1.4.1 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 47)) (1.4.1)
Requirement already satisfied: jinja2==3.1.2 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 49)) (3.1.2)
Collecting markdown-it-py==2.2.0 (from -r docs/.sphinx/requirements.txt (line 53))
  Downloading markdown_it_py-2.2.0-py3-none-any.whl (84 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 84.5/84.5 kB 216.3 MB/s eta 0:00:00
Collecting markupsafe==2.1.2 (from -r docs/.sphinx/requirements.txt (line 57))
  Downloading MarkupSafe-2.1.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (25 kB)
Collecting mdit-py-plugins==0.3.5 (from -r docs/.sphinx/requirements.txt (line 59))
  Downloading mdit_py_plugins-0.3.5-py3-none-any.whl (52 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 52.1/52.1 kB 187.8 MB/s eta 0:00:00
Collecting mdurl==0.1.2 (from -r docs/.sphinx/requirements.txt (line 61))
  Downloading mdurl-0.1.2-py3-none-any.whl (10.0 kB)
Collecting myst-parser==1.0.0 (from -r docs/.sphinx/requirements.txt (line 63))
  Downloading myst_parser-1.0.0-py3-none-any.whl (77 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 77.3/77.3 kB 213.4 MB/s eta 0:00:00
Collecting numpy==1.24.3 (from -r docs/.sphinx/requirements.txt (line 65))
  Downloading numpy-1.24.3-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (17.3 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 17.3/17.3 MB 199.2 MB/s eta 0:00:00
Requirement already satisfied: packaging==23.1 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 67)) (23.1)
Collecting pycparser==2.21 (from -r docs/.sphinx/requirements.txt (line 71))
  Downloading pycparser-2.21-py2.py3-none-any.whl (118 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 118.7/118.7 kB 219.8 MB/s eta 0:00:00
Collecting pydata-sphinx-theme==0.13.3 (from -r docs/.sphinx/requirements.txt (line 73))
  Downloading pydata_sphinx_theme-0.13.3-py3-none-any.whl (2.0 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.0/2.0 MB 236.7 MB/s eta 0:00:00
Collecting pygithub==1.58.1 (from -r docs/.sphinx/requirements.txt (line 77))
  Downloading PyGithub-1.58.1-py3-none-any.whl (312 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 312.5/312.5 kB 238.9 MB/s eta 0:00:00
Collecting pygments==2.15.1 (from -r docs/.sphinx/requirements.txt (line 79))
  Downloading Pygments-2.15.1-py3-none-any.whl (1.1 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.1/1.1 MB 257.4 MB/s eta 0:00:00
Collecting pyjwt[crypto]==2.6.0 (from -r docs/.sphinx/requirements.txt (line 84))
  Downloading PyJWT-2.6.0-py3-none-any.whl (20 kB)
Collecting pynacl==1.5.0 (from -r docs/.sphinx/requirements.txt (line 86))
  Downloading PyNaCl-1.5.0-cp36-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.manylinux_2_24_x86_64.whl (856 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 856.7/856.7 kB 258.7 MB/s eta 0:00:00
Collecting pyyaml==6.0 (from -r docs/.sphinx/requirements.txt (line 88))
  Downloading PyYAML-6.0-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl (701 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 701.2/701.2 kB 249.3 MB/s eta 0:00:00
Collecting requests==2.28.2 (from -r docs/.sphinx/requirements.txt (line 93))
  Downloading requests-2.28.2-py3-none-any.whl (62 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 62.8/62.8 kB 200.4 MB/s eta 0:00:00
Collecting rocm-docs-core>=0.24.0 (from -r docs/.sphinx/requirements.txt (line 97))
  Obtaining dependency information for rocm-docs-core>=0.24.0 from https://files.pythonhosted.org/packages/c8/05/96629f4d1d026841d086a6f48d516eb1c8b768bb3986f015123a27c55c03/rocm_docs_core-0.24.1-py3-none-any.whl.metadata
  Downloading rocm_docs_core-0.24.1-py3-none-any.whl.metadata (3.3 kB)
Collecting smmap==5.0.0 (from -r docs/.sphinx/requirements.txt (line 99))
  Downloading smmap-5.0.0-py3-none-any.whl (24 kB)
Requirement already satisfied: snowballstemmer==2.2.0 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 101)) (2.2.0)
Collecting soupsieve==2.4.1 (from -r docs/.sphinx/requirements.txt (line 103))
  Downloading soupsieve-2.4.1-py3-none-any.whl (36 kB)
Collecting sphinx==5.3.0 (from -r docs/.sphinx/requirements.txt (line 105))
  Downloading sphinx-5.3.0-py3-none-any.whl (3.2 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 3.2/3.2 MB 230.7 MB/s eta 0:00:00
Collecting sphinx-book-theme==1.0.1 (from -r docs/.sphinx/requirements.txt (line 116))
  Downloading sphinx_book_theme-1.0.1-py3-none-any.whl (396 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 396.9/396.9 kB 254.1 MB/s eta 0:00:00
Collecting sphinx-copybutton==0.5.1 (from -r docs/.sphinx/requirements.txt (line 118))
  Downloading sphinx_copybutton-0.5.1-py3-none-any.whl (13 kB)
Collecting sphinx-design==0.4.1 (from -r docs/.sphinx/requirements.txt (line 120))
  Downloading sphinx_design-0.4.1-py3-none-any.whl (2.2 MB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 2.2/2.2 MB 116.1 MB/s eta 0:00:00
Collecting sphinx-external-toc==0.3.1 (from -r docs/.sphinx/requirements.txt (line 122))
  Downloading sphinx_external_toc-0.3.1-py3-none-any.whl (26 kB)
Collecting sphinx-notfound-page==0.8.3 (from -r docs/.sphinx/requirements.txt (line 124))
  Downloading sphinx_notfound_page-0.8.3-py2.py3-none-any.whl (8.5 kB)
Requirement already satisfied: sphinxcontrib-applehelp==1.0.4 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 126)) (1.0.4)
Requirement already satisfied: sphinxcontrib-devhelp==1.0.2 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 128)) (1.0.2)
Requirement already satisfied: sphinxcontrib-htmlhelp==2.0.1 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 130)) (2.0.1)
Requirement already satisfied: sphinxcontrib-jsmath==1.0.1 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 132)) (1.0.1)
Requirement already satisfied: sphinxcontrib-qthelp==1.0.3 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 134)) (1.0.3)
Requirement already satisfied: sphinxcontrib-serializinghtml==1.1.5 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from -r docs/.sphinx/requirements.txt (line 136)) (1.1.5)
Collecting typing-extensions==4.5.0 (from -r docs/.sphinx/requirements.txt (line 138))
  Downloading typing_extensions-4.5.0-py3-none-any.whl (27 kB)
Collecting urllib3==1.26.15 (from -r docs/.sphinx/requirements.txt (line 140))
  Downloading urllib3-1.26.15-py2.py3-none-any.whl (140 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 140.9/140.9 kB 218.9 MB/s eta 0:00:00
Collecting wrapt==1.15.0 (from -r docs/.sphinx/requirements.txt (line 142))
  Downloading wrapt-1.15.0-cp38-cp38-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_17_x86_64.manylinux2014_x86_64.whl (81 kB)
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 81.5/81.5 kB 211.3 MB/s eta 0:00:00
Requirement already satisfied: pytz>=2015.7 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from babel==2.12.1->-r docs/.sphinx/requirements.txt (line 11)) (2023.3.post1)
Requirement already satisfied: importlib-metadata>=4.8 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from sphinx==5.3.0->-r docs/.sphinx/requirements.txt (line 105)) (6.8.0)
Collecting importlib-resources>=5.10.2 (from rocm-docs-core>=0.24.0->-r docs/.sphinx/requirements.txt (line 97))
  Obtaining dependency information for importlib-resources>=5.10.2 from https://files.pythonhosted.org/packages/25/d4/592f53ce2f8dde8be5720851bd0ab71cc2e76c55978e4163ef1ab7e389bb/importlib_resources-6.0.1-py3-none-any.whl.metadata
  Downloading importlib_resources-6.0.1-py3-none-any.whl.metadata (4.0 kB)
Requirement already satisfied: zipp>=0.5 in /home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages (from importlib-metadata>=4.8->sphinx==5.3.0->-r docs/.sphinx/requirements.txt (line 105)) (3.16.2)
Downloading rocm_docs_core-0.24.1-py3-none-any.whl (1.2 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 1.2/1.2 MB 256.7 MB/s eta 0:00:00
Downloading importlib_resources-6.0.1-py3-none-any.whl (34 kB)
Installing collected packages: fastjsonschema, wrapt, urllib3, typing-extensions, soupsieve, smmap, pyyaml, pyjwt, pygments, pycparser, numpy, mdurl, markupsafe, importlib-resources, docutils, click, charset-normalizer, certifi, requests, markdown-it-py, gitdb, deprecated, cffi, beautifulsoup4, accessible-pygments, sphinx, pynacl, mdit-py-plugins, gitpython, cryptography, sphinx-notfound-page, sphinx-external-toc, sphinx-design, sphinx-copybutton, pydata-sphinx-theme, myst-parser, breathe, sphinx-book-theme, pygithub, rocm-docs-core
  Attempting uninstall: urllib3
    Found existing installation: urllib3 2.0.4
    Uninstalling urllib3-2.0.4:
      Successfully uninstalled urllib3-2.0.4
  Attempting uninstall: pygments
    Found existing installation: Pygments 2.16.1
    Uninstalling Pygments-2.16.1:
      Successfully uninstalled Pygments-2.16.1
  Attempting uninstall: markupsafe
    Found existing installation: MarkupSafe 2.1.3
    Uninstalling MarkupSafe-2.1.3:
      Successfully uninstalled MarkupSafe-2.1.3
  Attempting uninstall: docutils
    Found existing installation: docutils 0.18.1
    Uninstalling docutils-0.18.1:
      Successfully uninstalled docutils-0.18.1
  Attempting uninstall: charset-normalizer
    Found existing installation: charset-normalizer 3.2.0
    Uninstalling charset-normalizer-3.2.0:
      Successfully uninstalled charset-normalizer-3.2.0
  Attempting uninstall: certifi
    Found existing installation: certifi 2023.7.22
    Uninstalling certifi-2023.7.22:
      Successfully uninstalled certifi-2023.7.22
  Attempting uninstall: requests
    Found existing installation: requests 2.31.0
    Uninstalling requests-2.31.0:
      Successfully uninstalled requests-2.31.0
  Attempting uninstall: sphinx
    Found existing installation: Sphinx 7.1.2
    Uninstalling Sphinx-7.1.2:
      Successfully uninstalled Sphinx-7.1.2
ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
sphinx-rtd-theme 1.3.0 requires docutils<0.19, but you have docutils 0.19 which is incompatible.
Successfully installed accessible-pygments-0.0.4 beautifulsoup4-4.12.2 breathe-4.34.0 certifi-2022.12.7 cffi-1.15.1 charset-normalizer-3.1.0 click-8.1.3 cryptography-40.0.2 deprecated-1.2.13 docutils-0.19 fastjsonschema-2.16.3 gitdb-4.0.10 gitpython-3.1.31 importlib-resources-6.0.1 markdown-it-py-2.2.0 markupsafe-2.1.2 mdit-py-plugins-0.3.5 mdurl-0.1.2 myst-parser-1.0.0 numpy-1.24.3 pycparser-2.21 pydata-sphinx-theme-0.13.3 pygithub-1.58.1 pygments-2.15.1 pyjwt-2.6.0 pynacl-1.5.0 pyyaml-6.0 requests-2.28.2 rocm-docs-core-0.24.1 smmap-5.0.0 soupsieve-2.4.1 sphinx-5.3.0 sphinx-book-theme-1.0.1 sphinx-copybutton-0.5.1 sphinx-design-0.4.1 sphinx-external-toc-0.3.1 sphinx-notfound-page-0.8.3 typing-extensions-4.5.0 urllib3-1.26.15 wrapt-1.15.0

[rtd-command-info] start-time: 2023-09-16T00:53:08.904534Z, end-time: 2023-09-16T00:53:08.961902Z, duration: 0, exit-code: 0
cat docs/conf.py
"""Copyright (C) 2022 Advanced Micro Devices, Inc. All rights reserved.

   Permission is hereby granted, free of charge, to any person obtaining a copy
   of this software and associated documentation files (the "Software"), to deal
   in the Software without restriction, including without limitation the rights
   to use, copy, modify, merge, publish, distribute, sublicense, and/or sell cop-
   ies of the Software, and to permit persons to whom the Software is furnished
   to do so, subject to the following conditions:

   The above copyright notice and this permission notice shall be included in all
   copies or substantial portions of the Software.

   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IM-
   PLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
   FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
   COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
   IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNE-
   CTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
"""

# -*- coding: utf-8 -*-
#
# hipRAND documentation build configuration file, created by
# sphinx-quickstart on Mon Jan  8 16:34:42 2018.
#
# This file is execfile()d with the current directory set to its
# containing dir.
#
# Note that not all possible configuration values are present in this
# autogenerated file.
#
# All configuration values have a default; values that are commented out
# serve to show the default.

# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.

import os
import sys
import subprocess

sys.path.insert(0, os.path.abspath('../python/hiprand'))

read_the_docs_build = os.environ.get('READTHEDOCS', None) == 'True'

# -- General configuration ------------------------------------------------

# If your documentation needs a minimal Sphinx version, state it here.
#
# needs_sphinx = '1.0'

# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = [
    'sphinx.ext.mathjax',
    'sphinx.ext.autodoc',
    'sphinx.ext.intersphinx',
    'sphinx_rtd_theme',
    'breathe',
    'exhale',
]

breathe_projects = { "hipRAND": "./docBin/xml" }
breathe_default_project = "hipRAND"

# Add any paths that contain templates here, relative to this directory.
templates_path = ['_templates']

# The suffix(es) of source filenames.
# You can specify multiple suffix as a list of string:
#
# source_suffix = ['.rst', '.md']
source_suffix = ['.rst']

# The master toctree document.
master_doc = 'index'

# General information about the project.
project = u'hipRAND'
copyright = '2017-2022, Advanced Micro Devices, Inc.'
author = 'Advanced Micro Devices, Inc.'

# The version info for the project you're documenting, acts as replacement for
# |version| and |release|, also used in various other places throughout the
# built documents.
#
# The short X.Y version.
version = u'2.10.16'
# The full version, including alpha/beta/rc tags.
release = u'2.10.16'

# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
#
# This is also used if you do content translation via gettext catalogs.
# Usually you set "language" from the command line for these cases.
language = 'en'

# List of patterns, relative to source directory, that match files and
# directories to ignore when looking for source files.
# This patterns also effect to html_static_path and html_extra_path
exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']

# The name of the Pygments (syntax highlighting) style to use.
pygments_style = 'sphinx'

# If true, `todo` and `todoList` produce output, else they produce nothing.
todo_include_todos = False


# -- Options for HTML output ----------------------------------------------

# The theme to use for HTML and HTML Help pages.  See the documentation for
# a list of builtin themes.
#
# html_theme = 'alabaster'

#if read_the_docs_build:
#    html_theme = 'default'
#else:
import sphinx_rtd_theme
html_theme = "sphinx_rtd_theme"
html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
html_logo = "rocm_logo.png"

# Theme options are theme-specific and customize the look and feel of a theme
# further.  For a list of options available for each theme, see the
# documentation.
html_theme_options = {
    'logo_only': True,
    'display_version': True
}

# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
# html_static_path = ['_static']

# Custom sidebar templates, must be a dictionary that maps document names
# to template names.
#
# This is required for the alabaster theme
# refs: http://alabaster.readthedocs.io/en/latest/installation.html#sidebars
# html_sidebars = {
#     '**': [
#         'relations.html',  # needs 'show_related': True theme option to display
#         'searchbox.html',
#     ]
# }


# -- Options for HTMLHelp output ------------------------------------------

# Output file base name for HTML help builder.
htmlhelp_basename = 'hipRANDdoc'


# -- Options for LaTeX output ---------------------------------------------

latex_elements = {
    # The paper size ('letterpaper' or 'a4paper').
    #
    # 'papersize': 'letterpaper',

    # The font size ('10pt', '11pt' or '12pt').
    #
    # 'pointsize': '10pt',

    # Additional stuff for the LaTeX preamble.
    #
    # 'preamble': '',

    # Latex figure (float) alignment
    #
    # 'figure_align': 'htbp',
}

# Grouping the document tree into LaTeX files. List of tuples
# (source start file, target name, title,
#  author, documentclass [howto, manual, or own class]).
latex_documents = [
    (master_doc, 'hipRAND.tex', u'hipRAND Documentation',
     u'Advanced Micro Devices', 'manual'),
]


# -- Options for manual page output ---------------------------------------

# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [
    (master_doc, 'hipRAND', u'hipRAND Documentation',
     [author], 1)
]


# -- Options for Texinfo output -------------------------------------------

# Grouping the document tree into Texinfo files. List of tuples
# (source start file, target name, title, author,
#  dir menu entry, description, category)
texinfo_documents = [
    (master_doc, 'hipRAND', u'hipRAND Documentation',
     author, 'hipRAND', 'Reusable software components for rocm developers.',
     'Miscellaneous'),
]

intersphinx_mapping = { 'numpy': ('https://docs.scipy.org/doc/numpy', None) }


# Setup the exhale extension
exhale_args = {
    # These arguments are required
    "containmentFolder":     "./api",
    "rootFileName":          "library_root.rst",
    "rootFileTitle":         "C/C++ API Reference",
    "doxygenStripFromPath":  "..",
    # Suggested optional arguments
    "createTreeView":        False,
    # TIP: if using the sphinx-bootstrap-theme, you need
    # "treeViewIsBootstrap": True,
    "exhaleExecutesDoxygen": True,
    "exhaleUseDoxyfile": True,
}

# Tell sphinx what the primary language being documented is.
primary_domain = 'cpp'
cpp_id_attributes = ["__global__", "__device__", "__host__", "__forceinline__", "static"]
cpp_paren_attributes = ["__declspec"]

# Tell sphinx what the pygments highlight language should be.
highlight_language = 'cpp'

autoclass_content = 'both'




###########################################################################
#          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/main/readthedocs/doc_builder/templates/doc_builder/conf.py.tmpl
#
# Note: this file shouldn't rely on extra dependencies.

import importlib
import sys
import os.path

# Borrowed from six.
PY3 = sys.version_info[0] == 3
string_types = str if PY3 else basestring

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 multiple 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')

# Define this variable in case it's not defined by the user.
# It defaults to `alabaster` which is the default from Sphinx.
# https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_theme
html_theme = globals().get('html_theme', 'alabaster')

#Add project information to the template context.
context = {
    'html_theme': html_theme,
    'current_version': "latest",
    'version_slug': "latest",
    'MEDIA_URL': "https://media.readthedocs.com/media/",
    'STATIC_URL': "https://assets.readthedocs.com/",
    'PRODUCTION_DOMAIN': "readthedocs.com",
    'proxied_static_path': "/_/static/",
    'versions': [
    ("latest", "/en/latest/"),
    ("docs-5.7.0", "/en/docs-5.7.0/"),
    ("docs-5.6.1", "/en/docs-5.6.1/"),
    ("docs-5.6.0", "/en/docs-5.6.0/"),
    ("docs-5.5.1", "/en/docs-5.5.1/"),
    ("docs-5.5.0", "/en/docs-5.5.0/"),
    ("docs-5.4.4", "/en/docs-5.4.4/"),
    ("docs-5.4.3", "/en/docs-5.4.3/"),
    ("docs-5.4.2", "/en/docs-5.4.2/"),
    ("docs-5.4.1", "/en/docs-5.4.1/"),
    ("docs-5.4.0", "/en/docs-5.4.0/"),
    ("docs-5.3.3", "/en/docs-5.3.3/"),
    ("docs-5.3.2", "/en/docs-5.3.2/"),
    ("docs-5.3.1", "/en/docs-5.3.1/"),
    ("docs-5.3.0", "/en/docs-5.3.0/"),
    ("docs-5.2.3", "/en/docs-5.2.3/"),
    ("docs-5.2.1", "/en/docs-5.2.1/"),
    ("docs-5.2.0", "/en/docs-5.2.0/"),
    ("docs-5.1.3", "/en/docs-5.1.3/"),
    ("docs-5.1.1", "/en/docs-5.1.1/"),
    ("docs-5.1.0", "/en/docs-5.1.0/"),
    ("develop", "/en/develop/"),
    ],
    'downloads': [ 
    ("html", "//rocm.docs.amd.com/_/downloads/hipRAND/en/latest/htmlzip/"),
    ],
    'subprojects': [ 
    ],
    'slug': 'advanced-micro-devices-hiprand',
    'name': u'hipRAND',
    'rtd_language': u'en',
    'programming_language': u'words',
    'canonical_url': '',
    'analytics_code': 'None',
    'single_version': False,
    'conf_py_path': '/docs/',
    'api_host': 'https://readthedocs.com',
    'github_user': 'ROCmSoftwarePlatform',
    'proxied_api_host': '/_',
    'github_repo': 'hipRAND',
    'github_version': 'docs/5.7.0',
    'display_github': True,
    'bitbucket_user': 'None',
    'bitbucket_repo': 'None',
    'bitbucket_version': 'docs/5.7.0',
    'display_bitbucket': False,
    'gitlab_user': 'None',
    'gitlab_repo': 'None',
    'gitlab_version': 'docs/5.7.0',
    'display_gitlab': False,
    'READTHEDOCS': True,
    'using_theme': (html_theme == "default"),
    'new_theme': (html_theme == "sphinx_rtd_theme"),
    'source_suffix': SUFFIX,
    'ad_free': False,
    'docsearch_disabled': False,
    'user_analytics_code': '',
    'global_analytics_code': None,
    'commit': 'fe62fdc2',
}

# For sphinx >=1.8 we can use html_baseurl to set the canonical URL.
# https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_baseurl
if version_info >= (1, 8):
    if not globals().get('html_baseurl'):
        html_baseurl = context['canonical_url']
    context['canonical_url'] = None





if 'html_context' in globals():
    for key in context:
        if key not in html_context:
            html_context[key] = context[key]
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"]

# Add External version warning banner to the external version documentation
if 'branch' == 'external':
    extensions.insert(1, "readthedocs_ext.external_version_warning")
    readthedocs_vcs_url = 'None'
    readthedocs_build_url = 'https://readthedocs.com/projects/advanced-micro-devices-hiprand/builds/1725369/'

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'

# Make sure our build directory is always excluded
exclude_patterns = globals().get('exclude_patterns', [])
exclude_patterns.extend(['_build'])

[rtd-command-info] start-time: 2023-09-16T00:53:09.410258Z, end-time: 2023-09-16T00:53:10.032739Z, duration: 0, exit-code: 2
python -m sphinx -T -E -b html -d _build/doctrees -D language=en . $READTHEDOCS_OUTPUT/html
Running Sphinx v5.3.0

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages/sphinx/registry.py", line 459, in load_extension
    mod = import_module(extname)
  File "/home/docs/.asdf/installs/python/3.8.17/lib/python3.8/importlib/__init__.py", line 127, in import_module
    return _bootstrap._gcd_import(name[level:], package, level)
  File "<frozen importlib._bootstrap>", line 1014, in _gcd_import
  File "<frozen importlib._bootstrap>", line 991, in _find_and_load
  File "<frozen importlib._bootstrap>", line 973, in _find_and_load_unlocked
ModuleNotFoundError: No module named 'exhale'

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

Traceback (most recent call last):
  File "/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages/sphinx/cmd/build.py", line 276, in build_main
    app = Sphinx(args.sourcedir, args.confdir, args.outputdir,
  File "/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages/sphinx/application.py", line 223, in __init__
    self.setup_extension(extension)
  File "/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages/sphinx/application.py", line 398, in setup_extension
    self.registry.load_extension(self, extname)
  File "/home/docs/checkouts/readthedocs.org/user_builds/advanced-micro-devices-hiprand/envs/latest/lib/python3.8/site-packages/sphinx/registry.py", line 462, in load_extension
    raise ExtensionError(__('Could not import extension %s') % extname,
sphinx.errors.ExtensionError: Could not import extension exhale (exception: No module named 'exhale')

Extension error:
Could not import extension exhale (exception: No module named 'exhale')