search

emscripten-core / emscripten

Emscripten: An LLVM-to-WebAssembly Compiler
Other
25.67k stars 3.29k forks source link

Sphinx-build is not warnings clean #13463

Open juj opened 3 years ago

juj commented 3 years ago

Sphinx Makefile currently has a -W directive (treat warnings as errors):

https://github.com/emscripten-core/emscripten/blob/da6d09491f9195d1c26d705e5089192364ff49db/site/Makefile#L5

In order to succeed a doc build, I had to remove that, and the run read:

MacBook-Pro:site clb$ make text
sphinx-build -b text -d build/doctrees   source build/text
Running Sphinx v3.4.3
loading pickled environment... failed
failed: build environment version not current
loading intersphinx inventory from http://docs.python.org/objects.inv...
intersphinx inventory has moved: http://docs.python.org/objects.inv -> https://docs.python.org/3/objects.inv
building [mo]: targets for 0 po files that are out of date
building [text]: targets for 76 source files that are out of date
updating environment: [new config] 76 added, 0 changed, 0 removed
reading sources... [100%] index                                                                                                       
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] index                                                                                                        
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:281: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:293: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:305: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:317: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:317: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:332: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:368: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:368: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:380: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:380: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:380: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:398: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:438: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:457: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:472: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:472: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:487: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:633: WARNING: Unparseable C cross-reference: 'const'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:633: WARNING: Unparseable C cross-reference: 'const'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:657: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:657: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:695: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:695: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:695: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:695: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:695: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:738: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:738: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:738: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:738: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:738: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:745: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:768: WARNING: Unparseable C cross-reference: 'char*'
Invalid C declaration: Expected identifier in nested name, got keyword: char [error at 4]
  char*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:768: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:768: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:792: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:811: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:828: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:848: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:870: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:927: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:955: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:955: WARNING: Unparseable C cross-reference: 'char*'
Invalid C declaration: Expected identifier in nested name, got keyword: char [error at 4]
  char*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:955: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:955: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:968: WARNING: Unparseable C cross-reference: 'char*'
Invalid C declaration: Expected identifier in nested name, got keyword: char [error at 4]
  char*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:968: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1046: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1070: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1070: WARNING: Unparseable C cross-reference: 'const'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1083: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1083: WARNING: Unparseable C cross-reference: 'char*'
Invalid C declaration: Expected identifier in nested name, got keyword: char [error at 4]
  char*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1083: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1097: WARNING: Unparseable C cross-reference: 'int*'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int*
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1097: WARNING: Unparseable C cross-reference: 'int*'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int*
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1091: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1108: WARNING: Unparseable C cross-reference: 'FILE*'
Invalid C declaration: Expected end of definition. [error at 4]
  FILE*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1108: WARNING: Unparseable C cross-reference: 'int*'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int*
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1108: WARNING: Unparseable C cross-reference: 'int*'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int*
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1103: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1117: WARNING: Unparseable C cross-reference: 'double'
Invalid C declaration: Expected identifier in nested name, got keyword: double [error at 6]
  double
  ------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1117: WARNING: Unparseable C cross-reference: 'char*'
Invalid C declaration: Expected identifier in nested name, got keyword: char [error at 4]
  char*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1117: WARNING: Unparseable C cross-reference: 'signed'
Invalid C declaration: Expected identifier in nested name, got keyword: signed [error at 6]
  signed
  ------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1159: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1159: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1174: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1174: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1174: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1174: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1187: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1197: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1207: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1218: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1229: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1239: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1289: WARNING: Unparseable C cross-reference: 'const'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/emscripten.h.rst:1289: WARNING: Unparseable C cross-reference: 'const'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/fiber.h.rst:87: WARNING: Unparseable C cross-reference: 'emscripten_fiber_t*'
Invalid C declaration: Expected end of definition. [error at 18]
  emscripten_fiber_t*
  ------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/fiber.h.rst:87: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/fiber.h.rst:87: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/fiber.h.rst:87: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/fiber.h.rst:99: WARNING: Unparseable C cross-reference: 'emscripten_fiber_t*'
Invalid C declaration: Expected end of definition. [error at 18]
  emscripten_fiber_t*
  ------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/fiber.h.rst:99: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/fiber.h.rst:105: WARNING: Unparseable C cross-reference: 'emscripten_fiber_t*'
Invalid C declaration: Expected end of definition. [error at 18]
  emscripten_fiber_t*
  ------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/fiber.h.rst:105: WARNING: Unparseable C cross-reference: 'emscripten_fiber_t*'
