Bug 872690

The method InventoryContext.requestChildResourcesDiscovery() will hang a component's start method indefinitely, e..g

public class MonitorComponent
    implements ResourceComponent
{
    public void start(ResourceContext context) {
        // notice something during init
        context.getInventoryContext().requestChildResourcesDiscovery();
    }
}

This method should be changed to either throw an exception or not block. Or at least document its use.

Also, InventoryContext could use some class-level JavaDoc.

     *
     * @return discovered child resources
     */
    public void requestChildResourcesDiscovery();

^^ does not return anything (would be nice if it did)