API: Return Pkg / Obj IDs from DocumentGenerator

[Uffe]

Hey hey!


Hedging my bets in case no one likes my relevant-glossary idea.

When using the DocumentGenerator, it would be very useful if the various methods would return not booleans (worked / didn't work) but collections containing the package and object IDs for which templates were called, ie every package and object whose IDs were in context as #PACKAGEID# / #OBJECTID# during the generation.

Since templates can call other templates, and follow all sorts of relationships in addition to the package / element hierarchy, this information is non-trivial to retrieve beforehand, but should be easy-peasy to pick up as the generator goes along.

Ideally, the templates that were used should be indicated as well.


Cheers,


/Uffe

[Eve]

Personally, I'm a big fan of functions providing more information than a single boolean. Unfortunately, without completely duplicating the methods the signatures can't be changed because they would break existing applications.