Config Reference: investigate missing rootwrap config table

[Diane Fleming]

Missing rootwrap configuration options table in Config Ref - not currently autogenerated, but could be.

[Diane Fleming (diane-fleming)]

Andreas, can you look at this? There's a missing table in Config Ref that could be autogenerated

[Andreas Jaeger (jaegerandi)]

Diane, right now I'm not looking at the autotools and will thus unassign for now - and I'm not convinced yet that we can autogenerate this one.

[Don Domingo (ddomingo)]

I found a whole section on rootwraps in the Cloud Admin Guide, which also contains the options table for it. I've added an <xi:include> to that same section's XML file in the "Compute" chapter of the Config Reference Guide:

https://review.openstack.org/#/c/67005/

[Don Domingo (ddomingo)]

Unassigning myself from this bug for now, seeing as the required solution is beyond my means to address (setting up autogeneration for the rootwraps table). https://review.openstack.org/#/c/67005/

[Diane Fleming (diane-fleming)]

reassigned to shaun mccance to see if he can auto-generate the rootwrap options table

[Shaun McCance (shaunm-gnome)]

The options are read by the RootwrapConfig class in oslo-incubator. They're read from a config object if they're available, but they don't seem to be declared anywhere. We're not going to be able to generate these with the introspection code we use for the regular config options, but we might still be able to pull something off. I'll look into it more.

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/85125
Committed: https://git.openstack.org/cgit/openstack/openstack-doc-tools/commit/?id=eb51a3d4bf9fbd3853480ef69c7846021c134f4e
Submitter: Jenkins
Branch: master

commit eb51a3d4bf9fbd3853480ef69c7846021c134f4e
Author: Shaun McCance <email address hidden>
Date: Thu Apr 3 13:58:19 2014 -0400

    Generate docs for projects' rootwrap.conf file

    There's nothing introspectable in the projects or oslo.rootwrap, but all
    projects that use rootwrap have a sample etc/($project/)?rootwrap.conf
    file. This file is relatively simple to parse for allowed options and
    comments. It's not the best solution, but it's a solution.

    Closes-Bug: #1253690
    Change-Id: I51973a4b8f0ac6ea047c4ffc07647a10bdea92ee