<html><body><div style="color:#000; background-color:#fff; font-family:HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif;font-size:16px"><div>This happened to me a couple times. I think if you check the files called before keystone-install.rst,</div><div dir="ltr" id="yui_3_16_0_1_1443152020129_14428">you'll find someplace where the order of marking the section headers is different. If you fix that,</div><div id="yui_3_16_0_1_1443152020129_14460" dir="ltr">the keystone-install file will be fine.</div><div dir="ltr"><br></div><div id="yui_3_16_0_1_1443152020129_14655" dir="ltr">Apparently there are different conventions for the order of the heading marks in a file and some of the</div><div dir="ltr">docs show that it should be ----- then ~~~~. Sometimes the build messages bust you for having the</div><div id="yui_3_16_0_1_1443152020129_14656" dir="ltr">headings out of line, but sometimes RST apparently just adopts the new conventions. I'm not enough</div><div dir="ltr">of an RST expert to explain this thing.</div><div dir="ltr"><br></div><div id="yui_3_16_0_1_1443152020129_14657" dir="ltr">I confess that, the first time this happened to me, I shrugged and said "whatever" and used the order for</div><div dir="ltr">the headings that worked. But this then caused problems in the subsequent files...</div><div id="yui_3_16_0_1_1443152020129_14658" dir="ltr"><br></div><div dir="ltr">meg<br></div><div id="yui_3_16_0_1_1443152020129_14359"><span></span></div><br> <blockquote id="yui_3_16_0_1_1443152020129_14364" style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; margin-top: 5px; padding-left: 5px;"> <div id="yui_3_16_0_1_1443152020129_14363" style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 16px;"> <div id="yui_3_16_0_1_1443152020129_14362" style="font-family: HelveticaNeue, Helvetica Neue, Helvetica, Arial, Lucida Grande, sans-serif; font-size: 16px;"> <div id="yui_3_16_0_1_1443152020129_14361" dir="ltr"> <hr id="yui_3_16_0_1_1443152020129_14360" size="1"> <font id="yui_3_16_0_1_1443152020129_14659" face="Arial" size="2"> <b><span style="font-weight:bold;">From:</span></b> Andreas Jaeger <aj@suse.com><br> <b><span style="font-weight: bold;">To:</span></b> "openstack-docs@lists.openstack.org" <Openstack-docs@lists.openstack.org> <br> <b><span style="font-weight: bold;">Sent:</span></b> Thursday, September 24, 2015 10:57 PM<br> <b><span style="font-weight: bold;">Subject:</span></b> Re: [OpenStack-docs] Help with RST needed<br> </font> </div> <div id="yui_3_16_0_1_1443152020129_14660" class="y_msg_container"><br>On 09/25/2015 07:28 AM, Andreas Jaeger wrote:<br clear="none">> Matt has a problem with using only in<br clear="none">> <a id="yui_3_16_0_1_1443152020129_14661" shape="rect" href="https://review.openstack.org/227609," target="_blank">https://review.openstack.org/227609, </a>is there anybody that can help why<br clear="none">> this is rendered wrong, please?<br clear="none">><br clear="none">> His plea for help is:<br clear="none">> "In the keystone-install.rst file, I put some test section and<br clear="none">> subsection headings to show a conditional rendering problem. If the<br clear="none">> headings use the conventions order of "~~~" and "---", nothing renders.<br clear="none">> If they use the opposite order of "---" and "~~~", the content renders.<br clear="none">> Can you help?"<br clear="none">><br clear="none">> I looked but I'm puzzled right now,<br clear="none"><br clear="none">Please follow up to Matt's original email, I send this one out without <br clear="none">going through the list, sorry for the noise,<div class="qtdSeparateBR"><br><br></div><div class="yqt0005577112" id="yqtfd59514"><br clear="none"><br clear="none">Andreas<br clear="none">-- <br clear="none"> Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi<br clear="none"> SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br clear="none"> GF: Felix Imendörffer, Jane Smithard, Graham Norton,<br clear="none"> HRB 21284 (AG Nürnberg)<br clear="none"> GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126<br clear="none"><br clear="none"><br clear="none">_______________________________________________<br clear="none">OpenStack-docs mailing list<br clear="none"><a shape="rect" ymailto="mailto:OpenStack-docs@lists.openstack.org" href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br clear="none"><a shape="rect" href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br clear="none"></div><br><br></div> </div> </div> </blockquote> </div></body></html>