An Arby wrapper is just a DocBook XML document that includes specially formatted comment tags. These comment tags will be replaced with the corresponding fragment from the arbitrary documentation specification. The wrapper document can contain any standard DocBook XML, even additional chapters, sections and statements to include other entire files into the document.

When you want to insert a fragment definition from the arbitrary specification you use an XML comment of the form:

<!--SRCFILE fragment-id-->

Where fragment-id is the ID of the corresponding fragment in the specification.

These specifications should be placed in the appropriate place within your document. For example, if your fragment specification creates a chapter, then the specification can be placed at top level in the document. If the specification is a section, then it must be included in a parent chapter.

Also be aware that you could, if you wanted, generated multiple arbitrary documents which are themselves imported and inserted into existing documents.