Re: [Boost-docs] Another quickbook multi-line issue

Subject: Re: [Boost-docs] Another quickbook multi-line issue
From: John Maddock (john_at_[hidden])
Date: 2007-08-04 17:56:12

Joel de Guzman wrote:
> The same is true for tables, right? We'd also want
> lists in tables, for example, or even tables in tables.
>
> Ok. I knew that would come one day. Both are really valid needs.
> The difficulty is the wiki list-item syntax not terminating
> cleanly.
>
> The simple wiki style syntax gets in the way here. One reliable
> (umambiguous) way to allow blocks inside lists and tables
> that I know is by providing a special syntax for blocks that's
> clearly delimited. For example:
>
> * Item1 [{
>     This is a table inside a list:
>
>     [table foo
>      [[a][b][c]]
>      [[d][e][f]]
>     ]
>   }]
>
> * Item2 [{
>     Or how about a list inside a table in the list:
>
>     [table bar
>      [[a][b][c]]
>      [[d][e]
>      [[{
>         * item1
>         * item2
>         * item3
>       }]
>      ]]
>     ]
>   }]
>
> Here, the proper (nestable) delimiter is the [{ ... }].
> Everything inside it is parsed as a block, of course with
> certain exceptions (e.g. sections cannot be allowed).
>
> Another way is to:
> * Make tables phrase level

Maybe, but it doesn't solve the original problem, and might lead to tables 
in stupid places ? :-)

> * Provide an alternate, well behaved phrase level syntax
>   for lists: [list [item1][item2][item3]]

That was my first thought, but...

> * Provide an alternate, well behaved syntax for paragraphs:
>   [para this is a paragraph].

Oh, that's so easy we can just do that right now with a template right?  If 
so I'm all in favour of the easiest option :-)

John.