Added a long-overdue comment block giving an overview of pool operations

and terminology, plus explanation of some extreme obscurities.