yahoo-eng-team team mailing list archive
-
yahoo-eng-team team
-
Mailing list archive
-
Message #60834
[Bug 1659485] [NEW] Warnings about nova-status.rst and config in Document generation
Public bug reported:
When executing 'tox -e docs', the following warnings are output.
* WARNING:stevedore.named:Could not load nova.api, nova.cells
* /tmp/nova/doc/source/man/nova-status.rst:66: WARNING: Literal block expected; none found.
* /tmp/nova/doc/source/man/nova-status.rst:73: WARNING: Enumerated list ends without a blank line;
The warnings about nova-status.rst are related with code block.
But it had better be replaced with a table.
-----
stack@devstack-master:/tmp/nova$ tox -e docs
docs create: /tmp/nova/.tox/docs
docs installdeps: -r/tmp/nova/test-requirements.txt
docs develop-inst: /tmp/nova
docs installed: alabaster==0.7.9,alembic==0.8.10,amqp==1.4.9,anyjson==0.3.3,appdirs==1.4.0,Babel==2.3.4,bandit==1.4.0,cachetools==2.0.0,castellan==0.5.0,cffi==1.9.1,cliff==2.4.0,cmd2==0.6.9,colorama==0.3.7,contextlib2==0.5.4,coverage==4.3.4,cryptography==1.7.1,ddt==1.1.1,debtcollector==1.11.0,decorator==4.0.11,docutils==0.12,dogpile.cache==0.6.2,dulwich==0.16.3,enum34==1.1.6,eventlet==0.19.0,extras==1.0.0,fasteners==0.14.1,fixtures==3.0.0,flake8==2.2.4,funcsigs==1.0.2,functools32==3.2.3.post2,futures==3.0.5,futurist==0.21.0,gabbi==1.31.0,gitdb2==2.0.0,GitPython==2.1.1,greenlet==0.4.11,hacking==0.10.2,httplib2==0.9.2,idna==2.2,ipaddress==1.0.18,iso8601==0.1.11,Jinja2==2.8.1,jsonpatch==1.15,jsonpath-rw==1.4.0,jsonpath-rw-ext==1.0.0,jsonpointer==1.10,jsonschema==2.5.1,keystoneauth1==2.18.0,keystonemiddleware==4.14.0,kombu==3.0.37,linecache2==1.0.0,lxml==3.7.2,Mako==1.0.6,MarkupSafe==0.23,mccabe==0.2.1,microversion-parse==0.1.4,mock==2.0.0,monotonic==1.2,mox3==0.20.0,msgpack-python==0.4.8,netaddr==0.7.19,netifaces==0.10.5,-e git+https://git.openstack.org/openstack/nova.git@5f59c0e3c61cd6f0600de3a69eeef2037358b782#egg=nova,numpy==1.12.0,openstackdocstheme==1.6.1,openstacksdk==0.9.10,os-api-ref==1.2.0,os-brick==1.11.0,os-client-config==1.26.0,os-testr==0.8.0,os-vif==1.4.0,os-win==1.4.0,os-xenapi==0.1.1,osc-lib==1.3.0,oslo.cache==1.17.0,oslo.concurrency==3.18.0,oslo.config==3.22.0,oslo.context==2.11.0,oslo.db==4.17.0,oslo.i18n==3.12.0,oslo.log==3.20.0,oslo.messaging==5.17.0,oslo.middleware==3.23.0,oslo.policy==1.18.0,oslo.privsep==1.16.0,oslo.reports==1.17.0,oslo.rootwrap==5.4.0,oslo.serialization==2.16.0,oslo.service==1.19.0,oslo.utils==3.22.0,oslo.versionedobjects==1.21.0,oslo.vmware==2.17.0,oslosphinx==4.10.0,oslotest==2.13.0,osprofiler==1.5.0,packaging==16.8,paramiko==2.1.1,Paste==2.0.3,PasteDeploy==1.5.2,pbr==1.10.0,pep8==1.5.7,pika==0.10.0,pika-pool==0.1.3,ply==3.9,positional==1.1.1,prettytable==0.7.2,psutil==5.0.1,psycopg2==2.6.2,py==1.4.32,pyasn1==0.1.9,pycadf==2.5.0,pycparser==2.17,pyflakes==0.8.1,Pygments==2.2.0,pyinotify==0.9.6,PyMySQL==0.7.9,pyparsing==2.1.10,pytest==3.0.6,python-barbicanclient==4.1.0,python-cinderclient==1.10.0,python-dateutil==2.6.0,python-editor==1.0.3,python-glanceclient==2.6.0,python-ironicclient==1.10.0,python-keystoneclient==3.9.0,python-mimeparse==1.6.0,python-neutronclient==6.1.0,python-novaclient==6.0.0,python-openstackclient==3.7.0,python-subunit==1.2.0,pytz==2016.10,PyYAML==3.12,reno==2.0.3,repoze.lru==0.6,requests==2.12.5,requests-mock==1.2.0,requestsexceptions==1.1.3,retrying==1.3.3,rfc3986==0.4.1,Routes==2.4.1,simplejson==3.10.0,six==1.10.0,smmap2==2.0.1,snowballstemmer==1.2.1,Sphinx==1.3.6,sphinx-rtd-theme==0.1.9,SQLAlchemy==1.0.17,sqlalchemy-migrate==0.10.0,sqlparse==0.2.2,statsd==3.2.1,stevedore==1.19.1,suds-jurko==0.6,tempest-lib==1.0.0,Tempita==0.5.2,tenacity==3.7.1,testrepository==0.0.20,testresources==2.0.1,testscenarios==0.5.0,testtools==2.2.0,traceback2==1.4.0,unicodecsv==0.14.1,unittest2==1.1.0,urllib3==1.20,warlock==1.2.0,WebOb==1.6.3,websockify==0.8.0,wrapt==1.10.8,wsgi-intercept==1.4.1
docs runtests: PYTHONHASHSEED='1259549316'
docs runtests: commands[0] | rm -rf doc/source/api doc/build api-guide/build api-ref/build
docs runtests: commands[1] | python setup.py build_sphinx
running build_sphinx
creating /tmp/nova/doc/build
creating /tmp/nova/doc/build/doctrees
creating /tmp/nova/doc/build/html
[pbr] Writing ChangeLog
[pbr] Generating ChangeLog
[pbr] ChangeLog complete (1.4s)
[pbr] Generating AUTHORS
[pbr] AUTHORS complete (1.9s)
Running Sphinx v1.3.6
loading pickled environment... not yet created
Using openstack theme from /tmp/nova/.tox/docs/local/lib/python2.7/site-packages/oslosphinx/theme
[oslo_config.sphinxconfiggen] reading config generator instructions from /tmp/nova/doc/source/../../etc/nova/nova-config-generator.conf
[oslo_config.sphinxconfiggen] writing sample configuration to /tmp/nova/doc/source/_static/nova.conf.sample
WARNING:stevedore.named:Could not load nova.api, nova.cells
[oslo_policy.sphinxpolicygen] reading config generator instructions from /tmp/nova/doc/source/../../etc/nova/nova-policy-generator.conf
[oslo_policy.sphinxpolicygen] writing sample policy to /tmp/nova/doc/source/_static/nova.policy.yaml.sample
building [mo]: all of 0 po files
building [html]: all source files
updating environment: 60 added, 0 changed, 0 removed
reading sources... [100%] vmstates
/tmp/nova/doc/source/man/nova-status.rst:66: WARNING: Literal block expected; none found.
/tmp/nova/doc/source/man/nova-status.rst:73: WARNING: Enumerated list ends without a blank line; unexpected unindent.
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] vmstates
generating indices... genindex
writing additional pages... search
copying images... [100%] ./images/rpc/arch.png
copying static files... done
copying extra files... done
dumping search index in English (code: en) ... done
dumping object inventory... done
build succeeded, 2 warnings.
** Affects: nova
Importance: Undecided
Assignee: Takashi NATSUME (natsume-takashi)
Status: New
** Tags: doc
--
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to OpenStack Compute (nova).
https://bugs.launchpad.net/bugs/1659485
Title:
Warnings about nova-status.rst and config in Document generation
Status in OpenStack Compute (nova):
New
Bug description:
When executing 'tox -e docs', the following warnings are output.
* WARNING:stevedore.named:Could not load nova.api, nova.cells
* /tmp/nova/doc/source/man/nova-status.rst:66: WARNING: Literal block expected; none found.
* /tmp/nova/doc/source/man/nova-status.rst:73: WARNING: Enumerated list ends without a blank line;
The warnings about nova-status.rst are related with code block.
But it had better be replaced with a table.
-----
stack@devstack-master:/tmp/nova$ tox -e docs
docs create: /tmp/nova/.tox/docs
docs installdeps: -r/tmp/nova/test-requirements.txt
docs develop-inst: /tmp/nova
docs installed: alabaster==0.7.9,alembic==0.8.10,amqp==1.4.9,anyjson==0.3.3,appdirs==1.4.0,Babel==2.3.4,bandit==1.4.0,cachetools==2.0.0,castellan==0.5.0,cffi==1.9.1,cliff==2.4.0,cmd2==0.6.9,colorama==0.3.7,contextlib2==0.5.4,coverage==4.3.4,cryptography==1.7.1,ddt==1.1.1,debtcollector==1.11.0,decorator==4.0.11,docutils==0.12,dogpile.cache==0.6.2,dulwich==0.16.3,enum34==1.1.6,eventlet==0.19.0,extras==1.0.0,fasteners==0.14.1,fixtures==3.0.0,flake8==2.2.4,funcsigs==1.0.2,functools32==3.2.3.post2,futures==3.0.5,futurist==0.21.0,gabbi==1.31.0,gitdb2==2.0.0,GitPython==2.1.1,greenlet==0.4.11,hacking==0.10.2,httplib2==0.9.2,idna==2.2,ipaddress==1.0.18,iso8601==0.1.11,Jinja2==2.8.1,jsonpatch==1.15,jsonpath-rw==1.4.0,jsonpath-rw-ext==1.0.0,jsonpointer==1.10,jsonschema==2.5.1,keystoneauth1==2.18.0,keystonemiddleware==4.14.0,kombu==3.0.37,linecache2==1.0.0,lxml==3.7.2,Mako==1.0.6,MarkupSafe==0.23,mccabe==0.2.1,microversion-parse==0.1.4,mock==2.0.0,monotonic==1.2,mox3==0.20.0,msgpack-python==0.4.8,netaddr==0.7.19,netifaces==0.10.5,-e git+https://git.openstack.org/openstack/nova.git@5f59c0e3c61cd6f0600de3a69eeef2037358b782#egg=nova,numpy==1.12.0,openstackdocstheme==1.6.1,openstacksdk==0.9.10,os-api-ref==1.2.0,os-brick==1.11.0,os-client-config==1.26.0,os-testr==0.8.0,os-vif==1.4.0,os-win==1.4.0,os-xenapi==0.1.1,osc-lib==1.3.0,oslo.cache==1.17.0,oslo.concurrency==3.18.0,oslo.config==3.22.0,oslo.context==2.11.0,oslo.db==4.17.0,oslo.i18n==3.12.0,oslo.log==3.20.0,oslo.messaging==5.17.0,oslo.middleware==3.23.0,oslo.policy==1.18.0,oslo.privsep==1.16.0,oslo.reports==1.17.0,oslo.rootwrap==5.4.0,oslo.serialization==2.16.0,oslo.service==1.19.0,oslo.utils==3.22.0,oslo.versionedobjects==1.21.0,oslo.vmware==2.17.0,oslosphinx==4.10.0,oslotest==2.13.0,osprofiler==1.5.0,packaging==16.8,paramiko==2.1.1,Paste==2.0.3,PasteDeploy==1.5.2,pbr==1.10.0,pep8==1.5.7,pika==0.10.0,pika-pool==0.1.3,ply==3.9,positional==1.1.1,prettytable==0.7.2,psutil==5.0.1,psycopg2==2.6.2,py==1.4.32,pyasn1==0.1.9,pycadf==2.5.0,pycparser==2.17,pyflakes==0.8.1,Pygments==2.2.0,pyinotify==0.9.6,PyMySQL==0.7.9,pyparsing==2.1.10,pytest==3.0.6,python-barbicanclient==4.1.0,python-cinderclient==1.10.0,python-dateutil==2.6.0,python-editor==1.0.3,python-glanceclient==2.6.0,python-ironicclient==1.10.0,python-keystoneclient==3.9.0,python-mimeparse==1.6.0,python-neutronclient==6.1.0,python-novaclient==6.0.0,python-openstackclient==3.7.0,python-subunit==1.2.0,pytz==2016.10,PyYAML==3.12,reno==2.0.3,repoze.lru==0.6,requests==2.12.5,requests-mock==1.2.0,requestsexceptions==1.1.3,retrying==1.3.3,rfc3986==0.4.1,Routes==2.4.1,simplejson==3.10.0,six==1.10.0,smmap2==2.0.1,snowballstemmer==1.2.1,Sphinx==1.3.6,sphinx-rtd-theme==0.1.9,SQLAlchemy==1.0.17,sqlalchemy-migrate==0.10.0,sqlparse==0.2.2,statsd==3.2.1,stevedore==1.19.1,suds-jurko==0.6,tempest-lib==1.0.0,Tempita==0.5.2,tenacity==3.7.1,testrepository==0.0.20,testresources==2.0.1,testscenarios==0.5.0,testtools==2.2.0,traceback2==1.4.0,unicodecsv==0.14.1,unittest2==1.1.0,urllib3==1.20,warlock==1.2.0,WebOb==1.6.3,websockify==0.8.0,wrapt==1.10.8,wsgi-intercept==1.4.1
docs runtests: PYTHONHASHSEED='1259549316'
docs runtests: commands[0] | rm -rf doc/source/api doc/build api-guide/build api-ref/build
docs runtests: commands[1] | python setup.py build_sphinx
running build_sphinx
creating /tmp/nova/doc/build
creating /tmp/nova/doc/build/doctrees
creating /tmp/nova/doc/build/html
[pbr] Writing ChangeLog
[pbr] Generating ChangeLog
[pbr] ChangeLog complete (1.4s)
[pbr] Generating AUTHORS
[pbr] AUTHORS complete (1.9s)
Running Sphinx v1.3.6
loading pickled environment... not yet created
Using openstack theme from /tmp/nova/.tox/docs/local/lib/python2.7/site-packages/oslosphinx/theme
[oslo_config.sphinxconfiggen] reading config generator instructions from /tmp/nova/doc/source/../../etc/nova/nova-config-generator.conf
[oslo_config.sphinxconfiggen] writing sample configuration to /tmp/nova/doc/source/_static/nova.conf.sample
WARNING:stevedore.named:Could not load nova.api, nova.cells
[oslo_policy.sphinxpolicygen] reading config generator instructions from /tmp/nova/doc/source/../../etc/nova/nova-policy-generator.conf
[oslo_policy.sphinxpolicygen] writing sample policy to /tmp/nova/doc/source/_static/nova.policy.yaml.sample
building [mo]: all of 0 po files
building [html]: all source files
updating environment: 60 added, 0 changed, 0 removed
reading sources... [100%] vmstates
/tmp/nova/doc/source/man/nova-status.rst:66: WARNING: Literal block expected; none found.
/tmp/nova/doc/source/man/nova-status.rst:73: WARNING: Enumerated list ends without a blank line; unexpected unindent.
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [100%] vmstates
generating indices... genindex
writing additional pages... search
copying images... [100%] ./images/rpc/arch.png
copying static files... done
copying extra files... done
dumping search index in English (code: en) ... done
dumping object inventory... done
build succeeded, 2 warnings.
To manage notifications about this bug go to:
https://bugs.launchpad.net/nova/+bug/1659485/+subscriptions
Follow ups
