0.18.3: documentation build warnings

[kloczek]

Sphinx warnings `reference target not found"

+ /usr/bin/sphinx-build -n -T -b man docs build/sphinx/man
Running Sphinx v7.1.2
making output directory... done
building [mo]: targets for 0 po files that are out of date
writing output...
building [man]: all manpages
updating environment: [new config] 7 added, 0 changed, 0 removed
reading sources... [100%] server
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/fsm.rst:12: WARNING: Type must be either just a name or a typedef-like declaration.
If just a name:
  Error in declarator or parameters
  Invalid C declaration: Expected identifier in nested name, got keyword: struct [error at 6]
    struct raft_fsm
    ------^
If typedef-like declaration:
  Error in declarator or parameters
  Invalid C declaration: Expected identifier in nested name. [error at 15]
    struct raft_fsm
    ---------------^

/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:12: WARNING: Type must be either just a name or a typedef-like declaration.
If just a name:
  Error in declarator or parameters
  Invalid C declaration: Expected identifier in nested name, got keyword: struct [error at 6]
    struct raft_io
    ------^
If typedef-like declaration:
  Error in declarator or parameters
  Invalid C declaration: Expected identifier in nested name. [error at 14]
    struct raft_io
    --------------^

/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:32: WARNING: Duplicate C declaration, also defined at fsm:19.
Declaration is '.. c:member:: void* data'.
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:37: WARNING: Duplicate C declaration, also defined at fsm:24.
Declaration is '.. c:member:: int version'.
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:12: WARNING: Type must be either just a name or a typedef-like declaration.
If just a name:
  Error in declarator or parameters
  Invalid C declaration: Expected identifier in nested name, got keyword: struct [error at 6]
    struct raft
    ------^
If typedef-like declaration:
  Error in declarator or parameters
  Invalid C declaration: Expected identifier in nested name. [error at 11]
    struct raft
    -----------^

/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:28: WARNING: Duplicate C declaration, also defined at fsm:19.
Declaration is '.. c:member:: void* data'.
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... c-raftdocumentation.1 { getting-started api server fsm io disk-format } /home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:3: WARNING: Unparseable C cross-reference: 'struct raft'
Invalid C declaration: Expected identifier in nested name, got keyword: struct [error at 6]
  struct raft
  ------^
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:3: WARNING: c:type reference target not found: struct raft
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:20: WARNING: c:identifier reference target not found: raft
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:40: WARNING: c:identifier reference target not found: raft
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:40: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:40: WARNING: c:identifier reference target not found: raft_fsm
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:44: WARNING: c:identifier reference target not found: raft
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:51: WARNING: c:identifier reference target not found: raft
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:55: WARNING: Unparseable C cross-reference: 'raft_io->load'
Invalid C declaration: Expected end of definition. [error at 7]
  raft_io->load
  -------^
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/server.rst:55: WARNING: c:func reference target not found: raft_io->load
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/fsm.rst:3: WARNING: Unparseable C cross-reference: 'struct raft_fsm'
Invalid C declaration: Expected identifier in nested name, got keyword: struct [error at 6]
  struct raft_fsm
  ------^
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/fsm.rst:3: WARNING: c:type reference target not found: struct raft_fsm
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/fsm.rst:28: WARNING: c:identifier reference target not found: raft_fsm
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/fsm.rst:28: WARNING: c:identifier reference target not found: raft_buffer
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/fsm.rst:32: WARNING: c:identifier reference target not found: raft_fsm
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/fsm.rst:32: WARNING: c:identifier reference target not found: raft_buffer
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/fsm.rst:36: WARNING: c:identifier reference target not found: raft_fsm
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/fsm.rst:36: WARNING: c:identifier reference target not found: raft_buffer
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:3: WARNING: Unparseable C cross-reference: 'struct raft_io'
Invalid C declaration: Expected identifier in nested name, got keyword: struct [error at 6]
  struct raft_io
  ------^
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:3: WARNING: c:type reference target not found: struct raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:16: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:18: WARNING: c:func reference target not found: raft_io.close
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:20: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:24: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:24: WARNING: c:identifier reference target not found: raft_message
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:45: WARNING: c:identifier reference target not found: RAFT_ERRMSG_BUF_SIZE
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:50: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:55: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:59: WARNING: c:type reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:64: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:64: WARNING: c:identifier reference target not found: raft_term
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:64: WARNING: c:identifier reference target not found: raft_snapshot
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:64: WARNING: c:identifier reference target not found: raft_index
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:64: WARNING: c:identifier reference target not found: raft_entry
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:64: WARNING: c:identifier reference target not found: size_t
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:72: WARNING: c:func reference target not found: raft_io.append
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:76: WARNING: c:func reference target not found: raft_malloc
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:80: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:88: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:88: WARNING: c:identifier reference target not found: raft_configuration
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:99: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:99: WARNING: c:identifier reference target not found: raft_configuration
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:103: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:103: WARNING: c:identifier reference target not found: raft_term
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:110: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:117: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:117: WARNING: c:identifier reference target not found: raft_io_send
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:117: WARNING: c:identifier reference target not found: raft_message
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:117: WARNING: c:identifier reference target not found: raft_io_send_cb
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:124: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:124: WARNING: c:identifier reference target not found: raft_io_append
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:124: WARNING: c:identifier reference target not found: raft_entry
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:124: WARNING: c:identifier reference target not found: raft_io_append_cb
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:131: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:131: WARNING: c:identifier reference target not found: raft_index
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:135: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:135: WARNING: c:identifier reference target not found: raft_io_snapshot_put
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:135: WARNING: c:identifier reference target not found: raft_snapshot
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:135: WARNING: c:identifier reference target not found: raft_io_snapshot_put_cb
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:147: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:147: WARNING: c:identifier reference target not found: raft_io_snapshot_get
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:147: WARNING: c:identifier reference target not found: raft_io_snapshot_get_cb
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:151: WARNING: c:identifier reference target not found: raft_time
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:151: WARNING: c:identifier reference target not found: raft_io
/home/tkloczko/rpmbuild/BUILD/raft-0.18.3/docs/io.rst:155: WARNING: c:identifier reference target not found: raft_io
done
build succeeded, 71 warnings.

You can peak on fixes that kind of issues in other projects https://github.com/RDFLib/rdflib-sqlalchemy/issues/95 https://github.com/RDFLib/rdflib/pull/2036 https://github.com/click-contrib/sphinx-click/commit/abc31069 https://github.com/frostming/unearth/issues/14 https://github.com/jaraco/cssutils/issues/21 https://github.com/latchset/jwcrypto/pull/289 https://github.com/latchset/jwcrypto/pull/289 https://github.com/pypa/distlib/commit/98b9b89f https://github.com/pywbem/pywbem/pull/2895 https://github.com/sissaschool/elementpath/commit/bf869d9e https://github.com/sissaschool/xmlschema/commit/42ea98f2 https://github.com/sqlalchemy/sqlalchemy/commit/5e88e6e8