Invalid C declaration: Expected end of definition. [error at 18]
  emscripten_fiber_t*
  ------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:325: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:325: WARNING: Unparseable C cross-reference: 'const EmscriptenKeyboardEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenKeyboardEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:325: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:348: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:348: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:449: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:449: WARNING: Unparseable C cross-reference: 'const EmscriptenMouseEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenMouseEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:449: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:472: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:472: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:484: WARNING: Unparseable C cross-reference: 'EmscriptenMouseEvent*'
Invalid C declaration: Expected end of definition. [error at 20]
  EmscriptenMouseEvent*
  --------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:551: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:551: WARNING: Unparseable C cross-reference: 'const EmscriptenWheelEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenWheelEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:551: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:568: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:568: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:632: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:632: WARNING: Unparseable C cross-reference: 'const EmscriptenUiEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenUiEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:632: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:656: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:656: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:711: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:711: WARNING: Unparseable C cross-reference: 'const EmscriptenFocusEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenFocusEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:711: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:731: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:731: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:791: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:791: WARNING: Unparseable C cross-reference: 'const EmscriptenDeviceOrientationEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenDeviceOrientationEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:791: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:805: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:818: WARNING: Unparseable C cross-reference: 'EmscriptenDeviceOrientationEvent*'
Invalid C declaration: Expected end of definition. [error at 32]
  EmscriptenDeviceOrientationEvent*
  --------------------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:883: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:883: WARNING: Unparseable C cross-reference: 'const EmscriptenDeviceMotionEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenDeviceMotionEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:883: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:897: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:910: WARNING: Unparseable C cross-reference: 'EmscriptenDeviceMotionEvent*'
Invalid C declaration: Expected end of definition. [error at 27]
  EmscriptenDeviceMotionEvent*
  ---------------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:976: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:976: WARNING: Unparseable C cross-reference: 'const EmscriptenOrientationChangeEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenOrientationChangeEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:976: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:990: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1000: WARNING: Unparseable C cross-reference: 'EmscriptenOrientationChangeEvent*'
Invalid C declaration: Expected end of definition. [error at 32]
  EmscriptenOrientationChangeEvent*
  --------------------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1009: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1177: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1177: WARNING: Unparseable C cross-reference: 'const EmscriptenFullscreenChangeEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenFullscreenChangeEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1177: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1193: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1193: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1203: WARNING: Unparseable C cross-reference: 'EmscriptenFullscreenChangeEvent*'
Invalid C declaration: Expected end of definition. [error at 31]
  EmscriptenFullscreenChangeEvent*
  -------------------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1218: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1227: WARNING: Unparseable C cross-reference: 'const EmscriptenFullscreenStrategy*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenFullscreenStrategy*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1303: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1303: WARNING: Unparseable C cross-reference: 'const EmscriptenPointerlockChangeEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenPointerlockChangeEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1303: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1319: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1319: WARNING: Unparseable C cross-reference: 'const'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1319: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1338: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1338: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1352: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1352: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1361: WARNING: Unparseable C cross-reference: 'EmscriptenPointerlockChangeEvent*'
Invalid C declaration: Expected end of definition. [error at 32]
  EmscriptenPointerlockChangeEvent*
  --------------------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1375: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1447: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1447: WARNING: Unparseable C cross-reference: 'const EmscriptenVisibilityChangeEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenVisibilityChangeEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1447: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1461: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1471: WARNING: Unparseable C cross-reference: 'EmscriptenVisibilityChangeEvent*'
Invalid C declaration: Expected end of definition. [error at 31]
  EmscriptenVisibilityChangeEvent*
  -------------------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1574: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1574: WARNING: Unparseable C cross-reference: 'const EmscriptenTouchEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenTouchEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1574: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1594: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1594: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1682: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1682: WARNING: Unparseable C cross-reference: 'const EmscriptenGamepadEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenGamepadEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1682: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1697: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1747: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1747: WARNING: Unparseable C cross-reference: 'EmscriptenGamepadEvent*'
Invalid C declaration: Expected end of definition. [error at 22]
  EmscriptenGamepadEvent*
  ----------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1804: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1804: WARNING: Unparseable C cross-reference: 'const EmscriptenBatteryEvent*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenBatteryEvent*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1804: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1818: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1829: WARNING: Unparseable C cross-reference: 'EmscriptenBatteryEvent*'
