<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Aug 14, 2013 at 1:25 PM, Steve Gordon <span dir="ltr"><<a href="mailto:sgordon@redhat.com" target="_blank">sgordon@redhat.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div class="im">----- Original Message -----<br>
> From: "Andreas Jaeger" <<a href="mailto:aj@suse.com">aj@suse.com</a>><br>
> To: <a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a><br>
</div><div class="im">> Sent: Wednesday, August 14, 2013 2:05:29 PM<br>
> Subject: Re: [Openstack-docs] programlisting language="bash" or language="INI" for config files?<br>
><br>
> On 08/14/2013 07:13 PM, Steve Gordon wrote:<br>
> > ----- Original Message -----<br>
> >> From: "Andreas Jaeger" <<a href="mailto:aj@suse.com">aj@suse.com</a>><br>
> >> To: <a href="mailto:openstack-docs@lists.openstack.org">openstack-docs@lists.openstack.org</a><br>
> >> Sent: Wednesday, August 14, 2013 12:35:25 PM<br>
> >> Subject: [Openstack-docs] programlisting language="bash" or language="INI"<br>
> >>         for config files?<br>
> >><br>
> >> Stephen Gordon asked in reviewing <a href="https://review.openstack.org/41861" target="_blank">https://review.openstack.org/41861</a>:<br>
> >><br>
> >> "Line 146:                                 <programlisting<br>
> >> language="bash">[DEFAULT]<br>
> >> Is bash actually the correct directive for these, I'm not super familiar<br>
> >> with clouddocs-maven's highlight functionality but other tools I have<br>
> >> worked with have one specifically for the INI file format?"<br>
> >><br>
> >> Looking at the wiki, I do not see INI mentioned - and don't see it used<br>
> >> anywhere. So, is there an INI option we should use or should we continue<br>
> >> using "bash"?<br>
><br>
><br>
> Diane answered it with this link as part of the review, so "bash" is fine:<br>
> <a href="https://github.com/rackerlabs/clouddocs-maven-plugin/#new-features-and-changes-1" target="_blank">https://github.com/rackerlabs/clouddocs-maven-plugin/#new-features-and-changes-1</a><br>
><br>
> Thanks Diane!<br>
<br>
</div>The other option would be to not provide the language attribute at all, which is semantically correct and what I see in most examples of INI content I can find in openstack-manuals. If there's an expectation that for INI files they will always be marked up as Bash then I think it should be added to the Conventions and applied uniformly:<br>

</blockquote><div><br></div><div>When you say the INI files you mean nova.conf, cinder.conf, and so on right? I believe should not be marked <span style="background-color:rgb(245,245,245);color:rgb(51,51,51);font-family:Monaco,Menlo,Consolas,'Courier New',monospace;font-size:13px;line-height:20px;white-space:pre-wrap">language="bash" linenumbering="unnumbered"</span> but simply <programlisting> -- is that okay with everyone? <br>

</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<br>
    <a href="https://wiki.openstack.org/wiki/Documentation/Conventions#Code_or_data_.28block.29" target="_blank">https://wiki.openstack.org/wiki/Documentation/Conventions#Code_or_data_.28block.29</a></blockquote><div><br>

</div><div>Feel free to change this wiki page to reflect the outcome of this discussion, and thanks all for updating it as we shape these conventions.</div><div><br></div><div>Anne</div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">

<br>
<br>
Thanks,<br>
<br>
Steve<br>
<div class=""><div class="h5"><br>
_______________________________________________<br>
Openstack-docs mailing list<br>
<a href="mailto:Openstack-docs@lists.openstack.org">Openstack-docs@lists.openstack.org</a><br>
<a 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>
</div></div></blockquote></div><br><br clear="all"><div><br></div>-- <br>Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a>
</div></div>