[Openstack-operators] [Openstack] [devstack] Malformed Documentation on stack.sh script web site
Gui Maluf
guimalufb at gmail.com
Thu Nov 8 21:51:33 UTC 2012
thanks dean, looks beautiful now! :)
On Wed, Nov 7, 2012 at 4:29 PM, Dean Troyer <dtroyer at gmail.com> wrote:
> On Wed, Nov 7, 2012 at 9:27 AM, Gui Maluf <guimalufb at gmail.com> wrote:
> > In http://devstack.org/stack.sh.html above "Log Files", the whole
> > documentation is malformed. All descriptions stop to match with the
> current
> > piece of code. I don't know who to warn, so I'm sending this email here.
>
> Actually, it is the reverse that is the case...everything _after_ "Log
> Files" is broken. We use shocco to format those pages from the bash
> scripts. It treats the comments as documentation and puts it to the
> left of the code that follows. This is why there is markdown
> formatting in the comments of devstack scripts.
>
> In this particular case, the spinner string was being improperly
> recognized by shocco and it stopped formatting the output.
>
> This is a good excuse to do another periodic doc/formatting pass
> through stack.sh, I'll commit this fix then.
>
> dt
>
> --
>
> Dean Troyer
> dtroyer at gmail.com
>
--
*guilherme* \n
\tab *maluf*
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-operators/attachments/20121108/3d237bb1/attachment.html>
More information about the OpenStack-operators
mailing list