#296·boltons

21.0.0: sphinx warnings

Author: kloczekCreated Oct 27, 2021Updated Mar 9, 2024

Looks like latest sphinx emits some warnings on generating documentation

bash
+ /usr/bin/python3 setup.py build_sphinx -b man --build-dir build/sphinx
running build_sphinx
Running Sphinx v4.2.0
environ({'PBR_VERSION': '21.0.0', 'SETUPTOOLS_SCM_PRETEND_VERSION': '21.0.0', 'SHELL': '/bin/bash', 'RPM_SOURCE_DIR': '/home/tkloczko/rpmbuild/SOURCES', 'HISTCONTROL': 'ignoreboth', 'PKG_CONFIG_PATH': ':/usr/lib64/pkgconfig:/usr/share/pkgconfig', 'HISTSIZE': '1000', 'HOSTNAME': 'ss-desktop', 'FFLAGS': '-O2 -g -grecord-gcc-switches -pipe -Wall -Werror=format-security -Wp,-D_FORTIFY_SOURCE=2 -Wp,-D_GLIBCXX_ASSERTIONS -specs=/usr/lib/rpm/redhat/redhat-hardened-cc1 -fstack-protector-strong -specs=/usr/lib/rpm/redhat/redhat-annobin-cc1 -m64 -mtune=generic -fasynchronous-unwind-tables -fstack-clash-protection -fcf-protection -fdata-sections -ffunction-sections -flto=auto -flto-partition=none -I/usr/lib64/gfortran/modules', 'PWD': '/home/tkloczko/rpmbuild/BUILD/boltons-21.0.0', 'LOGNAME': 'tkloczko', 'XDG_SESSION_TYPE': 'tty', 'MC_TMPDIR': '/var/tmp/mc-tkloczko', 'CXX': '/usr/bin/g++', 'CXXFLAGS': '-O2 -g -grecord-gcc-switches -pipe -Wall -Werror=format-security -Wp,-D_FORTIFY_SOURCE=2 -Wp,-D_GLIBCXX_ASSERTIONS -specs=/usr/lib/rpm/redhat/redhat-hardened-cc1 -fstack-protector-strong -specs=/usr/lib/rpm/redhat/redhat-annobin-cc1 -m64 -mtune=generic -fasynchronous-unwind-tables -fstack-clash-protection -fcf-protection -fdata-sections -ffunction-sections -flto=auto -flto-partition=none', 'RPM_ARCH': 'x86_64', 'MOTD_SHOWN': 'pam', 'MC_SID': '277533', 'LDFLAGS': '-Wl,-z,relro -Wl,--as-needed -Wl,--gc-sections -Wl,-z,now -specs=/usr/lib/rpm/redhat/redhat-hardened-ld -flto=auto -flto-partition=none -fuse-linker-plugin', 'HOME': '/home/tkloczko', 'LANG': 'C', 'LS_COLORS': 'rs=0:di=01;34:ln=01;36:mh=00:pi=40;33:so=01;35:do=01;35:bd=40;33;01:cd=40;33;01:or=40;31;01:mi=01;37;41:su=37;41:sg=30;43:ca=30;41:tw=30;42:ow=34;42:st=37;44:ex=01;32:*.tar=01;31:*.tgz=01;31:*.arc=01;31:*.arj=01;31:*.taz=01;31:*.lha=01;31:*.lz4=01;31:*.lzh=01;31:*.lzma=01;31:*.tlz=01;31:*.txz=01;31:*.tzo=01;31:*.t7z=01;31:*.zip=01;31:*.z=01;31:*.dz=01;31:*.gz=01;31:*.lrz=01;31:*.lz=01;31:*.lzo=01;31:*.xz=01;31:*.zst=01;31:*.tzst=01;31:*.bz2=01;31:*.bz=01;31:*.tbz=01;31:*.tbz2=01;31:*.tz=01;31:*.deb=01;31:*.rpm=01;31:*.jar=01;31:*.war=01;31:*.ear=01;31:*.sar=01;31:*.rar=01;31:*.alz=01;31:*.ace=01;31:*.zoo=01;31:*.cpio=01;31:*.7z=01;31:*.rz=01;31:*.cab=01;31:*.wim=01;31:*.swm=01;31:*.dwm=01;31:*.esd=01;31:*.jpg=01;35:*.jpeg=01;35:*.mjpg=01;35:*.mjpeg=01;35:*.gif=01;35:*.bmp=01;35:*.pbm=01;35:*.pgm=01;35:*.ppm=01;35:*.tga=01;35:*.xbm=01;35:*.xpm=01;35:*.tif=01;35:*.tiff=01;35:*.png=01;35:*.svg=01;35:*.svgz=01;35:*.mng=01;35:*.pcx=01;35:*.mov=01;35:*.mpg=01;35:*.mpeg=01;35:*.m2v=01;35:*.mkv=01;35:*.webm=01;35:*.webp=01;35:*.ogm=01;35:*.mp4=01;35:*.m4v=01;35:*.mp4v=01;35:*.vob=01;35:*.qt=01;35:*.nuv=01;35:*.wmv=01;35:*.asf=01;35:*.rm=01;35:*.rmvb=01;35:*.flc=01;35:*.avi=01;35:*.fli=01;35:*.flv=01;35:*.gl=01;35:*.dl=01;35:*.xcf=01;35:*.xwd=01;35:*.yuv=01;35:*.cgm=01;35:*.emf=01;35:*.ogv=01;35:*.ogx=01;35:*.aac=00;36:*.au=00;36:*.flac=00;36:*.m4a=00;36:*.mid=00;36:*.midi=00;36:*.mka=00;36:*.mp3=00;36:*.mpc=00;36:*.ogg=00;36:*.ra=00;36:*.wav=00;36:*.oga=00;36:*.opus=00;36:*.spx=00;36:*.xspf=00;36:', 'RPM_LD_FLAGS': '-Wl,-z,relro -Wl,--as-needed -Wl,--gc-sections -Wl,-z,now -specs=/usr/lib/rpm/redhat/redhat-hardened-ld -flto=auto -flto-partition=none -fuse-linker-plugin', 'RPM_PACKAGE_RELEASE': '2.fc35', 'SSH_CONNECTION': '127.0.0.1 58154 127.0.0.1 22', 'RPM_OS': 'linux', 'FCFLAGS': '-O2 -g -grecord-gcc-switches -pipe -Wall -Werror=format-security -Wp,-D_FORTIFY_SOURCE=2 -Wp,-D_GLIBCXX_ASSERTIONS -specs=/usr/lib/rpm/redhat/redhat-hardened-cc1 -fstack-protector-strong -specs=/usr/lib/rpm/redhat/redhat-annobin-cc1 -m64 -mtune=generic -fasynchronous-unwind-tables -fstack-clash-protection -fcf-protection -fdata-sections -ffunction-sections -flto=auto -flto-partition=none -I/usr/lib64/gfortran/modules', 'XDG_SESSION_CLASS': 'user', 'TERM': 'xterm-256color', 'LESSOPEN': '||/usr/bin/lesspipe.sh %s', 'USER': 'tkloczko', 'AR': '/usr/bin/gcc-ar', 'SHLVL': '3', 'RPM_BUILD_DIR': '/home/tkloczko/rpmbuild/BUILD', 'NM': '/usr/bin/gcc-nm', 'RPM_OPT_FLAGS': '-O2 -g -grecord-gcc-switches -pipe -Wall -Werror=format-security -Wp,-D_FORTIFY_SOURCE=2 -Wp,-D_GLIBCXX_ASSERTIONS -specs=/usr/lib/rpm/redhat/redhat-hardened-cc1 -fstack-protector-strong -specs=/usr/lib/rpm/redhat/redhat-annobin-cc1 -m64  -mtune=generic -fasynchronous-unwind-tables -fstack-clash-protection -fcf-protection', 'XDG_SESSION_ID': '510451', 'RPM_DOC_DIR': '/usr/share/doc', 'XDG_RUNTIME_DIR': '/run/user/1001', 'SSH_CLIENT': '127.0.0.1 58154 22', 'RPM_PACKAGE_VERSION': '21.0.0', 'FC': '/usr/bin/gfortran', 'which_declare': 'declare -f', 'KDEDIRS': '/usr', 'CONFIG_SITE': 'NONE', 'PATH': '/home/tkloczko/.local/bin:/home/tkloczko/bin:/usr/bin:/usr/sbin:/usr/local/sbin', 'CC': '/usr/bin/gcc', 'CFLAGS': '-O2 -g -grecord-gcc-switches -pipe -Wall -Werror=format-security -Wp,-D_FORTIFY_SOURCE=2 -Wp,-D_GLIBCXX_ASSERTIONS -specs=/usr/lib/rpm/redhat/redhat-hardened-cc1 -fstack-protector-strong -specs=/usr/lib/rpm/redhat/redhat-annobin-cc1 -m64 -mtune=generic -fasynchronous-unwind-tables -fstack-clash-protection -fcf-protection -fdata-sections -ffunction-sections -flto=auto -flto-partition=none', 'DBUS_SESSION_BUS_ADDRESS': 'unix:path=/run/user/1001/bus', 'MAIL': '/var/spool/mail/tkloczko', 'SSH_TTY': '/dev/pts/7', 'RPM_BUILD_NCPUS': '12', 'RPM_PACKAGE_NAME': 'python-boltons', 'RANLIB': '/usr/bin/gcc-ranlib', 'RPM_BUILD_ROOT': '/home/tkloczko/rpmbuild/BUILDROOT/python-boltons-21.0.0-2.fc35.x86_64', 'OLDPWD': '/home/tkloczko/rpmbuild/BUILD', 'BASH_FUNC_which%%': '() {  ( alias;\n eval ${which_declare} ) | /usr/bin/which --tty-only --read-alias --read-functions --show-tilde --show-dot $@\n}', '_': '/usr/bin/python3', 'LC_CTYPE': 'C.UTF-8', 'PLAT': 'linux-x86_64', 'DOCUTILSCONFIG': '/home/tkloczko/rpmbuild/BUILD/boltons-21.0.0/docs/docutils.conf'})
==== 29 modules ==== 85 types ==== 170 funcs ====
making output directory... done
WARNING: html_static_path entry '_static' does not exist
[autosummary] generating autosummary for: architecture.rst, cacheutils.rst, debugutils.rst, dictutils.rst, ecoutils.rst, fileutils.rst, formatutils.rst, funcutils.rst, gcutils.rst, index.rst, ..., queueutils.rst, setutils.rst, socketutils.rst, statsutils.rst, strutils.rst, tableutils.rst, tbutils.rst, timeutils.rst, typeutils.rst, urlutils.rst
loading intersphinx inventory from https://docs.python.org/objects.inv...
intersphinx inventory has moved: https://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 [man]: all manpages
updating environment: [new config] 28 added, 0 changed, 0 removed
reading sources... [100%] urlutils
/home/tkloczko/rpmbuild/BUILD/boltons-21.0.0/boltons/fileutils.py:docstring of boltons.fileutils.atomic_rename:1: WARNING: Inline emphasis start-string without end-string.
/home/tkloczko/rpmbuild/BUILD/boltons-21.0.0/docs/index.rst:2: WARNING: Explicit markup ends without a blank line; unexpected unindent.
/home/tkloczko/rpmbuild/BUILD/boltons-21.0.0/boltons/setutils.py:docstring of boltons.setutils.complement:10: WARNING: Inconsistent literal block quoting.
/home/tkloczko/rpmbuild/BUILD/boltons-21.0.0/boltons/setutils.py:docstring of boltons.setutils.complement:41: WARNING: Unexpected section title.

