On 08/09/2017 09:24 AM, Sean Dague wrote:
> On 08/09/2017 09:19 AM, Doug Hellmann wrote:
>> Excerpts from Sean Dague's message of 2017-08-08 17:01:29 -0400:
>>> When trying to import
>>> https://github.com/openstack/openstack-manuals/blob/6f9fc171800e8a435011f38cd4558e900884ce86/doc/config-reference/source/compute/hypervisor-vmware.rst#L2
>>> into the Nova admin config reference
>>> (https://review.openstack.org/#/c/491853), a couple of interesting
>>> challenges popped up. These pop up in a couple of other places, but this
>>> one file nicely contains both of them.
>>>
>>> The first is the common autogenerated files (like
>>> https://github.com/openstack/openstack-manuals/blob/6f9fc171800e8a435011f38cd4558e900884ce86/doc/config-reference/source/tables/nova-vmware.rst#L11).
>>> To the best of my knowledge we don't have that autogeneration tooling in
>>> the projects. Should we just be copy/pasting this content in? Is there
>>> another better strategy there?
>>
>> oslo.config does have an extension for generating a table-format
>> list of all of the configuration options, and the idea is to replace
>> those included tables with the 'show-options' directive. It uses
>> the same inputs as the sample file generator. See
>> https://docs.openstack.org/oslo.config/latest/reference/sphinxext.html for
>> details
>
> So in this case we could:
>
> .. show-options::
>
> oslo.vmware
>
>
> And that would have the same impact?
I'm attempting to do this, and just getting:
Warning, treated as error:
Could not load oslo.vmware
.tox/docs/bin/pip freeze
shows that oslo.vmware is installed the tox env. Any ideas what I'm
doing incorrectly?
-Sean
--
Sean Dague
http://dague.net
__________________________________________________________________________
OpenStack Development Mailing List (not for usage questions)
Unsubscribe: openstack-dev-requ...@lists.openstack.org?subject:unsubscribe
http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
