Multi Separator (Separation Provider)

STUB	This article is a stub. It contains minimal information on the topic and should be expanded.

The Multi Separator provider performs separation using multiple Separation Providers. It allows users to create a list of any of the other Separation Providers. If the first provider on the list fails to separate a page (or, as more often is the case, a series of pages), the next one will be applied. If that fails, the next, and so on.

This provider has very limited functionality as a practical matter. The first Separation Provider should be considered the "main provider". The subsequent Separation Providers will only attempt to create a document folder if the main provider (or the providers before it) leaves the page as a loose page.

There are several Separation Providers that continue placing pages into a folder after a condition is met. Pattern-Based Separation is the most obvious. If the provider encounters a page with text that matches a regex pattern, it will create a document folder and continue placing subsequent pages into that folder until the pattern is matched again. Once pages are in a folder, none of the subsequent Separation Providers will attempt to execute for the already foldered pages (even if they would have qualified for separation if they were unfoldered).