17.5.8.2 Ending ancestor elements after the current block

In some cases, it is not clear whether the end of a block element should also end the enclosing parent element. To close a parent element at the end of the current block element (for example):

[DocBookCloseAfter]

; Frame para format = parent to be closed, with any other elements

;  nested under it, at the end of the current block element.

FigAnchor = figure

Use this setting to force closure of elements that were opened based on settings in [DocBookParents]; see §17.5.2 Designating DocBook ancestor elements. You can list as many possible ancestors as necessary; order is not important.

For individual cases, you can insert a DocBookCloseAfter marker in the paragraph for the current block element instead, with content the name(s) of the ancestor element(s) to close. You can also use a DocBookCloseAfter marker to override a [DocBookCloseAfter] setting when you want to close a higher (or lower) ancestor than the setting specifies.

---

> 17 Converting to DocBook XML > 17.5 Nesting DocBook block elements > 17.5.8 Closing DocBook ancestor elements > 17.5.8.2 Ending ancestor elements after the current block