Re: [boost] [quickbook] Strange error regarding lists

Subject: Re: [boost] [quickbook] Strange error regarding lists
From: Edward Diener (eldiener_at_[hidden])
Date: 2014-07-19 11:50:54

On 7/19/2014 10:52 AM, Edward Diener wrote:
> On 7/19/2014 9:50 AM, Daniel James wrote:
>> On 19 July 2014 14:21, Edward Diener <eldiener_at_[hidden]> wrote:
>>> Using the latest quickbook on 'develop' in some documentation I have:
>>>
>>> * a comment
>>>
>>>   SOMENAME
>>>
>>> only to get the quickbook error:
>>>
>>> my_file:14: error: Nested blocks in lists won't be supported in
>>> quickbook
>>> 1.6.
>>>
>>> Why am I seeing this ?
>>
>> Such indentation is going to be used for paragraphs in lists, but I
>> hadn't fully worked out how to do it when I was finishing off 1.6.
>> Previously such indentation would be interpreted as a code block,
>> which is usually not intended. Markup that is usually interpreted
>> incorrectly and would change meaning when upgrading to 1.7 will cause
>> problems in the long run, so it's better to catch it sooner rather
>> than later. If you want paragraphs in lists then you'll need to use an
>> explicit list tag, if you want a code block then you should use an
>> explicit code block (i.e. two backticks at the beginning and end).
>
> Does not a list end when there is a blank list following the last list
> element ? If not, how does one end a list ?

Should have been:

Does not a list end when there is a blank line following the last list
element ? If not, how does one end a list ?

>
> I had ended for the line to be a code block. I had assumed my list had
> ended.
>
> Although I appreciatethe idea of being able to have paragrrpahs in lists
> I suggest that paragraphs in lists should not override the normal ending
> of lists.
>
>
> _______________________________________________
> Unsubscribe & other changes:
> http://lists.boost.org/mailman/listinfo.cgi/boost
>