Repository navigation
3.5.0: sphinx warnings #66
Copy link
Copy link
Open
Description
Looks like sphinx 4.2 shows some warnings on generate documentation.
+ /usr/bin/python3 setup.py build_sphinx -b man --build-dir build/sphinx
running build_sphinx
Running Sphinx v4.2.0
making output directory... done
building [mo]: targets for 0 po files that are out of date
building [man]: all manpages
updating environment: [new config] 61 added, 0 changed, 0 removed
reading sources... [100%] url-parsing-with-wsgi
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/index.txt:14: WARNING: toctree contains reference to nonexisting document 'StyleGuide'
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/index.txt:14: WARNING: duplicated entry found in toctree: paste-httpserver-threadpool
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/index.txt:14: WARNING: duplicated entry found in toctree: testing-applications
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/index.txt:14: WARNING: duplicated entry found in toctree: url-parsing-with-wsgi
WARNING: autodoc: failed to import module 'fsdiff' from module 'paste.debug'; the following exception was raised:
No module named 'UserDict'
WARNING: don't know which module to import for autodocumenting 'Diff' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'Snapshot' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'File' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'Dir' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'report_expected_diffs' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'show_diff' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: autodoc: failed to import module 'prints' from module 'paste.debug'; the following exception was raised:
No module named 'cStringIO'
WARNING: don't know which module to import for autodocumenting 'PrintDebugMiddleware' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: autodoc: failed to import module 'profile' from module 'paste.debug'; the following exception was raised:
No module named 'hotshot'
WARNING: don't know which module to import for autodocumenting 'ProfileMiddleware' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'make_profile_middleware' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'profile_decorator' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: autodoc: failed to import module 'watchthreads' from module 'paste.debug'; the following exception was raised:
No module named 'cStringIO'
WARNING: don't know which module to import for autodocumenting 'WatchThreads' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'make_watch_threads' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'make_bad_app' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: autodoc: failed to import module 'wdg_validate' from module 'paste.debug'; the following exception was raised:
No module named 'cStringIO'
WARNING: don't know which module to import for autodocumenting 'WDGValidateMiddleware' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'make_wdg_validate_middleware' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: autodoc: failed to import module 'transaction' from module 'paste'; the following exception was raised:
No module named 'wsgilib'
WARNING: don't know which module to import for autodocumenting 'TransactionManagerMiddleware' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'ConnectionFactory' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
WARNING: don't know which module to import for autodocumenting 'BasicTransactionHandler' (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/include/reference_header.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/auth.auth_tkt.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/auth.basic.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/auth.cas.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/auth.cookie.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/auth.digest.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/auth.form.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/auth.grantip.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/auth.multi.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/cascade.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/cgiapp.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/cgitb_catcher.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/debug.debugapp.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/debug.fsdiff.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/debug.prints.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/debug.profile.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/debug.watchthreads.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/debug.wdg_validate.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/errordocument.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/evalexception.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/exceptions.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/fileapp.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/fixture.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/gzipper.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/httpexceptions.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/httpheaders.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/httpserver.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/lint.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/pony.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/progress.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/proxy.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/recursive.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/registry.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/reloader.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/request.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/response.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/session.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/transaction.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/translogger.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/url.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/urlmap.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/urlparser.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/util.import_string.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/util.multidict.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/wsgilib.txt: WARNING: document isn't included in any toctree
/home/tkloczko/rpmbuild/BUILD/paste-3.5.0/docs/modules/wsgiwrappers.txt: WARNING: document isn't included in any toctree
done
writing... python-paste.3 { news future testing-applications url-parsing-with-wsgi do-it-yourself-framework paste-httpserver-threadpool developer-features DeveloperGuidelines community/index community/mailing-list community/repository download/index license } done
build succeeded, 74 warnings.
The manual pages are in build/sphinx/man.Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels
Activity
cdent commentedon Oct 3, 2021
Thanks for raising the issue.
I'm happy to review and accept a patch that addresses this, but from the README: "Paste is in maintenance mode ... Patches are accepted to keep it on life support, but for the most part, please consider using other options."
kloczek commentedon May 17, 2022
I've switched from using setuptools<>sphinx integration to use straight
sphinx-buildcommand to build documentation out of source treekloczek commentedon May 17, 2022
First batch of warnings can be fixed by patch like below:
With that pach:
You can peak on fixes that kind of issues in other projects
latchset/jwcrypto#289
click-contrib/sphinx-click@abc31069
cdent commentedon May 18, 2022
As I said in my previous comment on this issue, I'm happy to accept patches that fix this issue if you provide them, but paste is only on life-support so I won't be fixing it myself. People should not be using paste.
kloczek commentedon May 18, 2022
I'm only messanger ..