implement, document and test the 'instantiate' decorator
Merge pull request #101 from cjw296/instantiate2

implement, document and test the 'instantiate' decorator