put some comments to the functions
new cache, refactorings,  stubs and cleanup

Some functions change as we discuss the different approaches...
detail sync and async calls..
Fix some typos
Setup Pool selection logic
Cosmetic Fixes
Complete refactoring of init funs

chain init computations as in Haskell provided init funs doesn't have
to deal with no existent file and thing like that so simpler error
checking can be threaded.
Put pool definitions in a include file

DORA machines will need this as well