XMLSpy WorkaroundsXMLSpy WorkaroundsThis section provides some tips-and-tricks to modify the documentation and to generate the documentation for very large schema-sets:
Complete Documentation for Large Schemas
Sometimes it is impossible to build a complete documentation set for very large schemas, as XMLSpy® throws an 'Out of Memory Exception' and documentation generation is aborted. spy.doc provides a way around this by repeatedly executing the XMLSpy® documentation feature to provide smaller sets of documentation that spy.doc then merges to provide a single set. The GJXML sample provides a project file that builds many small document increments then merges them together to provide a very large but high-performance Help File.
Tip: Use a high-performance computer with a lot of memory (≥ 1GB) for the best results.
Documentation Section Ordering
By using documentation generation increments, it is possible to change the documentation section order of the merged documentation set by changing the order in which the documentation sections are generated by XMLSpy®.
XMLSpy® generates 'mangled' names for the HTML bookmarks that it generates to link different sections together. Unfortunately, every time XMLSpy® is started, the generated bookmark names are different. The only conceivable way of generating merged-incremental documentation, without tracking the documentation sections, is to repeatedly generate the documentation within the same instance or session of the executing XMLSpy® process. For large schemas and lots of generations, this amounts to a fair amount of time to generate the documentation.
Tip: Be prepared to wait - the results are worth it!