The assembly command-line utility (found in
is auto-documented. Suffice to execute:
in order to display the following help.
Processes a structure found in assembly file
in_assembly_file and creates realized DocBook
out_docbook_file is specified as
simply checked for errors.
By default, it's the first found structure.
By default, it's the default format of the processed structure
if any, and the "implicit format" otherwise.
The "implicit format" matches
elements without any
Multiple output formats separated by "
be specified. For example, "
output format is "
Check realized document for cross-reference errors, missing image resources, etc. This option reports warnings, not errors. Thus this option does not prevent the realized document from being saved to disk.
If your document requires conditional processing (that is, profiling), then the check step may report false errors. These false errors are caused by the fact that the conditional processing step has not been applied to the realized document prior to the check step.
Example: two of the chapters referenced by assembly
xml:id="install". First chapter has also
os="windows". Second chapter has also
If you run
assembly -check book.xml -,
you'll get a duplicate ID warning caused by
On the other hand, if you run
assembly -check -profile os windows book.xml -,
you'll not have this duplicate ID error. Why that? Because by
os="windows", second chapter
os="mac") is excluded from the realized
document prior to checking it.
Specifies a profiling attribute. One or more
-profile options allows to specify the profile
applied to the realized document prior to checking it. Specifying one
-profile options is not useful unless you
also use the
 Or equivalent Java™ system property xml.catalog.files.