Complement sets by example
^^^^^^^^^^^^^^^^^^^^^^^^^^
/home/tkloczko/rpmbuild/BUILD/boltons-21.0.0/boltons/timeutils.py:docstring of boltons.timeutils.isoparse:20: WARNING: Duplicate explicit target name: "dateutil".
/home/tkloczko/rpmbuild/BUILD/boltons-21.0.0/docs/timeutils.rst:43: WARNING: Duplicate explicit target name: "dateutil".
/home/tkloczko/rpmbuild/BUILD/boltons-21.0.0/boltons/timeutils.py:docstring of boltons.timeutils:13: WARNING: Duplicate target name, cannot be used as a unique reference: "dateutil".
/home/tkloczko/rpmbuild/BUILD/boltons-21.0.0/boltons/timeutils.py:docstring of boltons.timeutils.isoparse:15: WARNING: Duplicate target name, cannot be used as a unique reference: "dateutil".
/home/tkloczko/rpmbuild/BUILD/boltons-21.0.0/docs/timeutils.rst:39: WARNING: Duplicate target name, cannot be used as a unique reference: "dateutil".
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
writing... python-boltons.3 { architecture cacheutils debugutils dictutils ecoutils fileutils formatutils funcutils gcutils ioutils iterutils jsonutils listutils mathutils mboxutils namedutils pathutils queueutils setutils socketutils statsutils strutils tableutils tbutils timeutils typeutils urlutils } done
build succeeded, 10 warnings.