[openstack-dev] [all][oslo] pbr potential breaking change coming

Flavio Percoco flavio at redhat.com
Wed Jul 6 13:07:31 UTC 2016


On 21/06/16 09:01 -0400, Doug Hellmann wrote:
>A while back pbr had a feature that let projects pass "warnerror"
>through to Sphinx during documentation builds, causing any warnings in
>that build to be treated as an error and fail the build. This lets us
>avoid things like links to places that don't exist in the docs, bad but
>renderable rst, typos in directive or role names, etc.
>
>Somewhat more recently, but still a while ago, that feature "broke"
>with a Sphinx release that was not API compatible. Sachi King has
>fixed this issue within pbr, and so the next release of pbr will
>fix the broken behavior and start correctly passing warnerror again.
>That may result in doc builds breaking where they didn't before.
>
>The short-term solution is to turn of warnerrors (look in your
>setup.cfg), then fix the issues and turn it back on. Or you could
>preemptively fix any existing warnings in your doc builds before the
>release, but it's simple enough to turn off the feature if there isn't
>time.
>
>Josh, Sachi, & other Oslo folks, I think we should hold off on
>releasing until next week to give folks time. Is that OK?
>
>Doug
>
>PS - Thanks, Sachi, I know that bug wasn't a ton of fun to fix!

Glance should be ok and I've just proposed a patch like Ihar's for Zaqar.

Flavio

-- 
@flaper87
Flavio Percoco
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 847 bytes
Desc: not available
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20160706/ef63694f/attachment.pgp>


More information about the OpenStack-dev mailing list