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