Invalid C declaration: Expected end of definition. [error at 22]
  EmscriptenBatteryEvent*
  ----------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1845: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1855: WARNING: Unparseable C cross-reference: 'int*'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int*
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1855: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1886: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1886: WARNING: Unparseable C cross-reference: 'const void*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const void*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1886: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:1903: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2024: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2024: WARNING: Unparseable C cross-reference: 'const void*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const void*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2024: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2042: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2042: WARNING: Unparseable C cross-reference: 'void*'
Invalid C declaration: Expected identifier in nested name, got keyword: void [error at 4]
  void*
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2063: WARNING: Unparseable C cross-reference: 'EmscriptenWebGLContextAttributes*'
Invalid C declaration: Expected end of definition. [error at 32]
  EmscriptenWebGLContextAttributes*
  --------------------------------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2080: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2080: WARNING: Unparseable C cross-reference: 'const EmscriptenWebGLContextAttributes*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const EmscriptenWebGLContextAttributes*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2125: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2125: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2145: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2184: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2184: WARNING: Unparseable C cross-reference: 'double'
Invalid C declaration: Expected identifier in nested name, got keyword: double [error at 6]
  double
  ------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2184: WARNING: Unparseable C cross-reference: 'double'
Invalid C declaration: Expected identifier in nested name, got keyword: double [error at 6]
  double
  ------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2197: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2197: WARNING: Unparseable C cross-reference: 'double*'
Invalid C declaration: Expected identifier in nested name, got keyword: double [error at 6]
  double*
  ------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/html5.h.rst:2197: WARNING: Unparseable C cross-reference: 'double*'
Invalid C declaration: Expected identifier in nested name, got keyword: double [error at 6]
  double*
  ------^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'bool'
Invalid C declaration: Expected identifier in nested name, got keyword: bool [error at 4]
  bool
  ----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char *'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char *
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const void*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const void*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const void*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const void*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const void*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const void*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const void*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const void*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const void*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const void*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const void*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const void*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'int'
Invalid C declaration: Expected identifier in nested name, got keyword: int [error at 3]
  int
  ---^
/Users/clb/emsdk/emscripten/master/site/source/docs/api_reference/trace.h.rst:: WARNING: Unparseable C cross-reference: 'const char*'
Invalid C declaration: Expected identifier in nested name, got keyword: const [error at 5]
  const char*
  -----^
/Users/clb/emsdk/emscripten/master/site/source/docs/building_from_source/toolchain_what_is_needed.rst:25: WARNING: term Node.js not found in case sensitive match.made a reference to node.js instead.
/Users/clb/emsdk/emscripten/master/site/source/docs/compiling/Building-Projects.rst:166: WARNING: term clang not found in case sensitive match.made a reference to Clang instead.
/Users/clb/emsdk/emscripten/master/site/source/docs/introducing_emscripten/about_emscripten.rst:45: WARNING: term Node.js not found in case sensitive match.made a reference to node.js instead.
/Users/clb/emsdk/emscripten/master/site/source/docs/porting/connecting_cpp_and_javascript/WebIDL-Binder.rst:151: WARNING: term closure compiler not found in case sensitive match.made a reference to Closure Compiler instead.
/Users/clb/emsdk/emscripten/master/site/source/docs/porting/connecting_cpp_and_javascript/embind.rst:92: WARNING: term closure compiler not found in case sensitive match.made a reference to Closure Compiler instead.
/Users/clb/emsdk/emscripten/master/site/source/docs/porting/guidelines/function_pointer_issues.rst:28: WARNING: term clang not found in case sensitive match.made a reference to Clang instead.
/Users/clb/emsdk/emscripten/master/site/source/docs/porting/guidelines/portability_guidelines.rst:40: WARNING: term relooping not found in case sensitive match.made a reference to Relooping instead.
/Users/clb/emsdk/emscripten/master/site/source/docs/tools_reference/emcc.rst:195: WARNING: term minifying not found in case sensitive match.made a reference to Minifying instead.
build succeeded, 223 warnings.

The text files are in build/text.

Build finished. The text files are in build/text.
sbc100 commented 3 years ago

The way this works today is that, at any given time, the site needs to be build with a specific sphinx version. As of today, that version is 2.4.4. I've tried to upgrade to version 3 in the past but run into issues.. but we should try again.

I really want to keep the -W so the site builds warning-free but perhaps we can and should fail-fast if the wrong version is used.

There are several improvements we could make here:

  1. Clearly document the exact version we require.
  2. Upgrade to a more recent version
  3. Fail fast on attempts to build the site with any other version.
stale[bot] commented 2 years ago

This issue has been automatically marked as stale because there has been no activity in the past year. It will be closed automatically if no further activity occurs in the next 30 days. Feel free to re-open at any time if this issue is still relevant.