Okidoki... It's not really the [endsect] in question here. It is
the paragraph; and it's documented.  Paragraphs start left-flushed
and are terminated by two or more newlines. So, if an [endsect]
ends a paragraph as in (indented for clarity):

    blah blah blah
    [endsect]

The literal [endsect] becomes part of the paragraph.

The grammar for paragraph goes somewhat like this:

    paragraph = +line >> +eol;

where each line is ended by a single eol, hence the paragraph
ends with 2 or more eols. It was my thinking that, in the
absence of explicit markup, this is a reasonable behavior.
For example (indented for clarity):

    this is a paragraph X
    this is part of the same paragraph X

    this is a different paragraph Y

If this behavior is not intuitive, let me know and I might find
a reasonable workaround (allowing simple block-ends like
[endsect] to terminate a paragraph).

Understood, I figured that out in the end, it's just that if you read the [section] docs in isolation it wasn't obvious. Probably just a case "in too much of a hurry to read the manual fully".

I ran into this one because I had a bunch of one or two line sections (don't ask!), so all the blank lines made the quickbook source quite hard to read, it looked much better as:

[section]
blah blah blah
[endsect]

[section]
my oh my
[endsect]

but of course that didn't work.

John.




-------------------------------------------------------
This SF.Net email is sponsored by:
Power Architecture Resource Center: Free content, downloads, discussions,
and more. http://solutions.newsforge.com/ibmarch.tmpl
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs

Reply via email to