LGTM, thanks
On Mon, Aug 18, 2014 at 3:09 PM, 'Klaus Aehlig' via ganeti-devel < [email protected]> wrote: > While the old description ("The file should contain text data, > line-based, with single empty lines separating sections. The > lines themselves are column-based, with the pipe symbol (|) acting > as separator.") is precise and unambiguous, we did have some > misunderstandings in the past. So add the format of the empty > section (which makes sense to describe a cluster without any > instances) as a clarifying example. > > Signed-off-by: Klaus Aehlig <[email protected]> > --- > man/htools.rst | 6 +++++- > 1 file changed, 5 insertions(+), 1 deletion(-) > > diff --git a/man/htools.rst b/man/htools.rst > index 9f9a886..448afed 100644 > --- a/man/htools.rst > +++ b/man/htools.rst > @@ -154,7 +154,11 @@ support all options. Some common options are: > page **htools**\(1). > > The file should contain text data, line-based, with single empty lines > - separating sections. The lines themselves are column-based, with the > + separating sections. In particular, an empty section is described by > + the empty string followed by the separating empty line, thus yielding > + two consecutive empty lines. So the number of empty lines does matter > + and cannot be changed arbitrarily. > + The lines themselves are column-based, with the > pipe symbol (``|``) acting as separator. > > The first section contains group data, with the following columns: > -- > 2.1.0.rc2.206.gedb03e5 > >
