openstack team mailing list archive
-
openstack team
-
Mailing list archive
-
Message #18431
Re: [devstack] Malformed Documentation on stack.sh script web site
thanks dean, looks beautiful now! :)
On Wed, Nov 7, 2012 at 4:29 PM, Dean Troyer <dtroyer@xxxxxxxxx> wrote:
> On Wed, Nov 7, 2012 at 9:27 AM, Gui Maluf <guimalufb@xxxxxxxxx> 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@xxxxxxxxx
>
--
*guilherme* \n
\tab *maluf*
References